Watchr

Watchr MCP 服务

将竞争情报和品牌监测带入你的 AI 助手。询问 Claude、Cursor 或任何兼容 MCP 的客户端，了解竞争对手本周的动态。答案直接来自你的 Watchr 工作区。

Watchr 是一个竞争情报和品牌监测平台。它会监测竞争对手的网站、广告、社交媒体帖子、新闻及其他来源，然后根据你定义的提示词对每条信号进行筛选，让你看到的是相关动态，而非噪声。

此仓库介绍 Watchr 官方的 Model Context Protocol（MCP）服务。它提供限定账户范围的数据访问和受控的账户工作流。API 密钥提供只读访问权限；经授权的 OAuth 管理员还可以配置监测列表、管理成员、记录反馈并管理账户标签。

该服务由 Watchr 托管。无需本地安装，也无需 Docker。只需将客户端指向 https://mcp.watchr.ai/mcp 并完成身份验证即可。根据客户端不同，有两种接入方式：

• Claude（Desktop / Code）、ChatGPT、Cursor 以及任何支持 Dynamic Client Registration 的其他客户端均可使用一键 OAuth。打开浏览器，批准授权，即可完成。
• 个人 API 密钥（在 Watchr 工作区中生成）适用于 Agent 框架和自定义集成，你可以将 MCP 嵌入自己的自动化技术栈中。

---

目录

• 可以用它做什么
• 演示
• 可用工具
• 洞察响应规范
• 开始使用 Watchr
• 身份验证
  • 选项 A：一键 OAuth
  • 选项 B：个人 API 密钥
• 配置
  • OAuth 客户端
  • API 密钥客户端
• 改善结果
• 支持

---

可以用它做什么

连接后，你可以向 AI 助手提出这类问题：

• “我们的竞争对手本周推出了什么产品？”
• “起草一条 Slack 消息，总结本月最重要的 5 条竞争洞察。”
• “比较过去 30 天内我们跟踪的各个品牌在市场定位上的变化。”
• “为我制作一页关于 HubSpot 的竞争简报，涵盖上个月的情况，并做成可视化内容。”
• “自动使用本周的 Watchr 洞察更新我的 Notion 竞争对手应对卡片和竞争对手概览页面。”

MCP 服务提供数据；助手负责推理、起草内容，并将结果集成到工作流的其他部分。

演示

下面是 Claude 通过 Watchr 获取 HubSpot 最新动态的一段简短对话：

相同的数据，只需再追问一次。Claude 就会直接根据经过验证的 Watchr 洞察，生成一份经过设计的竞争简报：

这就是核心工作流程。Watchr 负责收集和筛选。你的 AI 客户端负责推理和输出。MCP 服务负责将两者连接起来。

可用工具

默认端点提供 37 个工具，包括读取和写入工具。专用的 ChatGPT 配置提供 62 个工具，并为配置预览和应用操作分别提供独立命名的工具。运行时的 tools/list 是工具参数、架构和权限的权威依据。

