Cited AI Visibility Check

Cited AI Visibility Check (servidor MCP)

Pergunte ao ChatGPT, Perplexity e Gemini as perguntas que seus clientes fazem, com busca web ao vivo ativada, e veja se eles recomendam seu negócio.
Por Cited, o rastreador de visibilidade em IA da Voreli AI.

---

cited-mcp é um servidor Model Context Protocol de código aberto. Adicione-o ao Claude Desktop, Claude Code, Cursor ou qualquer cliente MCP e pergunte algo como:

Verifique se os mecanismos de IA recomendam Sunshine Dental (sunshinedental.com) para perguntas sobre dentistas de família em Tampa, FL.

Para cada pergunta e mecanismo, ele informa:

• se o negócio foi mencionado na resposta
• sua posição se a resposta foi uma lista
• se o site foi citado como fonte
• quais concorrentes foram mencionados
• os domínios de origem que o mecanismo usou
• um custo estimado para a chamada, com base no uso de tokens a preços de tabela

Ferramenta

check_ai_visibility

Argumento	Obrigatório	Observações
business_name	sim	ex.: Sunshine Dental & Implants, LLC
website	não	ex.: sunshinedental.com. Usado para detectar citações das suas páginas.
questions	não	1 a 10 perguntas de compradores.
category	se não houver perguntas	ex.: family dentist. Gera 5 perguntas genéricas de compradores.
location	não	ex.: Tampa, FL. Usado nas perguntas geradas.
engines	não	Qualquer um de openai, perplexity, gemini. Padrão: todos os mecanismos com chave.

A correspondência de nomes ignora maiúsculas/minúsculas e pontuação, trata & e and como iguais, remove sufixos legais como LLC, Inc e Co, e também conta uma menção ao domínio do seu site. A citação do site corresponde ao domínio e seus subdomínios contra cada URL citada pelo mecanismo.

Instalação

Você fornece suas próprias chaves de API e paga cada provedor diretamente. Defina uma, duas ou as três; mecanismos sem chave são ignorados com uma nota.

Claude Desktop

Edite claude_desktop_config.json (Configurações, Desenvolvedor, Editar Config):

{
  "mcpServers": {
    "cited": {
      "command": "npx",
      "args": ["-y", "cited-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "PERPLEXITY_API_KEY": "pplx-...",
        "GEMINI_API_KEY": "..."
      }
    }
  }
}

Claude Code

claude mcp add cited -e OPENAI_API_KEY=sk-... -e PERPLEXITY_API_KEY=pplx-... -e GEMINI_API_KEY=... -- npx -y cited-mcp

Cursor

Adicione a ~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto):

{
  "mcpServers": {
    "cited": {
      "command": "npx",
      "args": ["-y", "cited-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "PERPLEXITY_API_KEY": "pplx-...",
        "GEMINI_API_KEY": "..."
      }
    }
  }
}

Qualquer outro cliente MCP funciona da mesma forma: execute npx -y cited-mcp via stdio com as chaves no ambiente. Node 20 ou mais recente.

Variáveis de ambiente

Variável	Mecanismo	Modelo padrão
OPENAI_API_KEY	ChatGPT via API OpenAI Responses com a ferramenta web_search	gpt-5.4-mini (substitua com OPENAI_MODEL)
PERPLEXITY_API_KEY	Perplexity Sonar (busca integrada)	sonar (substitua com PERPLEXITY_MODEL)
GEMINI_API_KEY	Gemini com Grounding com Google Search	gemini-3.5-flash-lite (substitua com GEMINI_MODEL)

As versões de API desses mecanismos são próximas, mas não idênticas, aos aplicativos de consumo. ChatGPT, Perplexity e Gemini no navegador podem usar modelos, personalização e sinais de localização diferentes.

Exemplo de saída

Este é o formato real de saída da ferramenta, executado contra as respostas de exemplo em test/fixtures, que seguem o formato de resposta documentado de cada provedor (os negócios são fictícios):

# AI visibility check: Sunshine Dental & Implants (sunshinedental.com)

- ChatGPT (OpenAI API): named in 1 of 1 answers, website cited in 1
- Perplexity: named in 0 of 1 answers, website cited in 0
- Gemini: named in 1 of 1 answers, website cited in 1

## "What is the best dentist in Tampa, FL?"
- ChatGPT (OpenAI API): NAMED, #2 of 3 listed, website cited
  - Named instead: Bayshore Smiles, Harbor Family Dentistry
  - Sources: bayshoresmiles.com, yelp.com, sunshinedental.com
