常见问题
如何获取 API Token / MCP-Key？
有两种方式：
- Chrome 扩展：安装盯价哨兵 Chrome 扩展后，在扩展设置页面可以看到你的 Token 和 MCP-Key。
- API 创建：通过
POST /auth/init接口创建账号并获取 Token。
TIP
托管 HTTP 模式使用 MCP-Key（格式较短），本地 stdio 模式使用 API Token（较长）。两者都从 Chrome 扩展设置页获取。
支持哪些 Shopee 站点？
目前支持四个站点：
| 站点 | 域名 | 货币 |
|---|---|---|
| 新加坡 (SG) | shopee.sg | SGD |
| 马来西亚 (MY) | shopee.com.my | MYR |
| 泰国 (TH) | shopee.co.th | THB |
| 越南 (VN) | shopee.vn | VND |
数据采集频率是多少？
采集引擎每日分三个时段自动采集：上午 07:00-12:00、下午 12:00-17:00、晚间 17:00-21:00（上海时间）。每个时段内随机时刻执行采集，模拟真实用户浏览行为。
免费版每日采集 3 次（每个时段 1 次），Pro 版每日采集 9 次（每个时段 3 次）。
我们的数据采集严格遵守 Shopee 平台的用户协议和 Robots 协议，通过合规 API 通道获取公开商品信息。
MCP 和 Chrome 扩展是什么关系？
两者是互补关系：
- Chrome 扩展：负责「一键加监控」和数据采集。安装在浏览器中，在 Shopee 商品页自动识别商品信息。
- MCP Server：让 AI 能查询和管理你的监控数据。通过自然语言对话操作，无需手动翻界面。
- 共用后端：两者连接同一个后端 API，数据完全互通。
托管 HTTP 模式和本地 stdio 模式有什么区别？
| 托管 HTTP 模式 | 本地 stdio 模式 | |
|---|---|---|
| 配置 | 一行 URL | 需配置 command + env |
| 依赖 | 无（云端运行） | 需本地 Python 3.11+ / uv |
| 认证 | MCP-Key | API Token |
| 适合 | 普通用户（推荐） | 开发者本地调试 |
| 地址 | mcp.priceminder.online | 本地进程 |
工具调用返回 401 Unauthorized 怎么办？
Token/MCP-Key 无效或过期。解决方法：
- 打开 Chrome 扩展设置页，重新复制 Token / MCP-Key
- 确认配置中没有多余的空格或引号
- 如果使用托管模式，确认使用的是 MCP-Key 而非 API Token
- 如果使用 stdio 模式，确认使用的是 API Token 而非 MCP-Key
工具调用返回 500 错误怎么办？
后端 API 可能未部署或正在维护。解决方法：
- 确认后端服务正常运行（联系管理员）
- 稍后重试
- 如果持续报错，检查
SENTINEL_API_BASE是否指向正确的 API 地址
AI 客户端看不到 sentinel 工具怎么办？
MCP Server 未正确加载。排查步骤：
- 检查 MCP 配置格式是否正确（JSON/YAML 语法）
- 确认服务已启动：HTTP 模式访问
/health，stdio 模式检查进程 - 重启 AI 客户端
- 查看客户端的 MCP 日志（通常在设置页面可查看）
- 参考具体客户端的 配置教程
可以同时监控多少个商品？
- 免费版：每个站点最多 10 个商品
- Pro 版：每个站点最多 100 个商品
MCP 工具可以查询和管理所有已添加的监控商品。