mcp-seo-audit

Servidor MCP para "Auditar https://example.com

Documentação

atomno-mcp-seo-audit

Servidor MCP (Model Context Protocol) para auditorias técnicas de SEO & GEO, alimentado pelo motor detail.web — medições reais, não suposições de LLM. Execute-o a partir do Cursor, Claude Desktop ou qualquer cliente MCP. 8 ferramentas: audit_site (score de saúde 0–100 determinístico + nota por letra, 78 verificações em 8 categorias, além de um sub-score GEO — visibilidade no ChatGPT / Perplexity / Google AI Overviews), audit_diff (compare com o snapshot anterior), robots.txt e sitemap.xml validadores, construtores de JSON-LD e meta/OpenGraph, e explicadores de correção por verificação. Sonda TLS, redirecionamentos, TTFB, acesso de crawlers de IA (GPTBot) e llms.txt. Nível gratuito + PRO+ (deep-crawl, GEO, 40+ verificações mais profundas) — chaves de API desbloqueiam o motor mais profundo no plano PRO+ e acima (veja Free vs PRO+).

Por que combinar com um LLM?

Um modelo de linguagem por conta própria infere um site a partir de dados de treinamento e, no melhor caso, uma página renderizada — ele não consegue ler diretamente o vencimento do seu certificado TLS, medir tempo de resposta, analisar sitemap.xml, ou verificar se GPTBot está bloqueado em robots.txt. Este servidor executa essas verificações de verdade: requisições HTTP reais, cabeçalhos de segurança, cadeias de redirecionamento, validação de dados estruturados — e retorna um score determinístico (mesmo site → mesmo número), reproduzível o suficiente para colocar em um relatório de cliente. Pense nele como o instrumento e o LLM como o analista que interpreta a leitura — os dois funcionam melhor juntos.

O que você obtém

audit_site(url, depth=1, lang="ru") — uma chamada retorna:
- score de saúde 0–100 (quanto maior, melhor) e uma nota por letra A–F;
- problemas agrupados por categoria (segurança, SEO & indexação, performance, GEO, …), cada um com status pass / warn / fail;
- um resumo curto e legível.
audit_diff(url, lang="ru") — re-audita um site e compara com a execução anterior: delta de saúde/score e quais verificações pioraram ou melhoraram. A primeira chamada armazena uma linha de base. Isso é algo que uma pergunta única de LLM não consegue fazer — acompanhe um site ao longo do tempo. Recurso com estado — precisa de uma chave no plano PRO+ ou superior.
list_checks(lang="ru") — o catálogo completo de verificações do motor agrupado por categoria, com um selo free / PRO em cada uma — para que você (e o agente) possa ver exatamente o que o nível gratuito cobre e o que o PRO desbloqueia.
explain_issue(check_id, lang="ru") — um mergulho profundo em uma única verificação: por que ela importa e como corrigi-la. Passe um check_id de audit_site ou list_checks. Título e categoria são localizados; conselhos detalhados estão atualmente em russo (o campo advice_lang relata isso).
validate_robots(content, lang="ru") — cole um robots.txt e receba de volta problemas de sintaxe, se uma diretiva Sitemap: está presente, se CSS/JS está bloqueado para bots de renderização, e quais crawlers de IA (GPTBot, ClaudeBot, …) estão explicitamente bloqueados. Sem fetch — valida o texto que você fornece.
check_sitemap(url, lang="ru") — busca um sitemap por URL e relata seu formato (urlset / sitemapindex), contagem de URLs e problemas comuns (404, tipo de conteúdo não-XML, links http://, <lastmod> ausente, o limite de 50k por arquivo). O fetch é protegido contra SSRF no servidor.
build_jsonld(type, fields, lang="ru") — gera um JSON-LD <script> schema.org pronto para colar (Organization, LocalBusiness, Article, Product, FAQPage, BreadcrumbList, WebSite) e informa quais campos obrigatórios/recomendados estão ausentes. Nunca inventa dados — apenas o que você passar.
build_meta(fields, lang="ru") — gera meta tags <head> (title, description, canonical, Open Graph, Twitter Card) e valida os comprimentos do title (50–60 caracteres) e da description (120–160 caracteres).

Free vs PRO+

	Free (sem chave)	PRO+ e acima (chave de API)
Verificações	fundamentos técnicos básicos	40+ verificações mais profundas (E-E-A-T, Schema.org, título Goldmine)
GEO	4 sinais GEO	sub-score de prontidão GEO + verificações GEO profundas
Crawl	página única	deep-crawl de até 20 páginas (`depth=2/3`)

Qual plano desbloqueia a API/MCP? Acesso programático (este servidor, audit_diff, deep-crawl, sub-score GEO) é habilitado no PRO+ (pro_plus), Business e Enterprise. O plano PRO de entrada e o nível Free são apenas painel web — uma chave de API emitida neles autentica, mas ainda retorna o resultado free. Se você precisa de acesso programático, escolha PRO+ ou superior.

O motor de auditoria em si permanece no servidor — este pacote é um cliente fino (apenas chamadas HTTP + formatação).

Instalação

uvx atomno-mcp-seo-audit

Ou adicione à configuração do seu cliente MCP (mcp.json):

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"]
    }
  }
}

