MentionsAPI

Verifique se a IA recomenda sua marca — menções, classificações e citações no ChatGPT, Claude, Gemini, Perplexity, AI Overviews, AI Mode e Bing Copilot.

Documentação

Servidor MCP MentionsAPI

npm version MIT License

Pergunte ao seu agente de IA se a IA recomenda sua marca. MentionsAPI rastreia a visibilidade da marca em todas as superfícies de busca de IA — ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews, Google AI Mode e Bing Copilot — e este servidor MCP coloca esses dados dentro de qualquer cliente compatível com MCP.

Pergunte em linguagem natural. Receba dados estruturados de volta.

You: "Is HubSpot mentioned when users ask ChatGPT about CRMs?"
Claude: [calls mentions_check via MCP]
        "Yes — ranked 3rd in ChatGPT's answer. Top 3:
         HubSpot, Salesforce, Pipedrive. Fan-out queries
         issued during search: ..."

Duas formas de conectar

Opção 1 — Servidor remoto (recomendado, zero instalação)

https://api.mentionsapi.com/mcp — HTTP Streamable com OAuth (um clique no claude.ai) ou Authorization: Bearer lvk_live_....

  • claude.ai / Claude Desktop: Configurações → Conectores → Adicionar conector personalizado → cole a URL acima e aprove via OAuth.

  • Claude Code:

    claude mcp add --transport http mentionsapi https://api.mentionsapi.com/mcp
    
  • Qualquer cliente Streamable-HTTP: aponte para a URL e envie sua chave de API como token Bearer.

Opção 2 — Servidor stdio local (npm)

npx -y @mentionsapi/mcp@latest

Claude Code (~/.claude.json)

{
  "mcpServers": {
    "mentionsapi": {
      "command": "npx",
      "args": ["-y", "@mentionsapi/mcp@latest"],
      "env": { "MENTIONSAPI_KEY": "lvk_live_..." }
    }
  }
}

Cursor (~/.cursor/mcp.json) — mesma estrutura

Windsurf (~/.codeium/windsurf/mcp_config.json) — mesma estrutura

ChatGPT Plus — veja docs/mcp/chatgpt-plus


Comece em 60 segundos

  1. Cadastre-se — grátis, sem cartão, $1 de crédito grátis → https://mentionsapi.com/signup
  2. Gere uma chave de API (parece com lvk_live_...) → https://mentionsapi.com/app/keys
  3. Conecte usando qualquer uma das opções acima
  4. Pergunte: "Use mentions_check para ver se a Notion aparece para 'melhor CRM para startups' em todos os 4 LLMs."

Ferramentas (4)

FerramentaO que fazModo mais barato
mentions_checkVerifica se uma marca é mencionada nas superfícies de busca de IA$0,02 (mode:quick, em cache)
mentions_watchMonitoramento persistente com webhook assinado por HMAC em alterações$1/execução
mentions_discoverSugere 50 consultas para rastrear uma marca$0,50
mentions_compareComparação lado a lado entre duas marcas$1,50

8 modos para mentions_check

ModoCustoO que faz
quick$0,39 novo / $0,02 em cacheTodas as 4 APIs de LLM em paralelo — ChatGPT, Claude, Gemini, Perplexity
perplexity_live$0,25Raspagem real da interface do Perplexity — citações + consultas de expansão
chatgpt_live$0,10Raspagem real da interface do ChatGPT — expansão + entidades de marca
gemini_live$0,10Raspagem real da interface do Gemini
ai_overview$0,05Bloco AI Overviews do Google
ai_mode$0,10AI Mode dedicado do Google
bing_copilot$0,05Visão geral de IA do Bing Copilot
all_live$0,50Todas as 6 raspagens de interface ao vivo em uma única chamada

Preços

Somente PAYG. Sem assinaturas, sem mínimos mensais.

  • $1 de crédito grátis no cadastro — sem necessidade de cartão
  • Recarga mínima de $5 — Stripe Checkout, cartão salvo
  • Recarga automática opcional quando a carteira estiver baixa

Recarregar: https://mentionsapi.com/app/billing


Variáveis de ambiente (servidor stdio)

VariávelObrigatóriaPadrão
MENTIONSAPI_KEYSim—
MENTIONSAPI_URLNãohttps://api.mentionsapi.com

Tratamento de erros

O MCP retorna erros estruturados que o agente de IA pode repassar a você em linguagem natural:

  • auth_required — nenhuma chave de API definida; inclui URL de cadastro
  • auth_invalid — chave rejeitada; gire em /app/keys
  • insufficient_balance — carteira vazia; URL de recarga incluída
  • rate_limit_exceeded — inclui retry_after_seconds
  • mode_roadmap — para deep/change_track (Q3 2026)

O servidor inicia mesmo sem chave de API — seu agente de IA vai guiá-lo pela configuração na primeira vez que você chamar uma ferramenta.


Habilidades do agente

Prefere habilidades em vez de ferramentas brutas? Instale o pacote de habilidades complementar:

npx skills add nikhonit/llm-mentions-skills

→ https://github.com/nikhonit/llm-mentions-skills


Documentação e links


Licença

MIT