内容
# 价格监控服务器
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/)
[](https://modelcontextprotocol.io)
[](https://priceminder.online)
[**中文**](README.zh-CN.md) | [English](README.md)
> **价格监控** — 实时虾皮竞争对手价格监控，借助人工智能代理通过模型上下文协议（MCP）。
🌐 **免费注册**: [priceminder.online](https://priceminder.online)
监控虾皮东南亚（新加坡，马来西亚，泰国，越南，印度尼西亚，菲律宾）竞争对手的价格。让您的人工智能代理跟踪，分析并提醒价格变动 — 所有这些都通过自然语言。
---
## 📌 重要：了解数据管道
价格监控的MCP服务 **不能独立运行**。它依赖于通过付费第三方API数据服务获得的竞争对手价格数据。请在使用前了解这3层管道：
```
安装扩展 → 关注您要监控的产品 → 后端通过付费API获取数据 → 人工智能可以查询
```
### ⚠️ 先决条件
| 步骤 | 操作 | 详情 |
|------|--------|---------|
| **必填** | ① 安装浏览器扩展 | Chrome / Edge / 360浏览器 — 参见 [扩展安装指南](https://priceminder.online/docs/extensions/) |
| **必填** | ② 浏览虾皮产品页面，单击“立即监控” | 只有您手动添加到监控的产品才可以通过MCP访问 |
| **必填** | ③ 从扩展设置中获取您的 **MCP密钥** | 参见下面的 [快速入门](#-quick-start) |
| **可选** | ④ 在您的AI客户端中配置MCP | 然后，您可以通过自然语言查询价格 |
> 🔑 **在哪里获取您的MCP密钥？**
> MCP密钥在 **浏览器扩展设置页面** 中显示。没有扩展 → 没有密钥 → 没有MCP服务。网站注册（priceminder.online）用于帐户管理和Pro升级 — MCP访问凭证位于扩展中。
### 🤖 人工智能能力边界
价格监控的MCP工具 **只能查询您手动添加到监控列表的产品**。它不能任意搜索所有虾皮产品。
| 人工智能可以 ✅ | 人工智能不能 ❌ |
|---|---|
| 列出我监控的产品和价格 | 搜索我尚未监控的虾皮产品 |
| 查看监控商品的价格历史和趋势 | 获取任意ASIN /产品ID的价格 |
| 检查价格下降提醒和推送记录 | 分析我不跟踪的竞争对手商店 |
| 添加新产品到监控（需要扩展扫描） | 自动发现新竞争对手 |
| 检查爬虫引擎健康状态 | 修改我的帐户密码或设置 |
**简而言之：您告诉系统要监控哪些竞争对手，MCP让人工智能分析已收集的数据。**
有关MCP工具的详细信息，请参见 [**MCP工具概述 →**](https://priceminder.online/docs/tools/overview)
---
## 📊 为什么选择价格监控？
**实时，而不是昨天。** 大多数价格监控工具 — 包括替代MCP服务器 — 返回T-1（昨天的缓存）数据。价格监控每 **3次** 每天抓取价格，让您近乎实时地了解情况。
| 功能 | 替代MCP服务器 | 价格监控 |
|---|---|---|
| **数据新鲜度** | T-1（昨天） | **T-0（当天，3次/天）** |
| **价格变动检测** | 次日 | **4-8小时内** |
| **闪购 / 7.7 / 9.9 / 11.11** | 错过日内变动 | **捕捉每小时调整** |
| **推送通知** | ❌ 仅查询 | ✅ Feishu / DingTalk / Telegram |
| **自托管** | ✅ 支持 | ✅ 支持 |
**简而言之：** 如果您正在使用其他工具，您将根据昨天的数据做出决策。价格监控告诉您 **现在** 正在发生什么 — 当竞争对手变动时，会推送提醒。
---
## 🌟 功能 — 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工具概述 →**](https://priceminder.online/docs/tools/overview)
---
## 🚀 快速入门
> **安装扩展 → 添加产品 → 获取MCP密钥 → 配置AI客户端**
有关带有截图的视觉逐步指南，请参见官方文档： [**快速入门指南 →**](https://priceminder.online/docs/quick-start)
### 步骤1：安装浏览器扩展
| 浏览器 | 安装 |
|---|---|
| **Chrome** | 在 [Chrome Web Store](https://chromewebstore.google.com) 上搜索“价格监控” |
| **Edge** | 在 [Edge Add-ons](https://microsoftedge.microsoft.com/addons) 上搜索“价格监控” |
| **360浏览器** | 从官方网站下载离线安装程序 |
| **Opera** | Opera插件商店 |
参见 [**扩展安装指南 →**](https://priceminder.online/docs/extensions/) 获取截图。
### 2. 添加产品进行监控
打开任意虾皮产品页面（支持新加坡，马来西亚，泰国，印度尼西亚，台湾，菲律宾，越南）。顶部右侧会出现“ **立即监控** ”按钮：
1. 点击 **“立即监控”** → 产品添加到您的监控列表
2. 系统自动以您选择的间隔开始收集价格数据
3. 在扩展设置中配置抓取频率和提醒阈值
> 💡 **您需要先监控产品。** 没有它们，AI查询时将返回空结果。首先添加至少5-10个竞争对手产品。
### 步骤3：获取您的MCP密钥
打开浏览器 **扩展设置页面**。您的MCP密钥在“MCP配置”部分中显示。
> ⚠️ **MCP密钥仅在扩展设置中可见。** 它在网站登录页面不可用。
### 步骤4：配置您的AI客户端
**支持的AI客户端（HTTP模式 — 推荐）：**
| 客户端 | 如何配置 | 教程 |
|---|---|---|
| Cherry Studio | 设置 → MCP → 添加HTTP URL | [指南 →](https://priceminder.online/docs/clients/cherry-studio) |
| OpenClaw | config.yaml → mcp_servers → url | [指南 →](https://priceminder.online/docs/clients/openclaw) |
| Claude Desktop | claude_desktop_config.json → mcpServers | [指南 →](https://priceminder.online/docs/clients/claude-desktop) |
| Cursor | Cursor设置 → MCP → 添加HTTP URL | [指南 →](https://priceminder.online/docs/clients/cursor) |
| Cline | Cline MCP配置 → 添加 | [指南 →](https://priceminder.online/docs/clients/cline) |
| Hermes Agent | config.yaml → mcp_servers | [指南 →](https://priceminder.online/docs/clients/hermes-agent) |
添加此URL（用您的MCP密钥替换 `***`）：
```json
{
"mcpServers": {
"sentinel": {
"url": "https://priceminder.online/mcp_server?key=***"
}
}
}
```
有关详细客户端设置指南和截图，请参见： [**客户端设置指南 →**](https://priceminder.online/docs/clients/)
### 步骤5：验证连接
通过询问这些问题来测试您的设置：
| 您的提示 | 调用的工具 | 预期结果 |
|---|---|---|
| “我正在监控什么？” | `get_monitor_list` | 您的当前监控列表 |
| “竞争对手的价格是多少？” | `get_price_summary` | 价格汇总（当前/基准/高/低/平均） |
| “有新的价格下降提醒吗？” | `get_alerts` | 未读价格下降记录 |
| “爬虫健康吗？” | `get_crawl_health` | 爬虫引擎状态 |
> ✅ 如果AI返回您的监控数据，则设置成功。
>
> ❌ 如果结果为空，请确保您已使用扩展程序添加了要监控的产品。
---
## 💬 提示场景
以下是 **3个现实场景** ，您可以运行 — 每个场景都演示了不同的用例：
### 1️⃣ 店铺级价格监控
> *"监控虾皮店铺'ABC官方店铺'在虾皮新加坡的所有产品。如果过去24小时内任何产品价格下降超过5%，请总结价格变动。*"*
您的AI代理将：
1. 检查您的监控列表以获取该店铺的产品
2. 比较最新的抓取价格
3. 返回价格低于阈值的产品
**最适合：** 品牌竞争 — 跟踪特定竞争对手的整个产品目录。
### 2️⃣ 闪购 / 活动提醒
> *"在7.7活动期间，每4小时检查一次 — 如果我跟踪的产品价格变动超过3%，请提醒我。只显示价格变动的产品。*"*
您的AI代理将：
1. 调用 `get_price_summary` 获取当前和之前的价格
2. 过滤变动≥3%的产品
3. 呈现干净的变动前后比较
**最适合：** 活动期间 — 不要在竞争对手每小时调整价格时等待昨天的數據。
### 3️⃣ 价格下降情报
> *"显示过去2天所有价格下降提醒。哪些产品的价格下降最多？突出显示下降超过10%的产品。*"*
您的AI代理将：
1. 调用 `get_alerts` 获取最近的通知
2. 调用 `get_price_history` 获取变动最大的产品
3. 按下降百分比排名并突出显示关键变动
**最适合：** 购买决策 — 发现最优惠的价格。
更多现实提示示例： [**场景和最佳实践 →**](https://priceminder.online/docs/scenarios)
---
## 🔗 n8n集成
价格监控附带一个可导入的n8n工作流模板。
**文件：** [`priceminder-mcp-n8n.json`](priceminder-mcp-n8n.json)
### 工作流
```
定时器 ─► 获取价格汇总 ─► 解析价格变动 ─► 有变动？ ─┬► Telegram提醒
(4小时cron) ├► 邮箱提醒
└► 日志（无变动）
```
### 导入
1. 打开n8n → **工作流** → **从文件导入**
2. 选择 `priceminder-mcp-n8n.json`
3. 配置凭证：
- `SENTINEL_TOKEN` （n8n主机上的环境变量）
- Telegram机器人令牌 + 聊天ID（可选）
- SMTP凭证（可选）
4. **激活** 工作流
---
## 🏗️ 架构
```
┌─────────────────────────────────────────────────────┐
│ AI客户端 │
│ （Claude Desktop / Cursor / Cherry Studio / Hermes） │
└──────────────┬──────────────────────────────────────┘
│ MCP协议（stdio或HTTP/SSE）
▼
┌──────────────────────────────────────┐
│ 价格监控MCP服务器 │
│ ┌────────────────────────────────┐ │
│ │ 工具注册表（8种工具） │ │
│ │ - get_monitor_list │ │
│ │ - get_price_summary │ │
│ │ - get_price_history │ │
│ │ - get_alerts │ │
│ │ - add_monitor │ │
│ │ - get_crawl_health │ │
│ │ - get_monitor_overview │ │
│ └──────────────┬─────────────────┘ │
│ │ HTTP + Token Auth
│ ┌──────────────▼─────────────────┐ │
│ │ API客户端（httpx） │ │
│ └──────────────┬─────────────────┘ │
└─────────────────┼────────────────────┘
│ HTTPS
┌─────────────────▼────────────────────┐
│ 价格监控REST API │
│ （用户管理 / 监控 / 价格 / 提醒）│
└─────────────────┬────────────────────┘
│
┌─────────────────▼────────────────────┐
│ PostgreSQL 16 │
│ （价格历史 / 用户 / 提醒） │
└──────────────────────────────────────┘
```
### 数据流
```
① 用户通过扩展程序选择要监控的产品
│
▼
② 后端通过付费第三方API数据服务获取实时价格 → PostgreSQL
│
▼
③ MCP服务器通过API读取
│
▼
④ AI客户端通过MCP协议查询
```
**关键点：** 数据单向流动 — 用户选择产品 → 后端通过付费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调用都需要以下标头：
```bash
X-Api-Key: sentinel-mvp-2026
X-Sentinel-Token: 您的令牌
```
### 生成MCP密钥
```bash
curl -X POST https://priceminder.online/shopee/mcp/generate-key \
-H "X-Api-Key: sentinel-mvp-2026" \
-H "X-Sentinel-Token: 您的令牌"
```
---
## 🆓 免费 vs 专业
| 功能 | 免费 | 专业 |
|---|---|---|
| 活跃的监控 | 最大5个 | 无限制 |
| 价格历史 | 3天 | 90天 |
| 价格汇总 | 3天 | 90天 |
| 调用速率 | 60/小时 | 无限制 |
| 实时提醒 | — | ✅ |
| 优先级支持 | — | ✅ |
立即升级 👉 [priceminder.online](https://priceminder.online)
---
## 🛠️ 开发
```bash
git clone https://github.com/haidrau/sentinel-mcp-server.git
cd sentinel-mcp-server
# 安装开发依赖
pip install -e ".[dev]"
# 运行测试
python -m pytest tests/
# 开发模式启动
export SENTINEL_TOKEN=您的测试令牌
python -m sentinel_mcp.server
```
---
## 📄 许可证
MIT许可证 — 参见 [LICENSE](LICENSE) 获取详情。
---
## 🤝 贡献
欢迎贡献！请随意：
- 为错误或功能请求开启问题
- 提交新的工具或改进的PR
- 在讨论中提问
---
## 🌐 链接
- **网站**: [priceminder.online](https://priceminder.online) ← 免费注册
- **官方文档**: [priceminder.online/docs](https://priceminder.online/docs/)
- **快速入门**: [priceminder.online/docs/quick-start](https://priceminder.online/docs/quick-start)
- **MCP工具概述**: [priceminder.online/docs/tools/overview](https://priceminder.online/docs/tools/overview)
- **GitHub**: [github.com/haidrau/sentinel-mcp-server](https://github.com/haidrau/sentinel-mcp-server)
- **Gitee**: [gitee.com/haidrau/sentinel-mcp-server](https://gitee.com/haidrau/sentinel-mcp-server)
