sentinel-mcp-server

Priceminder MCP 服务

中文 | English

Priceminder — 通过模型上下文协议（MCP），由 AI Agent 提供支持的 Shopee 竞品实时价格监控。

🌐 免费注册：priceminder.online

监控东南亚 Shopee 各站点（SG、MY、TH、VN、ID、PH）的竞品价格。通过自然语言，让 AI Agent 跟踪、分析价格变动并发送提醒。

---

📌 重要提示：请先了解数据流程

Priceminder 的 MCP 服务不能独立运行。它依赖通过付费第三方 API 数据服务获取的竞品价格数据。使用前，请先了解以下 3 层数据流程：

Install Extension → Follow products you want to watch → Backend fetches data via paid APIs → AI Can Query

⚠️ 前置条件

步骤	操作	详情
必需	① 安装浏览器扩展	Chrome / Edge / 360 Browser — 请参阅扩展安装指南
必需	② 浏览 Shopee 商品页面，点击“立即监控”	只有你手动添加到监控列表的商品才能通过 MCP 访问
必需	③ 从扩展设置中获取你的 MCP Key	请参阅下方的快速入门
可选	④ 在 AI 客户端中配置 MCP	然后即可通过自然语言查询价格

🔑 在哪里获取 MCP Key？ MCP Key 显示在浏览器扩展设置页面中。没有扩展 → 没有 Key → 没有 MCP 服务。网站注册（priceminder.online）用于账户管理和升级 Pro 版本 — MCP 访问凭据位于扩展中。

🤖 AI 能力边界

Priceminder 的 MCP 工具只能查询你手动添加到监控列表中的商品。它不能随意搜索 Shopee 上的所有商品。

AI 可以做 ✅	AI 不能做 ❌
列出我监控的商品及其价格	搜索我尚未监控的 Shopee 商品
查看监控商品的价格历史和趋势	获取任意 ASIN / 商品 ID 的价格
查看降价提醒和推送记录	分析我未跟踪的竞品店铺
添加要监控的新商品（需先通过扩展扫描）	自动发现新竞品
检查爬虫引擎的运行状态	修改我的账户密码或设置

简而言之：你告诉系统要监控哪些竞品，MCP 让 AI 分析已收集的数据。

如需了解完整的能力详情，请参阅MCP 工具概览 →

---

📊 为什么选择 Priceminder？

实时数据，而非昨日数据。 大多数价格监控工具（包括其他 MCP 服务）返回的都是 T-1（昨日缓存）数据。Priceminder 每天抓取 3 次价格，让你近乎实时地掌握价格动态。

能力	其他 MCP 服务	Priceminder
数据时效性	T-1（昨日）	T-0（当天，每日 3 次）
价格变动检测	次日	4–8 小时内
限时促销 / 7.7 / 9.9 / 11.11	错过日内变动	捕捉每小时的价格调整
推送通知	❌ 仅支持查询	✅ Feishu / DingTalk / Telegram
可自托管	✅ 支持	✅ 支持

简而言之： 使用其他工具，意味着你依据的是昨日数据做决策。Priceminder 告诉你当下正在发生什么，并在竞品价格变动时推送提醒。

---

🌟 功能 — 8 个 MCP 工具

#	工具	描述	类别
1	get_monitor_list	列出你正在跟踪的所有商品	🔍 查询
2	get_price_summary	汇总所有跟踪商品的价格	🔍 查询
3	get_price_history	特定商品的价格历史时间序列	🔍 查询
4	get_alerts	列出降价提醒	🔍 查询
5	add_monitor	将新商品添加到监控列表	⚡ 操作
6	update_monitor_status	暂停或恢复监控	⚡ 操作
7	get_crawl_health	检查爬取引擎的运行状况和统计数据	📊 洞察
8	get_monitor_overview	所有监控项的仪表板概览	📊 洞察

完整的工具文档请见：MCP 工具概览 →

---

🚀 快速开始

安装扩展 → 添加商品 → 获取 MCP 密钥 → 配置 AI 客户端

如需查看包含截图的可视化分步指南，请参阅官方文档：快速入门指南 →

第 1 步：安装浏览器扩展

浏览器	安装方式
Chrome	在 Chrome 网上应用店搜索 “Priceminder”
Edge	在 Edge 加载项中搜索 “Priceminder”
360 浏览器	从官方网站下载离线安装程序
Opera	Opera 加载项商店

