Japan Price Alert MCP

japan-price-alert-mcp

面向 AI Agent 的日本电商价格变动监控与通知 MCP 服务。

概述

监控日本主要电商平台（Mercari、Yahoo Auctions、Rakuten、SUUMO、Kakaku.com）的商品价格，并在降价时即时收到提醒。

基于 Kensho 项目的价格监控引擎构建。

平台

• Mercari Japan（メルカリ）- jp.mercari.com
• Yahoo! Auctions / Shopping（ヤフオク）- auctions.yahoo.co.jp、shopping.yahoo.co.jp
• Rakuten Ichiba（楽天市場）- item.rakuten.co.jp
• SUUMO（SUUMO）- suumo.jp
• Kakaku.com（価格.com）- kakaku.com
• Suruga-ya（駿河屋）- suruga-ya.jp

工具

工具	描述
create_price_watch	注册新的商品 URL 以监控价格
list_price_watches	列出所有已注册的监控项
get_price_watch	获取指定监控项的详情
update_price_watch	更新监控参数（目标价格、间隔等）
delete_price_watch	删除监控项
check_price_watch	立即强制检查价格
run_due_price_checks	批量检查所有到期的监控项
get_price_history	获取历史价格数据
detect_platform_url	根据 URL 检测平台

安装

Smithery（推荐）

npx @smithery/cli install atushi1841/japan_price_alert_mcp

手动安装

# Clone or extract the MCPB bundle
# Configure in your MCP client:
{
  "servers": {
    "japan-price-alert-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/bundle", "src/stdio_main.py"]
    }
  }
}

配置

环境变量	描述	默认值
PRICE_WATCH_DB	自定义 SQLite 数据库路径	<bundle>/data/price_watch.db
TELEGRAM_BOT_TOKEN	Telegram 机器人令牌（用于通知）	-
TELEGRAM_CHAT_ID	Telegram 聊天 ID（用于通知）	-

使用示例

// Create a price watch
const result = await mcp.callTool("create_price_watch", {
  user_id: "user123",
  url: "https://www.mercari.com/us/item/m123456789/",
  target_price_jpy: 5000,
  notification_channel: "telegram",
  notification_destination: "123456789",
  check_interval_minutes: 30
});

// Check a specific watch
const check = await mcp.callTool("check_price_watch", {
  watch_id: "pw_abc123"
});

// List all watches
const list = await mcp.callTool("list_price_watches", {
  user_id: "user123"
});

提醒条件

• lte（默认）：当价格 <= target_price_jpy 时提醒
• any_drop：价格出现任何下降时提醒
• percent_drop：价格下降幅度 >= drop_percentage% 时提醒
• in_stock：商品重新有货时提醒

通知渠道

• log（默认）：记录到 stderr
• telegram：发送到 Telegram 机器人（需要 token + chat_id）
• webhook：向指定 URL 发送 POST 请求
• email：记录邮件提醒（尚未实现 SMTP）

依赖项

• Python >=3.10
• fastmcp >=3.0.0
• 抓取仅使用标准库（除 fastmcp 外无其他外部依赖）

许可证

MIT

作者

atushi1841

---

数据与商店

• Apify Store： https://apify.com/fruitful_quintessence
• Gumroad 数据集： https://atushi5.gumroad.com/l/kutuxe