shruwd-mcp

shruwd-mcp

一个用于 Shruwd 的本地 MCP 服务。 它让 AI Agent（Claude Desktop、Claude Code、Cursor，以及任何支持 MCP 的工具） 能够设置品牌、添加要跟踪的提示词和竞争对手、查看品牌在 AI 生成的回答中的呈现情况， 并根据诊断结果采取行动。

你需要从 Shruwd 控制台（Account → API keys）获取 API 密钥。此密钥绑定到一个工作区， 并可访问其中的品牌：如果你拥有该工作区，则可访问所有品牌；否则只能访问你作为成员的品牌。 密钥按你在各品牌上的角色执行操作：读取需要 viewer，写入需要 editor，生成摄取令牌需要 admin；创建或归档品牌需要所有者权限。要跨多个工作区操作，请在每个工作区中生成一个密钥，并为每个工作区添加一条服务配置。

托管服务，无需安装

相同的工具可通过 https://shruwd.io/mcp 运行（Streamable HTTP）。在 Claude.ai、ChatGPT 或 Grok 中，将该 URL 添加为自定义连接器，然后使用 Shruwd 账户登录；无需密钥。支持设置请求头的客户端也可以改用密钥：

claude mcp add --transport http shruwd https://shruwd.io/mcp --header "Authorization: Bearer sh_live_…"

各应用的设置说明：shruwd.io/docs/api/mcp-server。

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

Claude Code

claude mcp add shruwd -e SHRUWD_API_KEY=sh_live_… -- npx -y shruwd-mcp

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

工具

工具	说明
shruwd_get_workspace	套餐、权益、用量和品牌。从这里开始。
shruwd_list_brands · shruwd_get_brand · shruwd_create_brand · shruwd_update_brand · shruwd_archive_brand	品牌。创建品牌时也会创建其自身实体和首次测量。创建和归档需要 owner 权限。
shruwd_list_prompts · shruwd_add_prompts · shruwd_update_prompt · shruwd_remove_prompt	每个周期向各引擎提出的问题，以及你网站上应回答每个问题的页面。
shruwd_list_entities · shruwd_add_competitor · shruwd_set_entity · shruwd_remove_entity	品牌及其竞争对手，以及用于统计提及的确切别名。
shruwd_run_measurement · shruwd_list_cycles	立即进行测量；查看周期进度。结果会在接下来数小时内陆续生成。
shruwd_get_visibility · shruwd_get_visibility_series · shruwd_get_crawlers	提及率和市场声量份额及其区间，包括当前值和每个周期结束时的值；已验证的 AI 爬虫活动。
shruwd_list_crawler_paths	各爬虫抓取了哪些路径以及抓取结果：查看机器人错误的来源。
shruwd_list_answers	最新的单条回答：品牌是否被提及及其排名、被提及的竞争对手、引用的页面。可筛选到某个提示词（某项发现的 subjectRef）或某个引擎。这是证据，而非指标。
shruwd_list_suggestions · shruwd_accept_suggestion · shruwd_dismiss_suggestion	回答中提到但品牌尚未跟踪的竞争对手。
shruwd_suggest_setup	起草 10 到 25 条提示词，每条都附有应回答该问题的页面，并从主页和站点地图中推荐最多六个竞争对手。使用常规工具添加之前，不会保存任何内容。
shruwd_list_findings · shruwd_get_finding · shruwd_transition_finding	诊断问题并提供具体修复方案；标记修复已完成即可开始重新检查。受套餐限制的结果会将其余项目以 locked 数量返回。
shruwd_create_ingest_token	用于传输服务器日志的令牌和端点。需要 admin 权限。

每个工具返回的内容与 API 返回的内容完全一致。指标绝不会是没有说明的数字：每项指标都包含点估计及其 95% 区间和 n，或者明确标记为 insufficient_data 状态；工具说明会提醒 Agent 不要将其视为零。限制可见发现数量的套餐会将其余项目报告为 locked 数量，而不会隐藏它们的存在。

环境变量

变量
SHRUWD_API_KEY	必需。
SHRUWD_API_URL	可选。默认为 https://shruwd.io/api/v1。