Документация

Как подключить сервис, что можно спросить у ассистента и сколько это стоит.

Подключение

  1. Создайте аккаунт в кабинете и сохраните ключ: он показывается один раз.
  2. Вставьте команду или конфиг ниже в ваш клиент, заменив ВАШ_КЛЮЧ.
  3. Спросите ассистента, например: «Проверь позиции сайта example.ru в Яндексе».
claude mcp add --transport http seo https://адрес-сервиса/mcp --header "Authorization: Bearer ВАШ_КЛЮЧ"
{
  "mcpServers": {
    "seo": {
      "url": "https://адрес-сервиса/mcp",
      "headers": { "Authorization": "Bearer ВАШ_КЛЮЧ" }
    }
  }
}

Подходит любой клиент с поддержкой удалённых MCP-серверов и заголовков авторизации. Если клиент не умеет заголовки, ключ можно передать в адресе: https://адрес-сервиса/mcp/k/ВАШ_КЛЮЧ. Такой адрес храните как пароль.

Готовые запросы

Скопируйте запрос, замените example.ru на свой сайт и отправьте ассистенту. Запросы сгруппированы по задачам.

Методики

Для типовых задач сервис знает проверенный порядок действий: какие инструменты брать, в каком порядке, сколько это стоит и чего не делать. Ассистент берёт методику сам, а вы можете вызвать её явно.

  • Скажите ассистенту «используй seo_playbook для проверки позиций» или просто опишите задачу: первым вызовом он получит методику. Инструмент бесплатный.
  • В клиентах с командами (слеш-командами) методики доступны как prompts: позиции, конкуренты и пробелы, подбор ключей, технический аудит, ссылочный профиль, экспресс-аудит из Вебмастера, падение трафика, темы для контента, видимость в нейросетях.
  • Тексты методик открываются и как ресурсы skill://seo/ в клиентах, которые их показывают.

Методики подстраиваются под сервер и под вас: недоступные источники в них не показываются, у шагов указана текущая цена, а там, где нужен Яндекс, видно, подключён ли он.

Токены и оплата

  • 100 токенов равны 1 ₽. Баланс общий для всех источников.
  • Перед выполнением токены резервируются по максимальной цене, после ответа остаток возвращается: итог считается по фактической стоимости.
  • Если запрос не удался, токены возвращаются полностью. Каждое списание и возврат записаны в журнале кабинета.
  • Повторный одинаковый запрос может прийти из кэша: данные те же, цена не меняется.
  • Долгие задачи (съём позиций, обход сайта, GEO-аудит) запускаются в фоне. Проверка статуса и чтение результатов бесплатны.
  • Инструменты, помеченные «бесплатно», токены не расходуют.

Метрика и Вебмастер

После подключения ассистент читает ваши данные: реальные поисковые запросы сайта, трафик, ошибки и диагностику. Доступ только на чтение.

  1. Создайте приложение на oauth.yandex.ru: платформа «Веб-сервисы», Redirect URI «Подставить URL для отладки».
  2. Отметьте доступы metrika:read, webmaster:hostinfo и webmaster:verify.
  3. Откройте адрес с ID приложения и скопируйте токен: https://oauth.yandex.ru/authorize?response_type=token&client_id=ID_ПРИЛОЖЕНИЯ
  4. Вставьте токен в кабинете, раздел «Подключения». Он хранится только в зашифрованном виде, отключить его можно там же.

Токен видит все счётчики и сайты вашего аккаунта Яндекса. Срок его жизни ограничен: когда он истечёт, подключите Яндекс заново.

Инструменты

Ассистент выбирает инструменты сам. Этот список строится из текущей конфигурации сервиса.

Ограничения

  • Зарубежные данные DataForSEO не включают Россию, Беларусь и Яндекс. Для российского рынка используются Keys.so, выдача Яндекса и Wordstat.
  • У каждого ключа есть ограничение на число запросов в минуту. При превышении сервис ответит ошибкой, токены не спишутся.
  • Позиции в выдаче и ответы нейросетей меняются от запроса к запросу. GEO-аудит поэтому повторяет запросы и считает доли.
  • Данные принадлежат сторонним сервисам и могут быть временно недоступны. Если источник не ответил, токены возвращаются.