# Контур.Фокус API: Проверить пакет контрагентов

Сценарий из mcp-everything. Актуально на 2026-10-25.

Массовая сверка базы: методы с параметрами `inn`/`ogrn` принимают до 100 значений через запятую — так меньше запросов и не упираешься в лимит параллельности.

1. Разбей базу на пачки по 100 ИНН.
2. Вызывай GET /api3/req (или `scoring`, `legalAnalytics`) с `inn=ИНН1,ИНН2,...`.
3. Держи не больше 10 одновременных запросов на ключ; при `429` снижай частоту.
4. Контролируй расход лимитов через GET /api3/stat.

```bash
curl "https://focus-api.kontur.ru/api3/req?key=$FOCUS_KEY&inn=6663003127,7736050003"

curl "https://focus-api.kontur.ru/api3/stat?key=$FOCUS_KEY"
```

## Базовые URL

- Боевой: `https://focus-api.kontur.ru`

## Авторизация

Тип: API-ключ

Ключ доступа передаётся параметром `key` в строке запроса. Тестовый ключ выдают по заявке: `https://focus.kontur.ru/site/api/order-api`. Для ключей с лимитом больше 100 000 компаний или запросов обязателен второй фактор: ограничение по IP-диапазонам или подпись каждого запроса сертификатом (настраивает техподдержка, focus-api@kontur.ru).

## Методы сценария

### GET /api3/req — Базовые реквизиты

Актуальные и исторические реквизиты ЮЛ и ИП. Ответ — массив: `inn`, `ogrn`, `focusHref`, `UL` (`kpp`, `okpo`, `opf`, `legalName.short`, `legalName.full`, `legalAddress`, `branches`, `status`, `registrationDate`, `dissolutionDate`, `heads[]`, `managementCompanies`, `history`) или `IP` (`fio`, `okpo`, `opf` и др.).

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Freq

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `key` | query | string | да | Ключ доступа |
| `inn` | query | string | нет | ИНН, до 100 через запятую; обязателен, если нет ОГРН |
| `ogrn` | query | string | нет | ОГРН, до 100 через запятую; обязателен, если нет ИНН |
| `xml` | query | boolean | нет | true — ответ в XML (по умолчанию false) |

### GET /api3/stat — Статистика использования

По каждому методу: `methodName`, `periodStartDate`, `periodEndDate`, `limitType` (`Requests`, `LegalEntities`, `Persons`), `limit`, `spent`, `limitTimeType` (`Period`, `OneDay`).

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Fstat

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `key` | query | string | да | Ключ доступа (можно первые 20 символов) |

## Нюансы

- Большинство методов принимают ИНН или ОГРН и до 100 значений через запятую; ответ — массив по каждой компании.
- Формат по умолчанию JSON; `xml=true` переключает на XML (методы наблюдения — только JSON).
- `focusHref` ведёт в веб-карточку Фокуса — для неё нужна подписка на сервис.
- Методы `/api3/analytics` и `/api3/buh` устарели: используйте группу новых аналитических методов и `/api3/accountingReports`.
- Старое наблюдение (`/api3/monList`, `/api3/req/mon`, `/api3/egrDetails/mon`) поддерживается, но рекомендуется NEW Наблюдение (`monitoringList`, `monitoringGetStates`, `monitoringGetChanges`).
- Изменения в NEW Наблюдении хранятся 90 дней; `changeId` растёт, но не обязательно подряд.
- Самозанятые: лимит считается по уникальным ИНН в сутки (сброс в 00:00 UTC); с 21:00 до 00:00 МСК возможны техработы.
- Есть игровой стенд с формами методов (например, `https://focus-api.kontur.ru/api3/req/userform`).

## Другие сценарии

- [Заполнить реквизиты контрагента по ИНН](https://mcp-everything.ru/integrations/kontur-focus/scenarios/zapolnit-rekvizity-kontragenta-po-inn.md)
- [Найти компанию по названию](https://mcp-everything.ru/integrations/kontur-focus/scenarios/nayti-kompaniyu-po-nazvaniyu.md)
- [Проверить надёжность контрагента перед сделкой](https://mcp-everything.ru/integrations/kontur-focus/scenarios/proverit-nadezhnost-kontragenta-pered.md)
- [Отслеживать изменения у контрагентов](https://mcp-everything.ru/integrations/kontur-focus/scenarios/otslezhivat-izmeneniya-u-kontragentov.md)
- [Проверить статус самозанятого](https://mcp-everything.ru/integrations/kontur-focus/scenarios/proverit-status-samozanyatogo.md)

---

Если этого недостаточно — официальная документация: https://developer.kontur.ru/doc/focus-v2
Вся интеграция одним документом: https://mcp-everything.ru/integrations/kontur-focus.md