Vantage

Vantage

O Vantage é um servidor MCP de visibilidade de IA que verifica se ChatGPT, Gemini, Perplexity e Google AI Overviews citam o seu site.

Saiba se a IA realmente cita você: para quais perguntas, quem é citado no seu lugar e se isso está mudando. Chame-o diretamente do Claude Code, Cursor ou qualquer cliente MCP. Sem painel para interpretar, apenas uma resposta direta.

Experimente sem instalar nada

vantagemcp.dev/check executa uma verificação de citação real sem conta, sem e-mail e sem cartão. Dê uma palavra-chave e ele retorna o formato medido da resposta que o ChatGPT realmente cita para ela: se a resposta abre com uma lista, o tamanho da abertura, quantas fontes cita e quais domínios são essas fontes.

Cada resposta mantém uma página permanente, e todas estão listadas em check/sitemap.xml.

Publicado no Official MCP Registry sob o namespace verificado por domínio dev.vantagemcp/vantage.

Não confundir com: vantage.sh, uma empresa de gerenciamento de custos em nuvem com seu próprio servidor MCP não relacionado, também chamado Vantage. Produto diferente, mesmo nome.

Instalação

Se o seu cliente suporta login MCP (OAuth), adicione https://vantagemcp.dev/mcp sem chave e faça login: uma conta gratuita com seu e-mail ou uma chave existente. Caso contrário, adicione à configuração do seu cliente MCP:

{
  "mcpServers": {
    "vantage": {
      "url": "https://vantagemcp.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Se o seu cliente só inicia servidores como um comando local, use o pacote npm vantage-ai-visibility-mcp, que se conecta ao mesmo servidor hospedado:

{
  "mcpServers": {
    "vantage": {
      "command": "npx",
      "args": ["-y", "vantage-ai-visibility-mcp"],
      "env": { "VANTAGE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Experimente primeiro sem conta alguma em vantagemcp.dev/check, ou obtenha uma chave de API gratuita (30 unidades de cota por mês, sem cartão) em vantagemcp.dev.

Ferramentas

get_usage

Quanto da cota deste período de faturamento ainda resta, antes de gastar qualquer parte dela. Custa 0 unidades — lê o próprio registro do Vantage, nunca chama o provedor de dados pago.

"Quantas verificações ainda tenho?"

find_cited_questions

Começa pelo seu domínio em vez de uma palavra-chave: as perguntas em que as respostas de IA já o citam, das mais frequentes para as menos. 10 unidades.

"Pelo que o ChatGPT já nos cita?"

check_prompt_coverage

Quais de vários prompts realmente citam um domínio específico e quais não — até 10 palavras-chave em uma única chamada. ChatGPT, Gemini ou Perplexity (engine), 1 unidade por palavra-chave por amostra. Passe samples=3 para obter "citado em 2 de 3 respostas" em vez de um simples sim ou não. Cada resultado é lembrado por 180 dias, então a próxima verificação informa o que mudou (previous, change, newly_cited).

Citado e nomeado são relatados separadamente. Uma resposta pode nomear sua marca sem linkar você (mentioned_not_cited: o modelo já conhece você, só não está citando) ou linkar uma página que nunca nomeia. Passe brand (ex.: "Notion") para que a verificação de nome procure sua marca real em vez de uma suposição baseada no domínio.

"De tudo o que nos importa, onde já aparecemos?"

get_check_history

Seus resultados anteriores de check_prompt_coverage para um domínio, do mais recente ao mais antigo. 0 unidades.

"Nossas mudanças da semana passada moveram algo?"

find_citation_leaders

Quem domina as citações em respostas de IA para um tópico e se um domínio está entre eles.

"Quem está vencendo a busca por IA nisso?"

analyze_citation_trend

Contagens de menções mês a mês para um domínio, para você ver se a visibilidade está crescendo ou diminuindo.

"Nossa visibilidade em IA está melhorando?"

analyze_citation_structure

Como a resposta vencedora de IA para um tópico é realmente formatada: liderada por lista, fontes citadas, tamanho da abertura.

"Como é uma resposta vencedora?"

analyze_citation_structure_batch

Igual ao analyze_citation_structure, em até 10 tópicos relacionados em uma única chamada, para planejamento de conteúdo em um cluster.

"Como são as respostas vencedoras em todo este cluster de tópicos?"

analyze_citation_gap

Compara a estrutura da sua própria página com a resposta vencedora citada por IA para a mesma palavra-chave e retorna um fix_brief: instruções ordenadas de reescrita que seu agente pode executar na página (abertura, seções, os pontos da resposta que sua página não cobre, tabela, fontes), terminando com um passo além da página: quais sites comunitários ou outros sites a resposta utiliza. O briefing nunca contém o texto da resposta citada.

"O que devo realmente mudar nesta página para ser citado?"

Mix de fontes

Toda ferramenta que retorna domínios citados também retorna source_mix: quanto deles são sites comunitários (Reddit, YouTube, X, Quora e similares) e quais. Uma parcela alta significa que o tópico é vencido pelo que as pessoas dizem sobre uma marca em outros lugares, não pelas páginas de um único site.

País e idioma

Toda ferramenta, exceto get_usage, aceita country opcional (ex.: "Italy") e language (ex.: "it"), padrão Estados Unidos / en. Ferramentas que leem uma resposta ao vivo do ChatGPT funcionam em qualquer mercado suportado; find_citation_leaders e analyze_citation_trend só têm dados do ChatGPT para os Estados Unidos em inglês, então use platform: "google" para outros países.

Exemplo

> agent calls find_citation_leaders(
  keyword: "best mood tracker app",
  platform: "chat_gpt"
)

< response
{
  "keyword": "best mood tracker app",
  "platform": "chat_gpt",
  "top_domains": [
    { "domain": "www.reddit.com", "mentions": 59 },
    { "domain": "apps.apple.com", "mentions": 55 },
    { "domain": "en.wikipedia.org", "mentions": 49 },
    { "domain": "www.makeuseof.com", "mentions": 12 },
    { "domain": "play.google.com", "mentions": 11 }
  ]
}

Executando sua própria instância

Este repositório é o próprio servidor MCP: autenticação por chave de API, medição de uso, uma ferramenta por leitura (veja Ferramentas acima). Faturamento e provisionamento de contas são um serviço interno separado, não incluído aqui.

uv pip install -e .
export DATAFORSEO_USERNAME=...
export DATAFORSEO_PASSWORD=...

# stdio (local MCP client, e.g. Claude Desktop config pointing at this command)
python -m vantage_mcp.server

# streamable-http (network service, bind to loopback behind your own reverse proxy)
export VANTAGE_PORT=8420
python -m vantage_mcp.server --http

Requer uma conta DataForSEO para os dados subjacentes de SERP/respostas de IA.

Licença

MIT