← Updates

Public API и MCP 2.4: фильтры, аннотации, share и SEO enrich

Сохранённые фильтры, теги и заметки к отчётам, гостевые share-ссылки и дозагрузка SEO-метрик — в REST API и MCP. 31 инструмент вместо 21, тот же API-ключ.

В Public API и MCP-сервере появился полный workflow вокруг отчёта — то, что раньше было только в веб-приложении. Один Bearer-ключ из Профиль → Настройки, лимит 60 запросов в минуту общий для REST и MCP.

В MCP теперь 31 инструмент (было 21). Новая группа «Работа с отчётами» — 10 эндпоинтов в REST разбиты так же: Reports, Account, Report workflow, Live checkers.

Сохранённые фильтры

Сохраняйте набор фильтров поиска по имени и вызывайте его из скрипта или чата.

  • REST: GET / PUT / DELETE /v1/user/saved-filters
  • MCP: list_saved_filters, save_saved_filter, delete_saved_filter

Аннотации и теги

Заметки до 200 символов и до 10 тегов на отчёт — для shortlist’ов, CRM и командной работы.

  • REST: GET /v1/reports/annotations/tags, GET / PUT / DELETE /v1/reports/annotations
  • MCP: list_annotation_tags, get_report_annotation, set_report_annotation, delete_report_annotation

Гостевые share-ссылки

Отправьте отчёт коллеге или клиенту без доступа в аккаунт.

  • REST: POST /v1/reports/share → в ответе share_url
  • MCP: create_share_link

В теле запроса — report_type и report_id из поиска или полного отчёта.

SEO enrich через API

Дозагрузка недостающих SEO-метрик теперь доступна и программно — вне системной очереди, как в карточке отчёта.

  • REST: POST /v1/reports/{report_type}/{report_id}/enrich-seo (ответ 202 + job_id), затем GET /v1/reports/enrich-jobs/{job_id} до статуса done
  • MCP: enrich_report_seo, get_enrich_report_seo_job

Если MCP уже подключён

URL и ключ менять не нужно. Клиент кэширует список тулов на сессию — откройте новый чат или перезапустите Cursor / Claude / ChatGPT. Для REST новые маршруты доступны сразу.

Подробности, примеры curl и схемы полей — на обновлённых лендингах API и MCP, полная схема — в Swagger UI.