ReputeMap

ReputeMap MCP：面向 AI Agent 的 Google 评价管理

ReputeMap 的模型上下文协议服务。它为 Claude、Cursor、Cline、VS Code、 Codex、Gemini CLI 及任何其他 MCP 客户端提供你的 Google 商家资料评价：可筛选的评价收件箱（其中内嵌了商家回复）、按地点统计数据、AI 回复草稿、发布你批准的回复，以及如实的评价邀请邮件。

“显示上周所有未回复且低于 3 星的评价，按评分从低到高排列。” “用平和的语气，为最新的三条差评拟写回复。” “按原文发布 Riverside 评价的第二份草稿。” “我们刚完成 Henderson 一家的工作。给他们发送评价邀请。”

**你可能不需要运行任何东西。**该服务已托管：

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

注册表：com.reputemap/reputemap · 所有付费套餐均包含，从 Solo（每月 $19）起，并提供 14 天试用。

工具

共有七个工具：四个读取工具，三个操作工具。

工具	功能	类型	额度
list_locations	组织管理的所有地点，以及其他工具所需的地点 ID	只读	1
list_reviews	Google 评价，按时间从新到旧排列，并内嵌已发布的商家回复。可按地点、星级范围、仅未回复评价或最近 N 天筛选；每页最多 50 条，可通过 offset 分页。每条评价都包含 Google 对回复的审核状态（reply_state、reply_policy_violation）	只读	1
get_review_stats	按地点和组织整体统计：评价数量、平均评分、1–5★评分分布、未回复数量，以及滚动时间窗口内（默认为 30 天）的活动情况	只读	1
draft_reply	使用 ReputeMap 自有生成器，为一条评价拟写 2–3 个回复草稿，采用商家保存的语气和落款。可选提供一次性 instructions（例如“控制在 40 个词以内”）。将草稿保存到应用的编辑器，绝不发布	保存草稿	1
publish_reply	将用户批准的确切回复文本发布到 Google 上的评价中	发布到 Google	1
send_review_request	通过 ReputeMap 的营销活动引擎，向客户发送一封真实的评价邀请邮件	发送邮件	1
get_usage	本月额度使用量、限额和速率限制	只读	免费

工具带有 MCP 注解：四个读取工具带有 readOnlyHint；另外三个没有，且 publish_reply 还标记了 destructiveHint。这些信号会让客户端在运行工具前征求你的确认。

安全性：积极主动的 Agent 能做什么，不能做什么

• 只访问你的数据。 密钥只能访问你组织拥有的内容：其 门店、评价和统计数据。跨源浏览器调用会被拒绝。
• 起草不会发布。 draft_reply 会在 ReputeMap 中保存草稿。只有调用 publish_reply 或有人在应用中点击“发布”，内容才会发送到 Google。
• 发布需要你明确同意。 publish_reply 只会提交你批准的确切文本，不会提交其他内容。它会替换该评价上任何现有的商家回复，因此被标记为破坏性操作，而且每次发布都会记录在审计日志中。如果 Google 拒绝请求，文本会留在 ReputeMap 中，并提供手动处理选项（status: "manual_required"），因此你的文字永远不会丢失。
• Google 会审核商家回复，工具也会告知你结果。 publish_reply 会通过 google_state 返回状态：pending 表示 Google 正在检查回复，之后才会显示。status: "rejected_by_google" 表示 Google 不会显示该回复；policy_violation 和 detail 会说明原因，请撰写其他回复。 list_reviews 会在每条评价中包含相同状态；被拒绝的回复在 unanswered_only 筛选中会被视为没有回复。
• 退订优先。 send_review_request 会执行与应用内营销活动相同的退订和抑制检查。如果此门店已向该地址发送过请求，你会收到 status: "already_requested"：不会发送第二封邮件，并会退还额度。这仍然是一封发给真实用户的真实邮件，因此该操作会标记为非幂等，客户端也会先要求确认。
• 一键撤销。 密钥仅以哈希形式存储，且只会显示一次。撤销密钥后，访问权限会立即终止。

获取 API 密钥

1. 在 ReputeMap 中创建一个工作区，使用任意付费套餐，或使用 14 天试用（需要信用卡）。从这里开始。
2. 在应用中打开：Settings → API keys（所有者和管理员）。密钥以 rmk_ 开头，且只会显示一次。

然后选择下方的客户端。每个客户端都有两种接入方式：

• 远程（推荐）：客户端直接与 https://api.reputemap.com/mcp 通信，并通过 Authorization: Bearer 标头发送密钥。
• 本地 stdio 桥接程序：适用于只能启动本地程序的客户端。客户端运行 npx -y @reputemap/mcp（Node 18+），并设置 REPUTEMAP_API_KEY，桥接程序会将所有请求转发到托管端点。

各客户端的设置方法

Claude Code

远程方式，一条命令，无需重启：

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

手动编写 .mcp.json？请在条目中加入 "type": "http"。否则，Claude Code 会将该条目视为本地程序并运行失败。

也可以使用 stdio 桥接程序：

claude mcp add reputemap -e REPUTEMAP_API_KEY=rmk_YOUR_KEY -- npx -y @reputemap/mcp

Claude Desktop

在 claude_desktop_config.json 中使用 stdio 桥接程序（Settings → Developer → Edit Config），然后完全退出并重新打开应用。需要 Node.js 18+。

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

