Подключите Search Console к любому MCP-клиенту

Эндпоинт

Сервер работает по адресу /mcp в домене приложения и использует Streamable HTTP версии протокола 2025-06-18. Клиенты отправляют JSON-RPC через POST: сначала запрос initialize, затем tools/list. Устанавливать ничего не нужно, локальный прокси в цепочке отсутствует.

• Authorization: Bearer с ключом вида apk_live_ и 32 шестнадцатеричных символа
• Ключи показываются один раз при создании и хранятся только в виде хеша SHA-256
• Каждый вызов обновляет отметку времени последнего использования ключа и счётчик запросов

Инструменты

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

• Обнаружение: list_properties, search_analytics
• Эффективность: top_queries, top_pages, top_countries, compare_periods
• Диагностика: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Индексация: url_inspection, sitemaps
• Хронология: annotations и create_annotation — для ключа с правом записи
• Аналитика: ga4_overview, ga4_breakdown, ga4_key_events
• Исследования: ключевые слова, выдача, обратные ссылки, отслеживание позиций и аудиты сайта, которые расходуют кредиты исследований
• Контент-движок: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish и инструменты обложек для написания статей из очереди

Даты не обязательны

Если не указать диапазон дат ни для одного инструмента, сервер использует последние 28 стабилизировавшихся дней с учётом задержки отчётности Search Console, а период сравнения по умолчанию — предыдущий период такой же длины. Клиенту не нужно знать текущую дату, чтобы задать осмысленный вопрос.

Права доступа и лимиты запросов

Ключ может быть только для чтения либо для чтения и записи. Ключ только для чтения вообще не может обратиться к инструменту записи, а каждое изменение через ключ с правом записи фиксируется в журнале аудита.

• 60 запросов в минуту на ключ, 1000 в час на аккаунт
• При превышении лимита возвращается HTTP 429 с заголовком Retry-After в секундах
• Отзывайте отдельный ключ, не затрагивая остальной аккаунт

REST, если удобнее

Инструменты Search Console и GA4 также доступны как маршруты GET и POST в /v1 со сгенерированным документом OpenAPI 3.1 по адресу /v1/openapi.json, который служит и спецификацией вызова функций. Те же ключи, те же права, те же лимиты.