Japan Price Alert MCP

io.github.atushi1841由 GitHub 账号 atushi1841 发布v0.1.0更新于 Oct 27, 2026

Price change alert MCP. Apify: apify.com/fruitful_quintessence Gumroad: atushi5.gumroad.com/l/kutuxe

发布方自己的服务:Alertcamp

概览

AI 生成的概览

监控日本电商网站的商品价格,并在降价时向助手用户发出提醒的本地 stdio 服务器。

可以做什么
  • 创建、列出、查看、更新和删除针对日本电商平台商品链接的价格监控任务,覆盖 Mercari、Yahoo 拍卖、乐天、SUUMO、Kakaku.com 和骏河屋
  • 立即对单个监控执行一次价格检查,或批量检查所有到期任务
  • 读取已监控商品的历史价格数据
  • 识别商品链接属于哪个受支持的平台
  • 在达到目标价、任意降价、按百分比降价或补货时发出提醒,可输出到日志、Telegram 或 webhook
适用场景
适合让助手跟踪日本二手市场、拍卖及购物网站上的商品价格,并在达到目标价、降价或补货时通知你。
运行要求
以本地 stdio 进程运行;README 说明需要 Python 3.10 及以上版本和 fastmcp,也可通过 Smithery CLI 安装。可选环境变量 PRICE_WATCH_DB 用于指定 SQLite 数据库路径,TELEGRAM_BOT_TOKEN 与 TELEGRAM_CHAT_ID 用于 Telegram 通知。抓取商品页面需要网络访问。
安装前请注意
Telegram 通知需要机器人令牌和聊天 ID,属于需谨慎保管的机密。webhook 提醒会向指定网址发送 POST 请求,数据会离开本机。监控任务会写入本地 SQLite 数据库,并可被更新或删除。抓取电商页面可能与平台服务条款冲突。邮件提醒目前仅记录日志,并不会真正发送。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Japan Price Alert MCP,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

japan-price-alert-mcp

Japanese EC price-change monitoring and notification MCP server for AI agents.

[Smithery]

Overview

Monitor product prices across major Japanese e-commerce platforms (Mercari, Yahoo Auctions, Rakuten, SUUMO, Kakaku.com) and receive instant alerts on price drops.

Built on the Kensho project's price monitoring engine.

Platforms

  • 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

Tools

ToolDescription
create_price_watchRegister a new product URL for price monitoring
list_price_watchesList all registered watches
get_price_watchGet details of a specific watch
update_price_watchUpdate watch parameters (target price, interval, etc.)
delete_price_watchRemove a watch
check_price_watchForce immediate price check
run_due_price_checksBatch check all due watches
get_price_historyGet historical price data
detect_platform_urlDetect platform from URL

Installation

Smithery (Recommended)

bash
npx @smithery/cli install atushi1841/japan_price_alert_mcp

Manual

bash
# 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"]    }  }}

Configuration

Environment VariableDescriptionDefault
PRICE_WATCH_DBCustom SQLite database path<bundle>/data/price_watch.db
TELEGRAM_BOT_TOKENTelegram bot token (for notifications)-
TELEGRAM_CHAT_IDTelegram chat ID (for notifications)-

Usage Examples

typescript
// Create a price watchconst 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 watchconst check = await mcp.callTool("check_price_watch", {  watch_id: "pw_abc123"});
// List all watchesconst list = await mcp.callTool("list_price_watches", {  user_id: "user123"});

Alert Conditions

  • lte (default): Alert when price <= target_price_jpy
  • any_drop: Alert on any price decrease
  • percent_drop: Alert when price drops by >= drop_percentage%
  • in_stock: Alert when item comes back in stock

Notification Channels

  • log (default): Log to stderr
  • telegram: Send to Telegram bot (requires token + chat_id)
  • webhook: POST to specified URL
  • email: Log email alert (SMTP not implemented)

Dependencies

  • Python >=3.10
  • fastmcp >=3.0.0
  • stdlib only for scraping (no external dependencies beyond fastmcp)

License

MIT

Author

atushi1841


Data & Store

来源:README.md,提交 8eabd25

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.0最新Oct 18, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Alert 集成