MCP-сервер для SEO и ИИ-агентов

Локальный stdio-сервер MCP отдаёт одни и те же инструменты Claude Code, Claude Desktop, Codex, Cursor и другим MCP-клиентам. Регистрация показывается до изменения любого файла.

Что делает

Профили

--profile full открывает все инструменты. Профили audit, infra, quick-check и router открывают меньшие наборы для сфокусированных сессий, поэтому агент видит меньше схем. Профиль router анонсирует только doctor, проверку URL, сценарий аудита и каталог инструментов; остальное агент находит через каталог. Более узкий профиль сразу блокирует исключённые инструменты, но клиент должен перезапуститься, чтобы увидеть новые включённые.

  • audit: ограниченные инструменты аудита Screaming Frog
  • infra: проверки домена, CDN, технологий, безопасности, заголовков, robots и sitemap
  • quick-check: быстрые проверки URL, включая пакетную проверку
  • seohead mcp status --json показывает профиль и точное количество инструментов

Безопасная регистрация

Регистрация начинается с плана. Запустите seohead mcp install с --dry-run: он покажет блок конфигурации, файл, который будет изменён, путь к бэкапу и исходный SHA-256. Ничего не записывается. Чтобы применить изменения, добавьте --yes. Конфиг клиента сохраняется в бэкап, заменяется атомарно и разбирается заново; остальные серверы в нём сохраняются.

  • Клиенты: Claude Code, Claude Desktop, Codex и Cursor, выбираются через --client
  • --expected-sha256 отказывает в установке, если файл изменился после предпросмотра
  • seohead mcp uninstall восстанавливает конфиг из бэкапа
  • seohead mcp disable запрещает серверу принимать вызовы

Агенты с памятью

Проекты хранят область работы, политику сканирования, сканы и историю, поэтому следующий агент продолжает с сохранённого проекта, а не с чата. Во входящих проекта лежат заметки специалиста и предложенные цели. Хост может ещё ограничить один MCP-процесс именем потребителя и списком разрешённых папок проекта.

  • workflow-status подсказывает новому агенту следующий зарегистрированный шаг
  • Запись принимает текущую ревизию и завершается ошибкой при конфликте
  • Платные операции требуют явного подтверждения, например confirm_paid=true

Три шага — один сохранённый скан

  1. Предпросмотр регистрации

    Сначала запустите установку с --dry-run. Она выведет точный блок конфигурации, файл, который изменится, путь к бэкапу и sha256, и ничего не запишет.

  2. Установка с --yes

    Прочитав план, добавьте --yes. Предыдущий конфиг сохраняется в бэкап рядом, а --expected-sha256 отказывает в установке, если файл изменился после предпросмотра.

  3. Агенты продолжают сохранённый проект

    Проекты хранят область работы, политику сканирования, сканы и историю. Следующий агент подхватывает сохранённый проект, а не начинает с чата.

Проверки в этой возможности

ПроверкаЧто значитКритичностьДоказательство
REDIRECT_LOOPЦепочка редиректов возвращается к URL, который уже был пройден, и никогда не завершаетсяCriticalПуть цикла из цепочки редиректов (экспорт SF Redirect Chains или записи переходов из собственного сканирования)
BROKEN_INTERNAL_LINKВнутренняя ссылка ведёт на URL, который отвечает 4xxCriticalВходящие ссылки с ошибкой Client Error (4xx): исходная страница и место ссылки
REDIRECT_CHAINДо финального URL больше одного переходаImportantКаждый переход с кодом статуса и значением location
INTERNAL_LINK_TO_REDIRECTВнутренняя ссылка ведёт на URL с 3xx вместо финальной страницыImportantВходящие ссылки с Redirection (3xx): исходная страница и позиция в DOM
BAD_REDIRECT_TYPEИспользуется 302, 303 или 307 там, где нужен постоянный переносTipКод статуса на каждом переходе

Одна команда

bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcp

Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.

Что нужно

  • MCP-клиент: Claude Code, Claude Desktop, Codex, Cursor или любой stdio-клиент
  • Исполняемый файл seohead из виртуального окружения — по абсолютному пути
  • Установлено дополнение mcp для тулкита
  • Ключи провайдеров нужны только для платных инструментов и инструментов, которые работают через аккаунт

Ограничения

  • Это локальный stdio-сервер. Размещённого MCP-эндпоинта нет
  • Журнала вызовов пока нет: если нужен аудит действий, ведите собственный лог
  • Инструменты могут отправлять запросы, когда вы запускаете проверку или сканирование. Какие именно, смотрите в каталоге
  • Добавление записи само по себе не включает MCP, а чтобы что-то записать, нужен --yes

Вопросы

Регистрация сервера меняет мой конфиг?
В режиме предпросмотра — нет. --dry-run ничего не записывает: он показывает файл, который изменится (для Claude Code это ~/.claude.json), путь к бэкапу и sha256. Изменение происходит только с --yes.
Какие клиенты поддерживаются?
Claude Code, Claude Desktop, Codex и Cursor, выбираются через --client. Любой другой MCP-клиент может использовать ту же команду запуска stdio-сервера.
Сколько инструментов видит агент?
Это зависит от профиля. Профиль full открывает все зарегистрированные инструменты, а audit, infra, quick-check и router открывают заметно меньшие наборы. Выполните seohead mcp status --json, чтобы увидеть точное число для каждого профиля в вашей установке.
Сервер работает в облаке?
Нет. Это локальный процесс stdio. Сетевые запросы уходят только для проверок, которые вы запустили, например по URL или сканированию. Сканирование по умолчанию записывает скан в ./scans/.
Может ли агент потратить мои деньги?
Не незаметно. Платные операции требуют явного подтверждения (confirm_paid=true) и ваших собственных ключей провайдеров. tool-catalog отмечает инструменты, которые могут тратить деньги.
Как его выключить?
Выполните seohead mcp disable. После этого работающий сервер отклоняет новые вызовы инструментов. uninstall удаляет запись из конфига клиента и восстанавливает конфиг из бэкапа.

Проверьте на своём сайте