工具	用途
list_monitoring_groups	列出你有权访问的所有监控组（观察列表）。每个组包含一个或多个受跟踪的品牌，以及一条用于定义相关内容的自定义筛选提示词。
list_brands	列出监控组中受跟踪的竞争品牌。搜索前可用此工具确认品牌名称。
search_insights	使用筛选条件（品牌、日期范围、来源类型、自由文本）搜索经过验证的洞察。返回精简列表，方便判断要打开哪些洞察。
get_insight	按 ID 获取单条洞察的完整内容：来源 URL、原始内容、截图、筛选理由、日期，以及相关条目（如有）。
list_reports	列出从监控组发送的报告。
get_report	获取单份报告的完整内容：叙述、包含的洞察、收件人、发送日期。
get_workspace_context	查看角色、凭据权限范围、有效权限和账户限制。
list_watchr_documentation	查找产品指南和支持的功能。
get_watchr_guide	阅读选定的产品指南。
get_monitoring_configuration	查看品牌、来源、目标、相关性和报告设置。
diagnose_monitoring	查看配置诊断信息，以及可用时记录的报告计数器。
preview_monitoring_changes	保存有范围限制的配置预览，但不应用更改。
apply_monitoring_changes	应用经过精确批准的预览，并重新检查权限和使用资格。
get_operation_status	查看操作进度、待确认事项或部分失败情况。
set_report_email_delivery	预览报告生成和邮件投递的组合设置。
list_workspace_members	查看账户成员和待处理邀请。
invite_workspace_member	使用明确授权的角色邀请成员。
revoke_workspace_invitation	撤销明确指定的待处理邀请。
update_workspace_member_role	更改成员角色，同时保护最后一位管理员。
remove_workspace_member	移除成员访问权限，并撤销相应连接。
list_insight_tags	查看账户标签目录、定义和版本。
check_insight_tag	验证拟议标签，并在不保存的情况下显示重叠警告。
save_insight_tag	创建、编辑、归档或重新启用账户标签。
update_insight_tags	为有范围限制的一批洞察添加、移除或替换标签。
get_insight_tags	查看所选洞察的标签、手动排除项和分类状态。
get_insight_tag_history	查看有范围限制的标签更正和分类审计记录。
create_insight_tag_job	使用 ID 和预算限制，准备明确指定的分类任务。
run_insight_tag_job	在限制范围内，最多通过一次外部模型调用推进任务。
get_insight_tag_job	查看任务进度和预留预算，但不运行任务。
list_watchr_skills	查找打包的方法及其资源文件。
get_watchr_skill	阅读打包的技能文件。
search_signals	搜索限定于观察列表的主题并同步其变更。
get_signal	查看带有分页来源和报告引用的主题。
search_rejected_insights	搜索保留的单条拒绝来源及其原因。
get_rejected_insight	查看有权访问的保留拒绝项及其原始证据。
record_insight_feedback	记录明确的相关性、同名异义或重复判断，但不隐藏来源。
list_insight_feedback	查看已记录的判断及其来源信息。
集合支持其文档说明的分页和筛选条件。配置采用先持久化预览、再明确批准后应用的流程。读取需要 mcp:read；配置和标签写入还需要 mcp:configure；成员管理需要 mcp:members:manage。当前角色和权限会在服务端检查。API 密钥仍为只读。

预览不会启动采集、发送邮件或应用更改。某些应用操作会启动外部发现或采集。标签定义不会重新分类历史记录：分类任务需明确触发，并设有范围和预算限制，且默认保留手动修正。记录的相关性反馈不会改变资格判定，也不会执行重放。

新建的 MCP 监控列表默认禁用报告准备和邮件发送。这两种操作共用一个设置；禁用该设置不会停止采集。现有报告偏好设置会保留。

洞察响应约定

search_insights 返回精简的发现数据。每个条目都包含 id、标题、事实摘要、来源和品牌元数据，以及 effective_date。随附的 date_type 会说明该有效日期是来源的发布日期（published），还是 Watchr 的检测日期（detected）。因此，即使网站变更没有发布日期，也能安全地标注日期。

搜索响应会有意省略原始 description、qualification_analysis、原始日期和 related_items。这样可让结果页面保持精简，方便 AI 客户端对结果排序并筛选候选项，同时避免将上下文窗口耗费在可能用不到的来源文本上。

如果条目的标题或摘要不够清晰，请在回答前使用返回的 id 作为 insight_id 调用 get_insight。get_insight 会提供来源描述、资格判定依据、发布日期和检测日期，以及任何相关的已验证洞察。使用方不应仅凭精简摘要推断缺失的细节。

search_signals 和 get_signal 会公开监控列表范围内的主题、来源关联和已记录的报告展示情况。competitive_signal_id 是旧版的共享分组提示，不是权威的主题标识。若未记录结构，可能无法获取历史报告展示情况。已存储的快照时间戳并不能证明实际截图的拍摄时间。

开始使用 Watchr

在 MCP 服务能返回有用内容之前，你需要先配置好 Watchr 工作区。完整流程如下：

1. 在 watchr.ai/signup 创建账户。提供免费版。
2. 在 watchr.ai/app/settings 完成设置：
   • 添加你想跟踪的品牌和竞争对手
   • 指定你要监控的市场（用于评估相关性）
   • 订阅你想纳入的新闻简报和新闻源
   • 添加你想让 Watchr 监控变更的页面（价格、更新日志、招聘信息等）
   • 添加要抓取的社交媒体资料（LinkedIn、Facebook、Instagram）
3. 等待首次收集到洞察。报告准备和发送取决于监控列表设置；请求聊天摘要不会启用定期报告。
4. 连接 MCP 服务（参见身份验证和配置），然后通过任意 AI 客户端查询你的洞察。

身份验证

默认端点为 https://mcp.watchr.ai/mcp。专用的 ChatGPT 配置使用 https://mcp.watchr.ai/mcp/chatgpt。根据客户端不同，有两种身份验证方式。

选项 A：一键 OAuth

采用 Dynamic Client Registration（RFC 7591）和 PKCE 的标准 OAuth 2.1。客户端会自行注册、打开浏览器窗口，你授权 Watchr 访问后，客户端会自动存储令牌。无需复制粘贴，也无需手动轮换。

