API для агентов

Два главных запроса: «найди агента, который умеет X» и «убедись, что он настоящий». Плюс карточка, статистика и владельцы. Без ключа, CORS открыт, 60 запросов в минуту с адреса.

OpenAPI 3.1 AGENTS.md llms.txt agents.json

1. Поиск агентов

Фильтры по навыку, отрасли, владельцу, уровню паспорта, интерфейсу, статусу; текстовый поиск по имени, описанию, владельцу и сайту.

GET https://a2aregistry.ru/api/v1/agents?skill=verify&industry=it GET https://a2aregistry.ru/api/v1/agents?q=банк&interface=mcp GET https://a2aregistry.ru/api/v1/agents?owner=yandex&limit=20&offset=0

Параметр	Значения
`q`	текст: имя, описание, владелец, сайт, номер паспорта
`skill`	search, compare, quote, order, pay, sign, message, publish, answer, verify, crawl, analyze, generate, support, translate, automate, finance, geo, devtools
`industry`	it, retail, finance, gov, media, logistics, telecom, industry, realty, health, hr, other
`interface`	api, mcp, a2a, web, telegram, crawler
`level`	K2, K3
`status`	active, unconfirmed, offline, revoked
`owner`	slug владельца (см. /api/v1/owners)
`passport`, `card`, `robots`	yes/no; yes; no (без роботов оператора) / only
`limit`, `offset`	до 200; смещение

2. Проверка по адресу

Адрес сайта или карточки A2A. Ответ — четыре факта на дату проверки и запись в реестре, если она есть. Лимит 10 проверок в минуту: проверка ходит на чужой сайт и на валидатор паспортов.

GET https://a2aregistry.ru/api/v1/verify?url=agentreadyscan.ru GET https://a2aregistry.ru/api/v1/verify?url=https://example.ru/.well-known/agent-card.json{ "ok": true, "endpoint": { "online": true, "status": 200, "ms": 412 }, "card": { "status": "none" }, "passport": { "status": "confirmed", "number": "AP-2026-000002", "level": "K2" }, "owner_match": null, "registry": { "slug": "agentreadyscanbot", "status": "active", "owner_confirmed": true } }

3. Карточка агента

Одна запись целиком: владелец, навыки, адрес, паспорт, слепок карточки A2A, история проверок.

GET https://a2aregistry.ru/api/v1/agents/agentreadyscanbot.json

4. Статистика, владельцы, всё одним файлом

Агрегаты для отчётов и копия реестра для автономной работы.

GET https://a2aregistry.ru/api/v1/stats GET https://a2aregistry.ru/api/v1/owners GET https://a2aregistry.ru/api/v1/agents.json # все записи одним файлом

Поля статуса

status: active — подтверждён владельцем, адрес отвечает; unconfirmed — запись по открытым данным, владелец не подтверждал; offline — адрес не отвечает три проверки подряд; revoked — снята.
passport.status: none · published (файл есть, в реестр паспортов не подан) · confirmed · unconfirmed · suspended · revoked · invalid · offline (валидатор недоступен, показан прошлый результат).
card.status: none · valid · invalid · offline · unknown.
operator_robot: true — робот оператора реестра (ООО «САРМАТЕХ»), образец формата; в счётчик внешних паспортов не входит.
Ошибки: 400 — нет параметра; 404 — нет записи; 429 — лимит, заголовок Retry-After; 500 — сбой, повторите.

Данные — CC BY 4.0 со ссылкой на a2aregistry.ru. Платных тарифов и ключей нет и на старте не планируется; расширенный API и мониторинг — только после появления внешних паспортов, и будут объявлены на этой странице.