Configuração

Tudo via variáveis de ambiente:

Variável	Padrão	Finalidade
`DETAILWEB_API_BASE`	`https://api.detailweb.ru`	URL base do backend
`DETAILWEB_API_KEY`	—	Chave de API (`dwa_...`) de um plano PRO+ ou superior. Sem ela (ou no Free/PRO) → nível gratuito
`DETAILWEB_TIMEOUT`	`60`	Timeout HTTP (segundos)
`DETAILWEB_LANG`	`ru`	Idioma padrão do título do problema (`ru` / `en`)

O nível gratuito não precisa de chave nem cadastro — basta executar o comando acima. Acesso programático (40+ verificações mais profundas, sub-score GEO, deep-crawl, audit_diff) requer uma chave do plano PRO+ ou superior — o plano PRO de entrada é apenas painel web e sua chave retorna o resultado gratuito. Atualmente é provisionado sob solicitação: envie um e-mail para kir@detailweb.ru ou entre em contato via audit.detailweb.ru. Quando sua conta estiver ativa, você cria chaves você mesmo em Dashboard → Account → API keys (dwa_…, mostrada uma vez) e coloca a chave em DETAILWEB_API_KEY.

Exemplo

"Audite https://example.com"

O agente chama audit_site("https://example.com") e recebe de volta o score de saúde, a nota e a lista de problemas para corrigir.

Licença

🇷🇺 На русском

MCP-сервер технического SEO-аудита на движке detail.web. Запускайте аудит прямо из ИИ-агента (Cursor, Claude Desktop и любой MCP-клиент): health-score, проблемы по 8 категориям и GEO-суб-балл (видимость в ИИ-поиске — ChatGPT, Perplexity, AI Overviews).

Зачем в связке с нейросетью. Языковая модель сама по себе судит о сайте по обучающим данным и в лучшем случае по одной отрисованной странице — она не прочитает напрямую срок SSL-сертификата, не измерит время ответа, не распарсит sitemap.xml и не проверит, заблокирован ли GPTBot в robots.txt. Этот сервер выполняет такие проверки по-настоящему: HTTP-запросы, заголовки, редиректы, микроразметка — и даёт детерминированный score (тот же сайт → то же число), пригодный для отчёта клиенту. Это прибор, а нейросеть — аналитик, который читает показания. Лучше всего работает связка.

Инструменты: audit_site (аудит + score + GEO), audit_diff (что изменилось с прошлой проверки — stateful, тариф PRO+ и выше), list_checks (каталог проверок free/PRO), explain_issue (почему важно + как исправить), validate_robots, check_sitemap, build_jsonld, build_meta.

Установка:

uvx atomno-mcp-seo-audit

В конфиге MCP-клиента (mcp.json):

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"],
      "env": { "DETAILWEB_LANG": "ru" }
    }
  }
}

Бесплатный тариф (базовые проверки, одна страница) работает сразу, без ключа и регистрации. Программный доступ (40+ глубоких проверок, GEO-суб-балл, deep-crawl до 20 страниц, audit_diff) работает с ключом тарифа PRO+ (pro_plus) и выше — Business, Enterprise. Начальный тариф PRO (1290 ₽) и Free — только веб-кабинет: ключ на них проходит авторизацию, но результат остаётся бесплатным. Тариф пока выдаём по запросу: напишите на kir@detailweb.ru или через audit.detailweb.ru. После активации аккаунта ключ (dwa_…) создаётся в кабинете → Аккаунт → API-ключи (показывается один раз) и подставляется в DETAILWEB_API_KEY в env. Полное описание инструментов и настроек — в английской версии выше.