- Perplexity: not named, website not cited
  - Named instead: Harbor Family Dentistry, Bayshore Smiles, Westshore Dental Group
  - Sources: yelp.com, bayshoresmiles.com, healthgrades.com
- Gemini: NAMED, #2 of 3 listed, website cited
  - Named instead: Westshore Dental Group, Bayshore Smiles
  - Sources: sunshinedental.com, yelp.com

Estimated provider cost: $0.0229. AI answers change from run to run, so treat one check as a snapshot, not a score. Costs are estimates from token usage at list prices; you pay your provider directly.

Track this weekly with Cited: https://cited.voreli.ai

A ferramenta também retorna os mesmos dados como JSON estruturado (structuredContent) para clientes que o utilizam.

Custo

Não há taxa da Cited nem conta. Cada pergunta é uma chamada de API por mecanismo, cobrada na sua conta do provedor a preços de tabela (verificados em outubro de 2026):

Mecanismo	O que você paga por pergunta
OpenAI gpt-5.4-mini	$10 por 1.000 chamadas de busca web, mais tokens a $0,75 por 1M de entrada e $4,50 por 1M de saída. Resultados de busca contam como tokens de entrada.
Perplexity sonar	$5 por 1.000 solicitações (contexto de busca baixo), mais tokens a $1 por 1M. A Perplexity informa o custo exato e a ferramenta o utiliza.
Gemini gemini-3.5-flash-lite	Consulte os preços atuais da API Gemini do Google (https://ai.google.dev/gemini-api/docs/pricing). A estimativa de custo mostra $0 para modelos sem preço integrado; verifique seu faturamento do Google para o valor real.

Na prática, isso é alguns centavos ou menos por pergunta por mecanismo, então uma verificação padrão (5 perguntas em 3 mecanismos, 15 chamadas) deve ficar bem abaixo de um dólar. Cada resultado inclui uma estimativa calculada a partir das contagens de tokens retornadas pelo provedor. Não inclui taxas de grounding do Gemini além da cota diária gratuita. Verifique o painel do seu provedor para o valor exato. Os preços mudam; consulte OpenAI, Perplexity e Gemini.

Executar uma verificação ao vivo

PERPLEXITY_API_KEY=your-key npm run live

Usa qualquer um de OPENAI_API_KEY, PERPLEXITY_API_KEY e GEMINI_API_KEY que estiver definido. Substitua o alvo com BUSINESS, WEBSITE, LOCATION e QUESTION. Uma única verificação custa alguns centavos.

Limitações

• As respostas variam de execução para execução. No nosso Tampa Bay AI Search Study 2026, perguntamos ao ChatGPT as mesmas 12 perguntas duas vezes. Em média, as duas respostas compartilharam 11% dos negócios mencionados, e em 6 das 12 perguntas não compartilharam nenhum. Uma verificação é um instantâneo. Tendências exigem verificações repetidas ao longo do tempo.
• A API não é o aplicativo. Os resultados aproximam o que as pessoas veem nos aplicativos de consumo; não são idênticos.
• Os nomes dos concorrentes são extraídos heuristicamente de itens de lista, títulos e texto em negrito. Espere algum erro ou frase solta. O trecho da resposta está incluído para que seu assistente possa lê-lo diretamente.
• A correspondência de nomes é aproximada, não mágica. Um apelido ou abreviação usada pelo mecanismo (por exemplo, "SDI" para Sunshine Dental & Implants) não corresponderá, a menos que você o passe como nome do negócio.
• Localização. Os mecanismos inferem a localização a partir do texto da pergunta, então coloque a cidade na pergunta.

Acompanhamento ao longo do tempo

Este servidor responde "somos mencionados hoje?". Cited executa as mesmas perguntas toda semana nos mecanismos, armazena o histórico e mostra quais concorrentes e fontes estão vencendo, para que você possa ver se seu trabalho está movendo o número.

Desenvolvimento

npm install
npm test          # unit tests against sample responses, no network
npm run typecheck
npm run build
npm run smoke     # spawns the server over stdio, lists tools, runs a no-key call

Para testar com o MCP Inspector: npx @modelcontextprotocol/inspector node dist/index.js.

Licença

MIT. Construído por Voreli AI. Perguntas ou ideias: abra uma issue ou visite cited.voreli.ai.