通用的 mcp-remote 桥接程序也可使用： "args": ["-y", "mcp-remote", "https://api.reputemap.com/mcp", "--header", "Authorization: Bearer rmk_YOUR_KEY"]。

Cursor

远程方式，配置在 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）中：

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

也可以使用 stdio 桥接程序：

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

Cline

打开 Cline → MCP Servers → Configure MCP Servers，这会打开 cline_mcp_settings.json，然后添加服务。远程方式：

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

也可以使用 stdio 桥接程序：

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

VS Code（Copilot Agent 模式）

在工作区的 .vscode/mcp.json 中配置。顶层键是 servers，不是 mcpServers。VS Code 会要求输入一次密钥并将其保存，因此密钥不会写入文件：

{
  "inputs": [
    { "type": "promptString", "id": "reputemap-key", "description": "ReputeMap API key (rmk_...)", "password": true }
  ],
  "servers": {
    "reputemap": {
      "type": "http",
      "url": "https://api.reputemap.com/mcp",
      "headers": { "Authorization": "Bearer ${input:reputemap-key}" }
    }
  }
}

也可以使用 stdio 桥接程序：将 reputemap 条目替换为 { "type": "stdio", "command": "npx", "args": ["-y", "@reputemap/mcp"], "env": { "REPUTEMAP_API_KEY": "${input:reputemap-key}" } }。

Windsurf

~/.codeium/windsurf/mcp_config.json。请注意，字段名是 serverUrl：

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

Codex CLI

编辑 ~/.codex/config.toml，然后在 shell 中导出 REPUTEMAP_API_KEY：

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

Gemini CLI

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

或者在 ~/.gemini/settings.json 中，将字段设为 httpUrl：

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

其他 MCP 客户端

URL:        https://api.reputemap.com/mcp
Transport:  Streamable HTTP (JSON-RPC 2.0 over POST)
Header:     Authorization: Bearer rmk_YOUR_KEY   (X-API-Key: rmk_YOUR_KEY also works)

目前尚不支持 ChatGPT：其连接器只接受 OAuth，而此服务使用 API 密钥。

**检查连接：**询问 “列出我的 ReputeMap 位置”。如果返回了 ID，就说明已连接。

额度与限制

• 每个组织每月 1,000 个额度点，所有套餐均相同，并与 REST API 共用。额度于每月 1 日重置。
• 除 get_usage 外，每次工具调用消耗 1 个额度点，get_usage 免费。参数格式错误的调用会在扣除额度前被拒绝；返回 already_requested 的 send_review_request 调用会退还额度。
• 每个组织每分钟 60 次请求。
• 额度用尽时，工具会返回 Agent 能读取的错误（“每月 API 额度已用尽”）。get_usage 会告知当前额度情况。

问题	原因与解决方法
401 API 密钥无效或缺失	有拼写错误，或密钥已撤销。在 Settings → API keys 中创建新密钥
403 … requires an active paid plan	工作区没有订阅。选择套餐；14 天试用也符合要求
"Monthly API credit limit reached"	额度于每月 1 日重置；检查 get_usage
Claude Desktop 未显示工具	npx 需要 Node.js 18+；编辑配置后，完全退出并重新打开应用

此仓库的内容

一个零依赖的 stdio 桥接程序，供通过 stdio 使用 MCP、且无法发送 HTTP 标头的客户端使用，提供两种版本：bin/cli.mjs（Node 18+，发布为 @reputemap/mcp）和 server.py（Python 3.9+，仅使用标准库）。两者都会通过 TLS 将每条 JSON-RPC 消息转发到托管端点，并将响应流式传回。桥接程序自身不维护工具列表，因此托管服务发布新工具后，你便能立即使用。

# 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 是发布到官方 MCP 注册表的清单，名称为 com.reputemap/reputemap。.plugin/plugin.json 和 .mcp.json 为支持插件的客户端描述同一服务。

桥接程序约 120 行，代码易于阅读，也说明了传输内容：你的 API 密钥只会放入发往 api.reputemap.com 的 TLS 请求的 Authorization 标头中。

协议说明

• 方法：initialize → notifications/initialized → tools/list / tools/call，以及 ping。支持的修订版本：2024-11-05、2025-03-26、2025-06-18、2025-11-25。
• 发现阶段（initialize、ping、tools/list）无需密钥即可响应，因此客户端和目录可以在你完成身份验证前显示工具目录。tools/call 始终需要密钥。
• 协议错误使用标准 JSON-RPC 错误代码。工具级错误（ID 无效、额度不足）会作为带有 isError: true 的工具结果返回，以便 Agent 读取并告知你。
• 服务无状态：仅支持 POST，不建立会话，也不会由服务端发起 SSE 流（GET 返回 405）。桥接程序仍会遵循 Mcp-Session-Id，并接受 JSON 和 SSE 格式的响应。
• 仅当客户端协商的修订版本早于 2025-06-18 时，才接受 JSON-RPC 批处理；该版本移除了批处理功能。带有外部 Origin 标头的请求会被拒绝。

链接

• reputemap.com：面向本地商家和代理机构的 Google 评价管理
• MCP 服务概览 · MCP 设置参考 · REST API 文档
• 配方（定时任务摘要、CRM 同步）：reputemap-com/examples
• 配套 Agent 技能：reputemap-com/review-skills（npx skills add reputemap-com/review-skills）
• LinkedIn · [email protected]

ReputeMap 是一款独立工具，与 Google 无关联。

许可证

MIT，详见 LICENSE。