Инструменты MCP

Список инструментов и права

Ассистенту доступны только инструменты, разрешённые при подключении. Если выданы только права чтения, создавать и изменять отчёты он не сможет. Чтобы изменить права, отключите подключение и подключитесь заново с нужными разрешениями.

Многие клиенты показывают вызовы инструментов и их параметры прямо в чате. Таблицы и примеры ниже помогут понять, что именно ассистент передал в SEO Reports.

project_search: поиск проекта

Ищет проекты вашего аккаунта по части названия или адреса сайта. Проекты других аккаунтов ассистенту недоступны.

{
  "query": "example.ru",
  "page": 1
}

Если подходящих проектов несколько, назовите ассистенту точный адрес сайта или выберите проект из найденных.

report_options: информация о проекте

Показывает, какие шаблоны доступны проекту, какой из них используется по умолчанию и был ли у проекта отчёт раньше. Ассистент вызывает инструмент перед генерацией, чтобы выбрать шаблон.

Если вы не указали шаблон, ассистент может взять шаблон по умолчанию. Если его нет, а доступных шаблонов несколько, назовите нужный сами.

Настройки источников, целей и рекламных кампаний подставляются автоматически: из последнего отчёта, автогенерации или настроек по умолчанию. Перечислять их в запросе не нужно. Чтобы изменить их, настройте отчёт в кабинете.

report_history: история отчётов

Показывает отчёты, уже собранные по проекту, — тот же список, что история отчётов в кабинете, от новых к старым. Ассистент использует его, когда вы просите открыть существующий отчёт, например «отчёт за август»: находит строку с нужным периодом и дальше работает с этим отчётом, не собирая новый.

{
  "project_id": "35328",
  "page": 1
}

Для каждого отчёта в ответе есть отчётный период, период сравнения, дата генерации, статус и ссылка на просмотр. Отчёты автогенерации отмечены отдельно (auto). За каждый день в истории остаётся последний ручной и последний автоматический отчёт.

report_generate: генерация отчёта

Собирает отчёт за выбранный период или пересчитывает уже собранный. В запросе укажите проект, период с годом и при необходимости период сравнения и шаблон.

{
  "project_id": "35328",
  "period_from": "2026-08-01",
  "period_to": "2026-08-31",
  "comparison_from": "2026-07-01",
  "comparison_to": "2026-07-31",
  "refresh": false,
  "make_public": false
}

В ответе ассистент получает идентификатор отчёта, статус сборки, ссылку на просмотр и предупреждения. Повторный запрос с теми же параметрами без пересчёта обычно возвращает уже собранный отчёт.

report_get: карточка отчёта

Показывает состояние отчёта: собирается он или готов, ссылку на просмотр, доступ для гостей, предупреждения и список блоков. Если отчёт ещё собирается, инструмент ждёт около 20 секунд. Если сборка затянулась, попросите ассистента проверить отчёт позже.

Когда отчёт готов, ассистент даёт ссылку и сообщает о предупреждениях, например об отключённом источнике. Если сборка завершилась ошибкой, в ответе будет её код (error_code). Из карточки ассистент берёт коды блоков (block_ref) и версию отчёта (revision) для следующих действий.

report_get_block_data: данные блока

Читает цифры выбранного блока, например трафика или поисковых фраз, и схему его настроек: какие параметры есть и какие значения допустимы. По цифрам ассистент готовит выводы, а по схеме меняет настройки блока.

Большие таблицы сокращаются: строк приходит не больше max_rows, а при большом объёме ответа — ещё меньше. Сокращение отмечается в ответе (truncated). Учитывайте, что выводы по такой таблице сделаны по её части. Полные данные блока можно получить через REST API.

report_set_block_comment: комментарий к блоку

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

{
  "report_id": "35328.a3f1c9e84b2d7061fe5c8a94d20b3e77",
  "block_ref": "publicTraffic",
  "html": "<p>Вывод по проверенным данным.</p>",
  "expected_revision": 3,
  "position": "bottom",
  "mode": "append"
}

report_edit_structure: структура отчёта

Меняет порядок блоков, их видимость, заголовки и настройки, добавляет и удаляет текстовые блоки. Несколько правок ассистент применяет одной операцией в заданном порядке.

{
  "report_id": "35328.a3f1c9e84b2d7061fe5c8a94d20b3e77",
  "expected_revision": 3,
  "changes": [
    {
      "op": "move",
      "block_ref": "publicTraffic",
      "after": "START"
    },
    {
      "op": "disable",
      "block_ref": "publicDevices"
    },
    {
      "op": "add_text_block",
      "title": "План работ",
      "html": "<p>Проверить посадочные страницы.</p>",
      "after": "END"
    }
  ]
}

Если отчёт изменили после того, как ассистент его прочитал, правка не сохранится: вернётся ошибка revision_conflict. Попросите ассистента перечитать отчёт и повторить изменения. Включение блока может быть недоступно по тарифу или доступам к источникам.

Как инструменты складываются в задачу

Новый отчёт: project_search → report_options → report_generate → report_get. Готовый отчёт: project_search → report_history → report_get. Вывод к блоку: report_get → report_get_block_data → анализ → report_set_block_comment. Готовые формулировки задач — в примерах, разбор ошибок — в диагностике.