截图请参阅扩展安装指南 →。

第 2 步：添加要监控的商品

打开任意 Shopee 商品页面（支持 SG/MY/TH/ID/TW/PH/VN）。右上角会出现一个“立即监控”按钮：

1. 点击 “立即监控” → 商品即添加到监控列表
2. 系统会按照你选择的间隔自动开始收集价格数据
3. 在扩展设置中配置爬取频率和提醒阈值

💡 请先添加要监控的商品。 如果没有商品，AI 在查询时会返回空结果。请先添加至少 5–10 个竞品。

第 3 步：获取 MCP 密钥

打开浏览器扩展设置页面。你的 MCP 密钥会显示在“MCP 配置”部分。

⚠️ MCP 密钥仅在扩展设置中可见。 无法通过网站登录获取。

第 4 步：配置 AI 客户端

支持的 AI 客户端（HTTP 模式 — 推荐）：

客户端	配置方式	教程
Cherry Studio	Settings → MCP → Add HTTP URL	指南 →
OpenClaw	config.yaml → mcp_servers → url	指南 →
Claude Desktop	claude_desktop_config.json → mcpServers	指南 →
Cursor	Cursor Settings → MCP → Add HTTP URL	指南 →
Cline	Cline MCP Config → Add	指南 →
Hermes Agent	config.yaml → mcp_servers	指南 →

添加此 URL（将 *** 替换为你的 MCP 密钥）：

{
  "mcpServers": {
    "sentinel": {
      "url": "https://priceminder.online/mcp_server?key=***"
    }
  }
}

如需查看包含截图的详细客户端配置指南，请参阅：客户端配置指南 →

第 5 步：验证连接

通过提问来测试配置：

你的提示词	调用的工具	预期结果
“我正在监控什么？”	get_monitor_list	你当前的监控列表
“我的竞争对手价格如何？”	get_price_summary	价格摘要（当前价/基准价/最高价/最低价/平均价）
“有新的降价提醒吗？”	get_alerts	未读的降价记录
“爬取引擎运行正常吗？”	get_crawl_health	爬取引擎状态

✅ 如果 AI 返回了你的监控数据，则表示配置成功。

❌ 如果结果为空，请先通过扩展添加要监控的商品。

---

💬 提示词场景

以下是 3 个真实场景，你可以直接运行，每个场景都展示了不同的用例：

1️⃣ 店铺级价格监控

“监控 Shopee SG 上 Shopee 店铺 ‘ABC Official Store’ 的所有商品。如果过去 24 小时内任何商品降价超过 5%，请总结价格变化。”

你的 AI Agent 将会：

1. 检查监控列表中该店铺的商品
2. 比较最新抓取的价格
3. 返回降价幅度超过阈值的商品

最适用场景： 品牌竞争——跟踪特定竞争对手的全部商品目录。

2️⃣ 限时促销／活动提醒

“在 7.7 促销期间，每 4 小时检查一次——如果我跟踪的任何商品价格变动达到或超过 3%，请提醒我。只显示价格有变动的商品。”

你的 AI Agent 将会：

1. 调用 get_price_summary 获取当前价格与之前价格
2. 筛选价格变动达到或超过 3% 的商品
3. 清晰展示变动前后的价格对比

最适用场景： 促销活动期间——竞争对手每小时调整价格，别等到第二天才发现数据已经过时。

3️⃣ 降价情报

“显示过去 2 天的所有降价提醒。哪些商品降价最多？标出降价幅度超过 10% 的商品。”

你的 AI Agent 将会：

1. 调用 get_alerts 获取最近的通知
2. 对价格变动最大的商品调用 get_price_history，了解背景信息
3. 按降价百分比排序，并标出关键变动

最适用场景： 采购决策——发现折扣力度最大的商品。

更多真实场景的提示词示例：场景与最佳实践 →

---

🔗 n8n 集成

Priceminder 提供可直接导入的 n8n 工作流模板。

文件： priceminder-mcp-n8n.json

工作流

Schedule ─► Get Price Summary ─► Parse Drops ─► Has Drops? ─┬► Telegram Alert
(4h cron)                                                     ├► Email Alert
                                                              └► Log (no drops)

导入

