# Контур.Фокус API: Найти компанию по названию

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

Когда ИНН неизвестен: подсказки при вводе, затем выбор нужной организации и запрос реквизитов.

1. При посимвольном вводе вызывай GET /api3/suggest?q=... — в ответе тип (`UL`/`IP`), наименование, адрес, ИНН, ОГРН, статус.
2. Для полноценного поиска (название, ФИО руководителя, учредитель, адрес) — GET /api2/search?q=... с фильтром `region` и страницами `page` (до 10 результатов на странице, не больше 50 страниц).
3. По выбранному ИНН или ОГРН запроси GET /api3/req.

```bash
curl "https://focus-api.kontur.ru/api3/suggest?key=$FOCUS_KEY&q=контур"

curl "https://focus-api.kontur.ru/api2/search?key=$FOCUS_KEY&q=газпром&region=66&page=1"
```

## Базовые 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/suggest — Поисковые подсказки

В ответе: `type` (`UL`, `IP`), `shortName`, `longName`, `fio`, `address`, `inn`, `ogrn`, `kpp`, `status`.

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

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `key` | query | string | да | Ключ доступа |
| `q` | query | string | да | Поисковый запрос |
| `xml` | query | boolean | нет | Ответ в XML |

### GET /api2/search — Поиск компаний

Поиск по наименованию, ФИО руководителя, учредителю, адресу. В ответе `count` и `items[]`: `type`, `shortName`, `longName`, `activityText`, `address`, `inn`, `kpp`, `ogrn`, `fio`, `statusText`.

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

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `key` | query | string | да | Ключ доступа |
| `q` | query | string | да | Поисковый запрос |
| `region` | query | string | нет | Код региона 01–99 |
| `page` | query | string | нет | Страница (до 10 результатов), по умолчанию 1, максимум 50 |
| `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/proverit-nadezhnost-kontragenta-pered.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