MaxAEO AI Visibility MCP

Servidor MCP local-first para auditorias de visibilidade de IA em GEO/AEO, llms.txt, prontidão para crawlers de IA, robots, sitemap, canonical, metadados, noindex e JSON-LD.

GitHub

Documentação

Servidor MCP MaxAEO AI Visibility para GEO, AEO e AI SEO

Servidor local-first do Model Context Protocol (MCP) para auditorias de visibilidade em IA, GEO, AEO, AI SEO, llms.txt e prontidão para crawlers de IA no Claude, Codex, Cursor, Windsurf e outros agentes compatíveis com MCP.

Documentação em chinês

Ele ajuda o Claude, Codex, Cursor e outros agentes compatíveis com MCP a verificar se um site público é rastreável, compreensível e pronto para fluxos de busca com IA. Por padrão, ele executa apenas verificações locais/públicas na web. Ele não chama APIs de nuvem da MaxAEO, não envia domínios de usuários, não invoca APIs de LLM nem usa telemetria oculta.

Configuração em 60 Segundos

Instale via npm:

npm install -g maxaeo-ai-visibility-mcp

Adicione a um cliente MCP:

{
  "mcpServers": {
    "maxaeo-ai-visibility": {
      "command": "npx",
      "args": ["-y", "maxaeo-ai-visibility-mcp"]
    }
  }
}

Execute uma auditoria a partir do seu agente:

Use MaxAEO AI Visibility MCP to audit https://example.com and give me a 7-day action plan.

Para fluxos de trabalho em modo de comando com Claude e Codex, consulte o MaxAEO AI Visibility Agent Kit.

Texto para Listagem em Diretórios

Se você quiser listar este projeto em um diretório MCP, lista de recursos incríveis, lista de recursos de AI SEO, lista de recursos de GEO ou índice de ferramentas llms.txt, use um texto factual e conciso:

