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
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
- Cadastre-se — grátis, sem cartão, $1 de crédito grátis → https://mentionsapi.com/signup
- Gere uma chave de API (parece com
lvk_live_...) → https://mentionsapi.com/app/keys - Conecte usando qualquer uma das opções acima
- Pergunte: "Use mentions_check para ver se a Notion aparece para 'melhor CRM para startups' em todos os 4 LLMs."
Ferramentas (4)
| Ferramenta | O que faz | Modo mais barato |
|---|---|---|
mentions_check | Verifica se uma marca é mencionada nas superfícies de busca de IA | $0,02 (mode:quick, em cache) |
mentions_watch | Monitoramento persistente com webhook assinado por HMAC em alterações | $1/execução |
mentions_discover | Sugere 50 consultas para rastrear uma marca | $0,50 |
mentions_compare | Comparação lado a lado entre duas marcas | $1,50 |
8 modos para mentions_check
| Modo | Custo | O que faz |
|---|---|---|
quick | $0,39 novo / $0,02 em cache | Todas as 4 APIs de LLM em paralelo — ChatGPT, Claude, Gemini, Perplexity |
perplexity_live | $0,25 | Raspagem real da interface do Perplexity — citações + consultas de expansão |
chatgpt_live | $0,10 | Raspagem real da interface do ChatGPT — expansão + entidades de marca |
gemini_live | $0,10 | Raspagem real da interface do Gemini |
ai_overview | $0,05 | Bloco AI Overviews do Google |
ai_mode | $0,10 | AI Mode dedicado do Google |
bing_copilot | $0,05 | Visão geral de IA do Bing Copilot |
all_live | $0,50 | Todas 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ável | Obrigatória | Padrão |
|---|---|---|
MENTIONSAPI_KEY | Sim | — |
MENTIONSAPI_URL | Não | https://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 cadastroauth_invalid— chave rejeitada; gire em /app/keysinsufficient_balance— carteira vazia; URL de recarga incluídarate_limit_exceeded— incluiretry_after_secondsmode_roadmap— paradeep/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
- Início rápido — https://mentionsapi.com/docs/quickstart
- Referência da API — https://mentionsapi.com/docs/api/check
- Guias de configuração do MCP — https://mentionsapi.com/docs/mcp
- Receitas — https://mentionsapi.com/docs/recipes
- Política de privacidade — https://mentionsapi.com/legal/privacy
Licença
MIT