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 整合