[MaxAEO AI Visibility MCP](https://github.com/maxaeo/maxaeo-ai-visibility-mcp) - Local-first MCP server for GEO/AEO and AI visibility audits. Checks llms.txt, AI crawler access, robots, sitemap, canonical, metadata, noindex, and JSON-LD; returns local-only visibility score, technical foundation score, top issues, and a 7-day action plan. Install: `npx -y maxaeo-ai-visibility-mcp`.

Para fluxos de trabalho de comando com Claude e Codex, liste o MaxAEO AI Visibility Agent Kit.

Casos de Uso

Executar uma auditoria de visibilidade em IA a partir de um cliente MCP ou agente de codificação.
Verificar prontidão para GEO / otimização de mecanismos generativos.
Verificar fundamentos de AEO / otimização para mecanismos de resposta e busca com IA.
Validar llms.txt, robots.txt, alinhamento de sitemap, URLs canônicas, noindex, metadados e JSON-LD.
Gerar um plano de ação local de 7 dias sem usar APIs pagas de LLM ou busca.

Intenções de busca comuns que este servidor MCP atende:

Servidor MCP de visibilidade em IA
Claude SEO MCP
Auditoria de visibilidade em IA para Codex
Auditoria local de site GEO / AEO
Verificador de llms.txt
Prontidão para crawlers de IA para GPTBot, ClaudeBot, PerplexityBot, Google-Extended e fluxos de busca com IA

Ferramentas

Ferramenta	Finalidade
`check_llms_txt`	Validar `/llms.txt`, URLs vinculadas, alinhamento de robots e alinhamento de sitemap.
`audit_ai_crawler_readiness`	Verificar regras de robots, disponibilidade de sitemap, metadados da página inicial, canônicos, schema e fundamentos de acesso de crawlers de IA.
`build_ai_visibility_report`	Executar as verificações locais e retornar um plano de ação conciso com CTA da MaxAEO.

Todas as ferramentas suportam:

Opção	Valores	Finalidade
`locale`	`en-US`, `en`, `global`, `zh-CN`, `zh`, `cn`	Idioma de saída.
`market`	`global`, `cn`	Mercado do CTA. `global` aponta para `maxaeo.ai`; `cn` aponta para `maxaeo.cn`.
`ctaBaseUrl`	URL	Página de destino personalizada opcional para o CTA da MaxAEO.

Cobertura de crawlers por mercado

audit_ai_crawler_readiness seleciona sua lista de crawlers a partir de market.

`market`	Crawlers auditados
`global` (padrão)	`GPTBot`, `ChatGPT-User`, `OAI-SearchBot`, `PerplexityBot`, `ClaudeBot`, `Google-Extended`, `Applebot`, `Bingbot`, `Baiduspider`
`cn`	`Baiduspider`, `Baiduspider-image`, `Baiduspider-news`, `360Spider`, `PetalBot`, `Sogou web spider`, `YisouSpider`, `Bytespider`, `ToutiaoSpider`

Nenhum produto chinês de IA publica documentação de crawlers, e nenhum deles divide treinamento e recuperação em user-agents separados como GPTBot e OAI-SearchBot fazem. Suas respostas são recuperadas por meio do índice de busca existente da empresa controladora, então os crawlers de busca tradicionais são o que realmente controlam a citação no mercado doméstico.

Cada token em ambas as listas é documentado pelo seu operador ou observado em vários robots.txt de domínios independentes. Tokens não verificáveis que circulam online — BaiduBot, DoubaoBot, TongyiBot, Kimi-User e similares — são deliberadamente excluídos, e um teste garante isso. Auditar contra um user-agent que não existe produz um resultado sobre o qual ninguém pode agir.

Instalação

npm install -g maxaeo-ai-visibility-mcp

Execução

maxaeo-ai-visibility-mcp

Claude Desktop

{
  "mcpServers": {
    "maxaeo-ai-visibility": {
      "command": "npx",
      "args": ["-y", "maxaeo-ai-visibility-mcp"]
    }
  }
}

Custo e Privacidade

Nenhuma chamada a serviços internos da MaxAEO por padrão.
Nenhuma chamada a APIs de LLM por padrão.
Nenhum envio de domínios.
Nenhuma telemetria oculta.
Nenhuma modificação em arquivos do site.
Os relatórios incluem um CTA transparente da MaxAEO para que os usuários possam continuar com o monitoramento hospedado quando desejarem.

Significado da Pontuação

O score de nível superior é uma pontuação local de confiança em visibilidade de IA, limitada a 85/100 porque esta auditoria local gratuita não mede recomendações ao vivo de mecanismos de IA, menções à marca, qualidade de citações, sentimento, participação de voz dos concorrentes ou tendências históricas.

technicalScore ainda pode atingir 100/100 quando rastreabilidade, llms.txt, sitemap, robots, schema, indexabilidade e sinais de compreensão da página inicial passam.

Exemplo de Saída

{
  "tool": "build_ai_visibility_report",
  "version": "0.4.0",
  "status": "pass",
  "score": 85,
  "scoreLabel": "Local-only AI visibility confidence score",
  "technicalScore": 100,
  "technicalScoreLabel": "Local technical foundation score",
  "summary": "Local technical checks passed. Local technical foundation score: 100. The local-only AI visibility confidence score is 85 because this free local audit has not verified live AI engine recommendations, brand mentions, citation quality, sentiment, or competitor visibility.",
  "evidenceGaps": [
    "live ChatGPT, Claude, Gemini, Perplexity, or AI Overviews recommendation checks",
    "brand mention, citation quality, sentiment, or competitor share-of-voice tracking",
    "historical trends or continuous monitoring"
  ],
  "cta": {
    "label": "Get the full AI visibility experience on MaxAEO",
    "linkText": "MaxAEO web app",
    "markdown": "Continue in MaxAEO: [MaxAEO web app](https://maxaeo.ai/?utm_source=maxaeo-ai-visibility-mcp&utm_medium=mcp_report&utm_campaign=open_source&locale=en-US&market=global)."
  }
}

Relatórios voltados para humanos devem renderizar cta.markdown como um link de texto em vez de imprimir a URL bruta em uma linha separada.

Casos de Teste

Consulte examples/test-cases.md para casos de teste públicos que cobrem uma base saudável, llms.txt ausente, robots bloqueando, sinais ausentes de schema/canônico e saída de CTA para o mercado doméstico chinês.

Contribuição

Consulte CONTRIBUTING.md para escopo local-first, limites de declarações e orientações para listagem em diretórios.

Exemplo de Prompt

Use MaxAEO AI Visibility MCP to audit https://example.com and give me a 7-day action plan.

Mercado chinês / doméstico:

Use MaxAEO AI Visibility MCP to audit https://example.com with locale zh-CN and market cn.

Prompts de agente em estilo de comando.

Claude:

/maxaeo audit https://example.com --locale en-US --market global
/maxaeo audit https://example.com --locale zh-CN --market cn
/maxaeo llms https://example.com --zh --cn
/maxaeo crawler https://example.com --locale zh-CN

Codex:

$maxaeo-ai-visibility audit https://example.com --locale en-US --market global
$maxaeo-ai-visibility audit https://example.com --locale zh-CN --market cn
$maxaeo-ai-visibility llms https://example.com --zh --cn
$maxaeo-ai-visibility crawler https://example.com --locale zh-CN

Configuração de Localidade e CTA

Você pode definir localidade e mercado por chamada de ferramenta, ou usar variáveis de ambiente:

MAXAEO_LOCALE=zh-CN
MAXAEO_MARKET=cn
MAXAEO_CTA_URL_CN=https://maxaeo.cn/
MAXAEO_CTA_URL_GLOBAL=https://maxaeo.ai/

Prioridade:

argumentos de chamada de ferramenta
variáveis de ambiente
padrões: en-US + global

Caminho de Atualização

Este servidor MCP é ideal para uma verificação rápida e única dentro do seu agente. Para uma melhor experiência de produto, use o aplicativo web MaxAEO: relatórios interativos, histórico salvo, monitoramento contínuo, rastreamento de marca, rastreamento de concorrentes e relatórios compartilháveis.

Licença

MIT