Japan Price Alert MCP

japan-price-alert-mcp

AI エージェント向けの、日本の EC サイトの価格変動を監視して通知する MCP サーバーです。

概要

日本の主要な EC プラットフォーム（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