以下 OAuth 客户端可以使用上述授权流程：

• Claude Desktop
• Claude Code
• ChatGPT，使用专用端点以及该账户可用的连接器／插件设置
• Cursor（近期版本）

如果你的客户端在此列表中，请直接跳转到 OAuth 客户端。无需生成密钥。

选项 B：个人 API 密钥

对于 Agent 框架、自定义集成、脚本、Windsurf、VS Code 扩展，或任何不支持 OAuth 的客户端，Watchr 会签发以 wat_mcp_ 开头的长期 API 密钥。

生成密钥：

1. 在 watchr.ai 登录
2. 前往工作区中的 Integrations → MCP
3. 点击 Create API key
4. 为密钥设置一个便于识别的名称（例如 "我的 LangGraph Agent"、"Windsurf，工作笔记本电脑"），还可以选择设置到期日期
5. 立即复制密钥。Watchr 只会显示一次完整密钥。仪表板只存储前缀和哈希值，因此丢失的密钥无法找回（请撤销并重新生成）。

在每个请求中将密钥作为 Bearer 令牌传递：

Authorization: Bearer wat_mcp_<your-key>

大多数 MCP 客户端都允许你通过配置中的 headers 字段声明此项。示例见 API 密钥客户端。

几点安全提示：

• 像对待密码一样保护密钥。只读不代表风险低：它可以访问你所有的竞争情报。
• 每台设备或每个集成都使用一个密钥，并设置清晰的名称。如果笔记本电脑遗失，请前往 Integrations → MCP 撤销并重新签发密钥。
• 对 CI 或共享环境中的密钥设置到期日期。
• 密钥继承你账户的访问权限，涵盖账户中的所有活跃监控组。

还没有 Watchr 账户？免费创建一个。

配置

OAuth 客户端

对于以下所有客户端，服务 URL 均为 https://mcp.watchr.ai/mcp，并会在首次连接时自动触发身份验证。

Claude Desktop

编辑 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "watchr": { "url": "https://mcp.watchr.ai/mcp" }
  }
}

重启 Claude Desktop。Watchr 会显示在连接器面板中。点击它以完成 OAuth 授权。

Claude Code

claude mcp add --transport http watchr https://mcp.watchr.ai/mcp

然后在 Claude Code 中运行 /mcp，并点击 Watchr 旁边的 Authenticate。

ChatGPT

Settings → Connectors → Add custom connector：

• MCP 服务 URL：https://mcp.watchr.ai/mcp
• 身份验证：OAuth

ChatGPT 会在首次使用时触发 OAuth 流程。

Cursor

Settings → MCP → Add new MCP server：

{
  "watchr": { "url": "https://mcp.watchr.ai/mcp" }
}

API 密钥客户端

首先生成 API 密钥，然后在客户端配置中将其作为 Bearer 令牌传递。

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "watchr": {
      "serverUrl": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

VS Code

添加到 .vscode/mcp.json（或用户设置）：

{
  "servers": {
    "watchr": {
      "type": "http",
      "url": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

Cursor（不使用 OAuth）

JSON 结构与 OAuth 版本相同，但需添加 headers 块：

{
  "watchr": {
    "url": "https://mcp.watchr.ai/mcp",
    "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
  }
}

自定义 Agent 框架

LangGraph、CrewAI、Mastra、n8n、自定义 Python 或 TypeScript Agent 等。通过可流式传输的 HTTP 连接到 https://mcp.watchr.ai/mcp，并在每个请求中附加标头 Authorization: Bearer wat_mcp_<your-key>。任何兼容 MCP 的 SDK 均可使用。

改善结果

如果你的助手表示“没有相关洞察”，或返回的结果过于单薄，说明数据存放在 Watchr 工作区中。让 Watchr 变得更智能，MCP 也会随之变得更智能：

• 添加监控页面（竞争对手定价、更新日志、招聘页面、产品页面）
• 为每个受追踪品牌添加 LinkedIn、Facebook、Instagram 账号，完善社交资料
• 在监控组级别优化筛选提示词。它决定什么内容算“相关”。根据实际筛选结果，收紧提示词（使用你关注的更具体主题）或放宽提示词（捕捉更多内容）。
• 添加更多新闻和媒体来源。来源越多，信号密度越高。

所有内容都可以在 watchr.ai/app/settings 配置。

支持

• Bug 报告和功能请求：在此仓库中提交问题
• 一般问题和反馈：[email protected]
• 状态和正常运行时间：MCP 端点与 Watchr 主平台共用状态信息

---

由 Watchr 团队构建。采用 MIT 许可。