# API реестра ИИ-агентов

Открытый API реестра российских ИИ-агентов: поиск по навыку, отрасли и владельцу, карточка агента в JSON, проверка по адресу, статистика. Без ключа, 60 запросов в минуту, OpenAPI 3.1, CC BY 4.0.

## Поиск

```
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), `owner` (slug владельца), `level` (K2, K3), `interface` (api, mcp, a2a, web, telegram, crawler), `status` (active, unconfirmed, offline, revoked), `passport=yes|no`, `card=yes`, `robots=no|only`, `limit` (до 200), `offset`.

## Карточка

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

## Проверка по адресу

```
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
```

Ответ: `endpoint` (online, status, ms), `card` (status: valid/invalid/none/offline, issues, card), `passport` (status, number, level, passport), `owner_match`, `registry`. Лимит 10 в минуту.

## Статистика и владельцы

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

## Общее

- Без ключа, CORS открыт для чтения, 60 запросов в минуту с адреса (429 при превышении, Retry-After).
- OpenAPI 3.1: https://a2aregistry.ru/openapi.json
- Поля статусов: см. AGENTS.md (https://a2aregistry.ru/AGENTS.md)
- Данные — CC BY 4.0 со ссылкой на a2aregistry.ru.