1. 打开 n8n → 工作流 → 从文件导入
2. 选择 priceminder-mcp-n8n.json
3. 配置凭据：
   • SENTINEL_TOKEN（n8n 主机上的环境变量）
   • Telegram 机器人令牌 + 聊天 ID（可选）
   • SMTP 凭据（可选）
4. 启用工作流

---

🏗️ 架构

┌─────────────────────────────────────────────────────┐
│                  AI Client                          │
│  (Claude Desktop / Cursor / Cherry Studio / Hermes) │
└──────────────┬──────────────────────────────────────┘
               │  MCP Protocol (stdio or HTTP/SSE)
               ▼
┌──────────────────────────────────────┐
│     Priceminder MCP Server           │
│  ┌────────────────────────────────┐  │
│  │  Tool Registry (8 tools)      │  │
│  │  - get_monitor_list           │  │
│  │  - get_price_summary          │  │
│  │  - get_price_history          │  │
│  │  - get_alerts                 │  │
│  │  - add_monitor                │  │
│  │  - get_crawl_health           │  │
│  │  - get_monitor_overview       │  │
│  └──────────────┬─────────────────┘  │
│                 │ HTTP + Token Auth
│  ┌──────────────▼─────────────────┐  │
│  │  API Client (httpx)           │  │
│  └──────────────┬─────────────────┘  │
└─────────────────┼────────────────────┘
                  │ HTTPS
┌─────────────────▼────────────────────┐
│     Priceminder REST API             │
│  (User Mgmt / Monitor / Price / Alert)│
└─────────────────┬────────────────────┘
                  │
┌─────────────────▼────────────────────┐
│     PostgreSQL 16                    │
│  (Price History / Users / Alerts)    │
└──────────────────────────────────────┘

数据流

① User selects products to monitor via extension
      │
      ▼
② Backend fetches real-time prices via paid third-party API data services → PostgreSQL
      │
      ▼
③ MCP Server reads via API
      │
      ▼
④ AI client queries via MCP protocol

要点： 数据单向流动——用户选择商品 → 后端通过付费 API 获取数据 → MCP 读取。扩展程序只负责告知系统要监控哪些商品。

---

🔧 配置

环境变量

变量	描述	默认值
SENTINEL_API_BASE	后端 API 基础 URL	https://priceminder.online/shopee
SENTINEL_TOKEN	你的身份验证令牌	（必填）
SENTINEL_TIMEOUT	HTTP 请求超时时间（秒）	30
MCP_MODE	运行模式：stdio 或 http	stdio
MCP_HOST	HTTP 服务绑定地址	127.0.0.1
MCP_PORT	HTTP 服务端口	8082
LOG_LEVEL	日志级别	INFO

---

📡 API 参考

身份验证

所有 API 调用都需要以下标头：

X-Api-Key: sentinel-mvp-2026
X-Sentinel-Token: YOUR_TOKEN

生成 MCP 密钥

curl -X POST https://priceminder.online/shopee/mcp/generate-key \
  -H "X-Api-Key: sentinel-mvp-2026" \
  -H "X-Sentinel-Token: YOUR_TOKEN"

---

🆓 免费版与 Pro 版

功能	免费版	Pro 版
活跃监控项	最多 5 个	不限
价格历史	3 天	90 天
价格摘要	3 天	90 天
调用频率限制	每小时 60 次	不限
实时提醒	—	✅
优先支持	—	✅

立即升级 👉 priceminder.online

---

🛠️ 开发

git clone https://github.com/haidrau/sentinel-mcp-server.git
cd sentinel-mcp-server

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/

# Start in dev mode
export SENTINEL_TOKEN=your-test-token
python -m sentinel_mcp.server

---

📄 许可证

MIT 许可证——详情请参阅 LICENSE。

---

🤝 参与贡献

欢迎贡献！你可以：

• 提交问题，报告 Bug 或提出功能请求
• 提交 PR，添加新工具或改进现有功能
• 在讨论区提问

---

🌐 Links

• Website: priceminder.online ← Sign up free
• Official Docs: priceminder.online/docs
• Quick Start: priceminder.online/docs/quick-start
• MCP Tools Overview: priceminder.online/docs/tools/overview
• GitHub: github.com/haidrau/sentinel-mcp-server
• Gitee: gitee.com/haidrau/sentinel-mcp-server