Japan Price Alert MCP
Price change alert MCP. Apify: apify.com/fruitful_quintessence Gumroad: atushi5.gumroad.com/l/kutuxe
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
https://github.com/atushi1841/japan-price-alert-mcp/releases/download/v0.1.0/server.mcpbالتوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
japan-price-alert-mcp
Japanese EC price-change monitoring and notification MCP server for AI agents.
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
| Tool | Description |
|---|---|
create_price_watch | Register a new product URL for price monitoring |
list_price_watches | List all registered watches |
get_price_watch | Get details of a specific watch |
update_price_watch | Update watch parameters (target price, interval, etc.) |
delete_price_watch | Remove a watch |
check_price_watch | Force immediate price check |
run_due_price_checks | Batch check all due watches |
get_price_history | Get historical price data |
detect_platform_url | Detect platform from URL |
Installation
Smithery (Recommended)
npx @smithery/cli install atushi1841/japan_price_alert_mcpManual
# 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 Variable | Description | Default |
|---|---|---|
PRICE_WATCH_DB | Custom SQLite database path | <bundle>/data/price_watch.db |
TELEGRAM_BOT_TOKEN | Telegram bot token (for notifications) | - |
TELEGRAM_CHAT_ID | Telegram chat ID (for notifications) | - |
Usage Examples
// 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"
});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
- Apify Store: https://apify.com/fruitful_quintessence
- Gumroad datasets: https://atushi5.gumroad.com/l/kutuxe
الأسئلة الشائعة
ما هو Japan Price Alert MCP؟
Price change alert MCP. Apify: apify.com/fruitful_quintessence Gumroad: atushi5.gumroad.com/l/kutuxe
كيف أثبّت Japan Price Alert MCP؟
اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.
هل يحتاج Japan Price Alert MCP إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Japan Price Alert MCP مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Japan Price Alert MCP؟
ينشره atushi1841. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.