Skip to content

快速开始

从安装到用 AI 对话查竞品,只需 3 步配置,约 10 分钟完成。

产品架构:三层流转

盯价哨兵不是一个孤立的工具,而是一条从「数据采集」到「AI 决策」的完整链路。理解这张图,就理解了产品的全部价值。

盯价哨兵产品架构总览

整条链路分三层:

第一层 — 哨兵浏览器插件。 安装在 Chrome 浏览器中,当卖家打开任意 Shopee 商品详情页时,插件自动识别商品信息。点击「立即监测」按钮即可将该商品加入监控列表,系统随后会按设定的间隔持续采集价格数据,无需人工干预。

第二层 — 哨兵 MCP 服务。 托管在云端,将采集到的价格数据、监控列表、预警记录等通过 MCP 协议(Model Context Protocol)暴露为标准化接口。AI 客户端无需了解后端细节,只需通过 MCP 协议即可读取数据。MCP 是 AI 应用的「USB-C 接口」——不管你用 Claude、Cherry Studio 还是 Cursor,只要支持 MCP,就能统一接入。

第三层 — AI 智能体对话。 在你常用的 AI 客户端中配置好 MCP 地址后,就可以用自然语言与 AI 对话,完成盯价询问、趋势分析、运营决策等工作。AI 会自动选择合适的工具(如 get_price_summaryget_price_history)来回答你的问题。

简单说:插件帮你「录入」竞品,MCP 让 AI 帮你「分析和管理」竞品。


配置指南:三步接入

第 1 步:安装浏览器扩展

从 Chrome 应用商店或官网下载页安装盯价哨兵扩展。安装完成后,打开任意 Shopee 商品详情页,页面右上角会出现「立即监测」按钮,点击即可将商品加入监控列表。

Shopee 商品页的监测按钮

安装完成后,在扩展设置页可以配置采集间隔(免费版 60 分钟,Pro 版最快 30 分钟)和降价预警阈值(默认 5%)。详细的安装步骤和各浏览器支持情况,请参阅 扩展安装指南

第 2 步:配置飞书推送

当竞品降价超过阈值时,系统会自动推送一条预警卡片到你的飞书群。配置方式是在飞书群中创建一个「自定义机器人」,将获得的 Webhook 地址填入扩展设置页的推送配置区域。

扩展设置页的推送配置

飞书 Webhook 的完整配置步骤(含截图),请参阅 飞书推送配置指南。配置完成后点击「测试推送」验证是否成功。

其他推送渠道

飞书是当前已上线的推送渠道,Telegram Bot 推送正在开发中,后续版本将支持更多东南亚 IM 平台。

第 3 步:在 AI 客户端中接入 MCP

这是打通「插件数据」到「AI 对话」的关键一步。在你的 AI 客户端(如 Cherry Studio、Claude Desktop、Cursor 等)中添加以下 MCP 配置:

json
{
  "mcpServers": {
    "sentinel": {
      "url": "https://priceminder.online/mcp_server?key=你的MCP-Key"
    }
  }
}

其中 MCP-Key 可以在扩展设置页找到。各客户端的具体操作步骤,请参阅 客户端接入教程

当前支持的客户端:

客户端优先级状态
Cherry StudioP0 · 推荐已支持
OpenClawP0 · 推荐已支持
Claude DesktopP1已支持
CursorP1已支持
ClineP2已支持
Hermes AgentP2已支持

腾讯元宝 / 豆包等客户端

国内 AI 客户端(如腾讯元宝、豆包)若支持 MCP 协议,同样可以使用上述 URL 地址接入。请查阅对应客户端的 MCP 配置文档。

本地 stdio 模式(开发者可选)

以上步骤使用的是托管 HTTP 模式——云端运行 MCP Server,只需配置一行 URL。如果你的技术团队需要本地调试,也可以使用 stdio 模式自行运行:

bash
uvx sentinel-mcp-server
json
{
  "mcpServers": {
    "sentinel": {
      "command": "uvx",
      "args": ["sentinel-mcp-server"],
      "env": {
        "SENTINEL_API_BASE": "https://priceminder.online/api/v1",
        "SENTINEL_TOKEN": "你的 API Token"
      }
    }
  }
}

stdio 模式使用 API Token(较长),而非 MCP-Key(较短),两者均从扩展设置页获取。需要本地安装 Python 3.11+ 和 uv 包管理器。


开始使用:对话查竞品

配置完成后,打开你的 AI 客户端,直接用自然语言提问即可。AI 会自动调用合适的 MCP 工具来回答。

验证连接

用以下提示词测试连接是否正常:

你说AI 调用的工具预期返回
「我的监控列表」get_monitor_list当前监控的商品列表
「竞品最近价格怎么样」get_price_summary价格摘要(当前/基准/最高/最低/均价)
「有没有新的降价预警」get_alerts未读的降价预警记录
「采集系统运行正常吗」get_crawl_health采集引擎运行状态

如果 AI 正确返回了你的监控数据,说明接入成功。

对话示例

以下是一个典型的早间巡检对话:

你: 帮我看看 SG 站上的竞品昨晚有没有降价

AI: SG 站 5 个监控商品,昨晚有 1 个降价:

📉 iPhone 15 Pro Max:SGD 1,599 → SGD 1,499(↓6.3%,已推送飞书预警) ➡️ AirPods Pro 2:SGD 349,持平 ➡️ Samsung S24 Ultra:SGD 1,799,持平

建议关注 iPhone 的降价趋势,竞品可能有促销动作。

AI 共有 8 个工具可用,分为查询类(查价格、看趋势、收预警)、操作类(加监控、暂停/恢复)和洞察类(采集健康度、监控大盘)。完整的工具清单和说明请参阅 MCP 工具总览,更多真实对话场景请参阅 场景与最佳实践


产品收益

当三层链路打通后,你获得的不只是一个「价格监控工具」,而是一个全天候竞品情报系统

速度优势。 竞品降价后最快 30 分钟内即可推送飞书预警,而传统方式靠人工每天刷一遍 Shopee,往往 T+1 才能发现——漏价一天的损失可能远超一个月的技术服务费。

飞书降价预警卡片

飞书群中收到的降价预警卡片,包含商品名称、价格变动幅度等关键信息

决策优势。 用自然语言与 AI 对话即可完成价格巡检、趋势分析、竞品对比,无需打开任何后台界面。AI 会基于你的真实监控数据给出分析和建议,不是泛泛而谈。

成本优势。 基础监控功能免费,Pro 版的最小采集间隔从 60 分钟缩短到 30 分钟,且支持每日价格简报和价格趋势图。与其花人力每天盯盘,不如让 AI 替你盯着。


下一步

Released under the MIT License.