Competiflow

Competiflow MCP 服务

面向 Competiflow 的 MCP（Model Context Protocol） 服务。在 Cursor、Claude Desktop、Windsurf 和任何兼容 MCP 的客户端中，将竞品监控用作工具。

跟踪竞品、执行发现、查看解读后的变更动态、筛选条目，并获取工作区摘要，无需离开 AI 客户端。

设置

在 Competiflow 控制面板的 API keys 下创建 API 密钥，然后将服务添加到客户端配置中。你只需要设置 COMPETIFLOW_API_KEY 这一个变量。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "competiflow": {
      "command": "npx",
      "args": ["-y", "@competiflow/mcp-server"],
      "env": {
        "COMPETIFLOW_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "competiflow": {
      "command": "npx",
      "args": ["-y", "@competiflow/mcp-server"],
      "env": {
        "COMPETIFLOW_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "competiflow": {
      "command": "npx",
      "args": ["-y", "@competiflow/mcp-server"],
      "env": {
        "COMPETIFLOW_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

可用工具

工具	API	描述
list_workspaces	GET /v1/workspaces	列出工作区及待审核数量
create_workspace	POST /v1/workspaces	创建工作区（可选 product_url）
add_competitor	POST /v1/workspaces/:id/competitors	根据主页 URL 添加竞品。异步发现；重复 URL 操作具有幂等性
list_competitors	GET /v1/workspaces/:id/competitors	列出竞品及其监控项和 last_run
get_competitor	GET /v1/competitors/:id	读取单个竞品
update_competitor	PATCH /v1/competitors/:id	设置其所有监控项的频率或状态
delete_competitor	DELETE /v1/competitors/:id	移除竞品及其所有历史记录
list_monitors	GET /v1/monitors	列出监控项及其状态、频率和 last_run
get_monitor	GET /v1/monitors/:id	读取单个监控项。传入 include 可获取采集证据
create_monitor	POST /v1/monitors	为指定 URL 添加手动监控项
update_monitor	PATCH /v1/monitors/:id	更新 URL、频率、状态或 min_severity
delete_monitor	DELETE /v1/monitors/:id	移除监控项及其所有历史记录
check_monitor	POST /v1/monitors/:id/check	将按需检查加入队列
refresh_workspace	POST /v1/workspaces/:id/refresh	将活跃监控项的检查加入队列
list_changes	GET /v1/changes	变更动态，支持 since、筛选条件和 meta 计数
get_change	GET /v1/changes/:id	完整变更。传入 include 可获取采集内容或原始差异
update_change	PATCH /v1/changes/:id	设置 review_status
get_digest	GET /v1/workspaces/:id/digest	每周工作区摘要

典型流程

1. 使用 list_workspaces 或 create_workspace（可选的 product_url 有助于为变更提供更完善的竞品背景）。
2. 使用主页 URL 调用 add_competitor。
3. 调用 get_competitor，直到 discovery_status 为 completed。
4. 调用 refresh_workspace 或 check_monitor 获取最新数据。
5. 使用 since=7d 和 min_severity 调用 list_changes，或调用 get_digest 获取摘要。
6. 需要证据时，调用带有 include 的 get_change。
7. 调用 update_change 确认或忽略条目。

发现与幂等性

add_competitor 会在后台启动发现，并返回确认信息，而非最终结果。轮询 get_competitor，直到 discovery_status 为 completed。

一个工作区一次只执行一项发现任务。再次提交相同的主页 URL 时，会返回现有竞品，而不会启动第二次任务。如果另一个竞品仍在发现中，调用会返回 409 discovery_in_progress 和 active_competitor_id，以便你知道应轮询哪个竞品。

使用 include 获取证据

get_change 和 get_monitor 接受 include 数组，可在一次调用中附带底层采集内容：

标记	适用于	返回内容
capture	get_change、get_monitor	从快照中提取的字段
capture_markdown	get_change、get_monitor	快照中的页面 Markdown
raw_diff	get_change	该变更的前后差异

对于变更，采集内容是变更后的页面。对于监控项，采集内容来自最近一次成功检查，即当前基线。

删除与暂停

delete_monitor 和 delete_competitor 是永久操作。它们会连同检查记录、快照和变更一起移除监控项或竞争对手。若要停止检查但保留情报历史记录，请改为调用 update_monitor 或 update_competitor，并设置 status: paused。

Agent 指南（适用于 AI 客户端）

• **轮询发现状态，不要想当然：**调用 add_competitor 后，轮询 get_competitor，直到 discovery_status 为 completed，再读取变更。遇到 409 时，根据错误信息轮询 active_competitor_id。
• **筛选动态：**将 since（1d、7d、30d 或 ISO8601）、min_severity、monitor_type（homepage、blog、docs、changelog、pricing）和 review_status 传递给 list_changes，而不是一次性拉取全部内容。使用 meta.counts 查看收件箱总数，并通过 next_cursor 翻页。
• **解读字段：**变更和摘要条目会提供 why_it_matters，用于说明竞争背景。API 已移除 recommended_action。
• **按需获取证据：**仅在需要底层采集内容时，才将 include 添加到 get_change 或 get_monitor。这会增加负载。
• **优先暂停而非删除：**用户想停止监控项时，默认设置 status: paused。只有在需要永久移除时才使用 delete_*，因为它会删除历史记录。

工作原理

该服务会将每次工具调用转换为 Competiflow v1 API 请求，并返回结构化 JSON。你的 Agent 看到的是经过解读的变更、严重程度及其重要性，而不是原始页面抓取内容。

AI Agent → MCP Tool Call → Competiflow API → Interpreted Change Feed → Structured Response → AI Agent

环境变量

变量	必需	描述
COMPETIFLOW_API_KEY	是	你的 Competiflow API 密钥（sk_live_...）

获取 API 密钥

在 competiflow.com 注册，并在 API keys 下创建密钥。

开发

npm install
npm run build
COMPETIFLOW_API_KEY=sk_live_... node dist/index.js

许可证

MIT