ReputeMap

Gerencie avaliações do Google Business Profile pelo seu cliente de IA: uma caixa de entrada de avaliações filtrável, estatísticas por local e campanhas honestas de solicitação de avaliações.

GitHubExperimente este MCPPatrocinado

Documentação

ReputeMap MCP — Gerenciamento de avaliações do Google para agentes de IA

A superfície do Model Context Protocol do ReputeMap: avaliações do Google Business Profile — uma caixa de entrada de avaliações filtrável, estatísticas por local e campanhas honestas de solicitação de avaliações — para Claude, Cursor, Codex, Gemini CLI e qualquer outro agente compatível com MCP.

"Mostre-me todas as avaliações sem resposta com menos de 3 estrelas da última semana, das piores primeiro." "Rascunhe respostas para as três avaliações negativas mais recentes em um tom calmo." "Acabamos de concluir o trabalho dos Hendersons — envie a eles uma solicitação de avaliação."

Você provavelmente não precisa executar nada. O servidor está hospedado:

https://api.reputemap.com/mcp          Streamable HTTP · JSON-RPC 2.0
Authorization: Bearer rmk_YOUR_KEY     app.reputemap.com → Settings → API keys

Registro: com.reputemap/reputemap · qualquer plano pago (o teste gratuito de 14 dias conta).

Configuração por cliente

Claude Code — um comando, sem reiniciar:

claude mcp add --transport http reputemap https://api.reputemap.com/mcp \
  --header "Authorization: Bearer rmk_YOUR_KEY"

Cursor — .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "reputemap": {
      "url": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

Claude Desktop — claude_desktop_config.json, depois reinicie o aplicativo completamente:

{
  "mcpServers": {
    "reputemap": {
      "command": "npx",
      "args": ["-y", "@reputemap/mcp"],
      "env": { "REPUTEMAP_API_KEY": "rmk_YOUR_KEY" }
    }
  }
}

VS Code (modo agente do Copilot) — .vscode/mcp.json:

{
  "servers": {
    "reputemap": {
      "type": "http",
      "url": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json (o campo é serverUrl):

{
  "mcpServers": {
    "reputemap": {
      "serverUrl": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

Codex CLI — ~/.codex/config.toml, depois exporte REPUTEMAP_API_KEY:

[mcp_servers.reputemap]
url = "https://api.reputemap.com/mcp"
bearer_token_env_var = "REPUTEMAP_API_KEY"

Gemini CLI — ~/.gemini/settings.json (o campo é httpUrl):

{
  "mcpServers": {
    "reputemap": {
      "httpUrl": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer rmk_YOUR_KEY" }
    }
  }
}

ChatGPT — Configurações → Conectores → crie um conector personalizado (modo Desenvolvedor), aponte-o para https://api.reputemap.com/mcp e escolha autenticação por chave de API, depois cole sua chave.

Tutoriais completos com capturas de tela: reputemap.com/docs/mcp. Mais receitas (resumos por cron, sincronização com CRM): reputemap/examples. Habilidades de agente complementares: reputemap/review-skills (npx skills add reputemap/review-skills).

O que há neste repositório

Uma ponte stdio sem dependências para clientes que falam MCP via stdio e não conseguem enviar cabeçalhos HTTP — em duas versões: bin/cli.mjs (Node 18+, publicado como @reputemap/mcp) e server.py (Python 3.9+, apenas stdlib). Ambas encaminham cada mensagem JSON-RPC para o endpoint hospedado via TLS e transmitem as respostas de volta.

# Node — one-liner, no install
REPUTEMAP_API_KEY="rmk_..." npx -y @reputemap/mcp

# Python — no dependencies
REPUTEMAP_API_KEY="rmk_..." python3 server.py

server.json é o manifesto publicado no registro oficial do MCP como com.reputemap/reputemap.

Com cerca de 120 linhas legíveis, a ponte também serve como referência para o que trafega pela rede: sua chave de API vai apenas no cabeçalho Authorization das solicitações TLS para api.reputemap.com — nada mais, em nenhum outro lugar.

Ferramentas

Ferramenta	O que faz	Créditos
`list_locations`	Todos os locais que a organização gerencia, com IDs	1
`list_reviews`	Avaliações, filtráveis (local, faixa de classificação, sem resposta, últimos N dias) — inclui o texto da resposta publicada	1
`get_review_stats`	Por local + totais: contagens, classificação média, detalhamento de 1 a 5, sem resposta, atividade na janela recente	1
`send_review_request`	Envia um e-mail real de solicitação de avaliação pelo mecanismo de campanha (respeita opt-outs; idempotente)	1
`get_usage`	Uso de créditos do mês atual	grátis

Os créditos acompanham todos os planos do ReputeMap (1.000/mês, compartilhados com a REST API); get_usage é gratuito e informa sua situação. Limite de taxa: 60 solicitações/minuto por organização.

A única ação de escrita — send_review_request — passa pelo mesmo mecanismo de supressão/opt-out das campanhas no aplicativo, então um agente exagerado não pode enviar spam aos seus clientes. As ferramentas possuem anotações MCP (readOnlyHint/destructiveHint), e a descoberta (initialize, tools/list) funciona sem chave, para que os clientes possam exibir o catálogo antes de você autenticar. Revogue a chave a qualquer momento e o acesso morre instantaneamente.

Notas do protocolo

Métodos: initialize → notifications/initialized → tools/list / tools/call. Erros de protocolo usam códigos JSON-RPC padrão; erros no nível da ferramenta (ID inválido, sem créditos) retornam como resultados de ferramenta que seu agente pode ler.
O servidor não tem estado — nenhuma sessão é necessária; a ponte ainda respeita Mcp-Session-Id e aceita respostas tanto em JSON quanto em quadros SSE.
Solicitações em lote são rejeitadas (removidas no MCP 2025-11-25); cabeçalhos Origin estrangeiros são recusados.

Licença

MIT — veja LICENSE.