MCP-сервер для Claude Code и Codex: проверка позиций сайта

Классический съём позиций выглядит так: открыть сервис, загрузить запросы, подождать, выгрузить CSV, открыть таблицу. Пять действий ради одной цифры. Если вы и так полдня проводите в Claude Code или Codex, эти действия можно выкинуть. Подключаете наш MCP-сервер и пишете прямо в чате: «на какой позиции mysite.ru по запросу „купить ноутбук“ в Москве». Агент сам дёрнет поиск и ответит номером.

Что здесь вообще происходит

MCP - это протокол, по которому ИИ-агенты подключаются к внешним инструментам. Наш сервер живёт по адресу https://jsonseo.ru/mcp и отдаёт агенту тот же поиск, что и обычный API: Яндекс, Google, Bing. Ключ тот же, баланс общий, страница выдачи стоит те же 0.01 ₽. Отдельной подписки «для ИИ» не существует: если есть аккаунт, всё уже готово.

Подключение

Подключается сервер за пару минут: в Claude Code - одной командой, в Codex - несколькими строками конфига, в Claude Desktop и Cursor - через мост mcp-remote. Пошагово для каждого клиента, с командами и диагностикой, расписано в статье про подключение MCP-сервера. Здесь же сосредоточимся на том, ради чего всё затевалось: как снимать позиции прямо из диалога.

Какие инструменты получает агент

Как выглядит диалог

Примерно так. Вы пишете:

Проверь, на каких позициях jsonseo.ru в Яндексе по запросам
«api выдачи яндекса», «парсинг выдачи google» и «xml выдача».
Регион: Москва.

Агент трижды вызывает yandex_position с lr=213 и через несколько секунд отвечает списком: по первому запросу такая-то позиция, по второму такая-то, по третьему домена в выдаче нет. Ни выгрузок, ни таблиц, ни переключения окон. Если попросить, тут же объяснит, по какому из запросов стоит смотреть конкурентов, и сам их посмотрит.

Работает это не только с Яндексом: у агента есть google_search и bing_search с теми же возможностями, так что позиции в трёх поисковиках сравниваются одним промптом.

Зачем столько вариантов одного и того же

Из-за токенов. Выдача Яндекса на пару страниц со сниппетами - это заметный кусок JSON, и агент честно прочитает его весь, потратив контекст на текст, который вам не нужен. Если задача звучит как «на каком месте сайт», правильный выбор yandex_position или google_position: в ответе одно число, контекст почти не тратится. Нужен обзор конкурентов в топе? Берите compact=true. А полный ответ со сниппетами имеет смысл, когда вы просите агента проанализировать, чем тексты конкурентов отличаются от вашего.

Модели обычно сами выбирают экономный вариант, но подсказать в промпте не вредно.

Регионы

Позиция без региона мало что значит, про это у нас есть отдельный разбор. Хорошая новость: коды городов агенту зубрить не нужно. Он вызывает yandex_regions или google_regions, находит, что Москва в Яндексе - это lr=213, а в Google 1011969, и подставляет код в следующий запрос. Оба справочника бесплатные, с баланса за них не списывается ничего.

Куда девается ключ

Ключ не попадает в текст диалога: клиент шлёт его заголовком Authorization: Bearer или читает из переменной окружения при каждом обращении к серверу. Модель ключа не видит, и в истории чата он не всплывёт. Если ключ всё-таки засветился где-то ещё, перевыпустите его в кабинете: старый перестанет работать, а настройку MCP достаточно обновить.

Что это даёт на практике

Промпты вида «проверь позиции jsonseo.ru по этим двадцати запросам в Москве и Питере, сведи в таблицу и отметь, где мы ниже десятого места» перестают быть фантастикой. Агент прогонит запросы через yandex_position, сам разрулит коды регионов и отдаст готовую сводку. Можно пойти дальше и попросить сохранить результат в файл проекта, чтобы через неделю сравнить динамику.

Считается это по обычному тарифу: 10 ₽ за 1000 страниц выдачи. Проверка позиции по одному запросу в одном регионе обойдётся от одной копейки. При регистрации на баланс падают 10 ₽, так что первую тысячу проверок вы сделаете бесплатно и успеете понять, прижился ли такой формат работы.

Полный список инструментов с параметрами смотрите в документации по MCP. Если агентский сценарий не ваш и нужен обычный HTTP, начните со статьи про парсинг выдачи через JSON API.