# Контур.Фокус API: Проверить надёжность контрагента перед сделкой Сценарий из mcp-everything. Актуально на 2026-10-25. Сводная проверка рисков: экспресс-отчёт, скоринг, признаки из реестров ФНС и долги у приставов. 1. GET /api3/briefReport — экспресс-отчёт с ключевыми факторами (есть вариант `pdf=true`). 2. GET /api3/scoring — рейтинг 0–100 по моделям проверки; `ratingLevel`: `Low`, `Middle`, `High`; `triggeredMarkers` — что повлияло. 3. GET /api3/legalAnalytics — недостоверность адреса или руководителя, блокировка счетов ФНС, налоговый долг, непредставление отчётности, заявления о ликвидации и смене руководителя. 4. GET /api3/financeAnalytics — выручка, прибыль, чистые активы, налоги и долги по налогам. 5. GET /api3/fssp — исполнительные производства (по 1000 записей, дальше `skip=1000`). ```bash curl "https://focus-api.kontur.ru/api3/briefReport?key=$FOCUS_KEY&inn=6663003127" curl "https://focus-api.kontur.ru/api3/scoring?key=$FOCUS_KEY&inn=6663003127" curl "https://focus-api.kontur.ru/api3/legalAnalytics?key=$FOCUS_KEY&inn=6663003127" curl "https://focus-api.kontur.ru/api3/fssp?key=$FOCUS_KEY&inn=6663003127" ``` ## Базовые 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/briefReport — Экспресс-отчёт Краткая характеристика контрагента с ключевыми факторами по открытым и официальным источникам. Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2FbriefReport | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `key` | query | string | да | Ключ доступа | | `inn` | query | string | нет | ИНН, до 100 через запятую | | `ogrn` | query | string | нет | ОГРН, до 100 через запятую | | `xml` | query | boolean | нет | Отчёт в XML | | `pdf` | query | string | нет | true — отчёт в PDF | ### GET /api3/scoring — Скоринговая оценка `scoringData[]`: `modelId`, `modelName`, `rating` (0–100), `ratingLevel` (`Low` 0–39, `Middle` 40–69, `High` 70–100), `triggeredMarkers`. Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Fscoring | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `key` | query | string | да | Ключ доступа | | `inn` | query | string | нет | ИНН, до 100 через запятую | | `ogrn` | query | string | нет | ОГРН, до 100 через запятую | | `xml` | query | boolean | нет | Ответ в XML | ### GET /api3/legalAnalytics — Юридические признаки `legalAnalyticsData`: недостоверность адреса, руководителя, учредителя (`unreliableAddress`, `unreliableManager`, `unreliableFounder`), блокировка счетов ФНС (`bankAccountFnsBlock`), налоговый долг (`fnsHasTaxDebt`), непредставление отчётности (`fnsTaxReportMissing`), дисквалификация руководителей, заявления о ликвидации и смене руководителя, численность, МСП, спецрежимы. У каждого признака есть `isActual`. Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2FlegalAnalytics | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `key` | query | string | да | Ключ доступа | | `inn` | query | string | нет | ИНН, до 100 через запятую | | `ogrn` | query | string | нет | ОГРН, до 100 через запятую | ### GET /api3/financeAnalytics — Оценка по финансам и налогам `financeAnalyticsData`: последний год отчётности, выручка, баланс, чистая прибыль и чистые активы на начало и конец периода, уплаченные налоги, долги и штрафы по налогам, экспертный рейтинг отчётности. Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2FfinanceAnalytics | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `key` | query | string | да | Ключ доступа | | `inn` | query | string | нет | ИНН, до 100 через запятую | | `ogrn` | query | string | нет | ОГРН, до 100 через запятую | ### GET /api3/fssp — Исполнительные производства `fssp[]`: `officialNum`, `startDate`, `sum`, `topic`, `executoryDocument`, `cancelDate`, `bailiffDepartment` и др.; `updateDate` — актуальность данных. Для ИП сведения есть, только если обновлялись в веб-версии. Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Ffssp | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `key` | query | string | да | Ключ доступа | | `inn` | query | string | нет | ИНН; обязателен, если нет ОГРН | | `ogrn` | query | string | нет | ОГРН | | `skip` | query | integer | нет | Пропустить N записей (по 1000 на страницу: skip=1000, …) | | `xml` | query | boolean | нет | Ответ в XML | ## Нюансы - Большинство методов принимают ИНН или ОГРН и до 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-paket-kontragentov.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