API и MCP для интеграций и ИИ-ассистентов

На тарифах, где включён API («Профи» и выше), владелец аккаунта создаёт ключи на странице «Проекты», в блоке «Доступ по API и MCP» внизу. Ключ показывается один раз; храните его как пароль. Права: чтение или чтение и запуск замеров (последнее доступно на тарифе с полным API). Примеры запросов с номером вашего проекта и настройки MCP собраны на вкладке «API / MCP» внутри каждого проекта (она видна, если API есть на вашем тарифе).

Ключ передаётся заголовком Authorization: Bearer ключ. Ответы в формате JSON. Лимит частоты задаётся сервисом (по умолчанию 60 запросов в минуту на ключ, при превышении ответ 429).

• GET /api/v1/projects/: проекты аккаунта.
• GET /api/v1/projects/{id}/: проект с показателями последнего замера: видимость, доля голоса, конкуренты, нейросети, цитируемые сайты.
• GET /api/v1/projects/{id}/runs/: замеры.
• GET /api/v1/projects/{id}/answers/?run=&limit=&offset=: ответы нейросетей.
• GET /api/v1/projects/{id}/plan/: план действий.
• GET /api/v1/usage/: использование лимитов тарифа.
• POST /api/v1/projects/{id}/start-run/: запустить замер (полный доступ; расходует лимит тарифа).
• POST /api/v1/projects/{id}/prompts/: добавить промпты: {"prompts": ["..."]} (полный доступ).

MCP. Для ИИ-ассистентов (например Claude) есть MCP-сервер по HTTP: /api/v1/mcp/, с тем же ключом. Инструменты: список проектов, видимость бренда, план действий, ответы нейросетей, материалы недели и запуск замера. Примеры запросов к ассистенту и команды подключения для Claude Code и Cursor: страница MCP. Каталоги и веб-версии ассистентов требуют входа по OAuth, его у нас пока нет, поэтому подключение идёт по ключу. MCP включён на тарифах «Агентство» и выше.