japan-ec-mcp
Japanese E-Commerce & Secondary Market Search — MCP server
Claude / Cursor / VS Code などの AI クライアントから、日本の主要マーケットプレース(メルカリ、ヤフオク、駿河屋、楽天、価格.com)の価格・在庫・動向を直接問い合わせる Model Context Protocol (MCP) サーバーです。
- 作者: atushi1841
- ライセンス: MIT
- MCP 規格: FastMCP 2.x(stdio / HTTP 両対応)
- 関連プロジェクト: Kensho — X(Twitter)懸賞自動化
Tools(MCP ツール一覧)
Tool 1 — search_japan_marketplace
result = await mcp.call_tool(
"search_japan_marketplace",
{"keyword": "ポケモンカード 151", "platform": "all", "limit": 10}
)
platform:"mercari" | "yahoo" | "surugaya" | "all"(default:all)- 戻り値:
{query, platforms_searched, results: [{platform, search_url, notes, recommended_actor}]}
Tool 2 — get_japan_resale_guidance
result = await mcp.call_tool(
"get_japan_resale_guidance",
{"category": "tcg", "keywords": ["ポケモン", "151"]}
)
category:"tcg" | "camera" | "luxury" | "figure" | "watch"- 戻り値: 各カテゴリの市場特性・推奨調達チャネル・Apify Actor 導線
MCP 接続例
1. 標準入出力(stdio)— Claude Desktop 等
claude_desktop_config.json:
{
"mcpServers": {
"japan-ec-mcp": {
"command": "python",
"args": ["/path/to/japan-ec-mcp/server.py"]
}
}
}
2. HTTP サーバーモード
cd japan-ec-mcp
pip install fastmcp
python server.py --http --port 8000
HTTP エンドポイント確認:
curl http://localhost:8000/mcp/tools | jq .
3. Python から直接 import
from japan_ec_mcp.server import mcp
# FastMCP インスタンスを直接組み込める
4. n8n / Apify Workflow から(HTTP 経由)
Apify の Webhook node で POST /mcp に JSON-RPC を投げる構成で利用可。
(サンプルワークフローは開発中・MCP の HTTP mode は 2026-10 実装)
Related Apify Actors
この MCP サーバーは Apify Store の 86 Actors と連携し、実際にデータを取りたい場面では該当する Actor を併用することを想定しています。PPE(pay-per-event)課金・無料枠あり。
主力 Marketplace Scrapers
中古 / 専門店 Scrapers
Japan Market MCP 系列
- japan-market-mcp — 総合マクロ経済・市場データ
- japan-anime-figure-price-data — アニメフィギュア価格
- japan-anime-figure-demand-features — アニメフィギュア需要特徴量
Quickstart
# 1. クローン
git clone https://github.com/atushi1841/japan-ec-mcp.git
cd japan-ec-mcp
# 2. 依存
pip install fastmcp
# 3. stdio mode で起動(Claude Desktop 等から接続)
python server.py
# 4. HTTP mode で起動(別プロセスから接続)
python server.py --http --port 8000
動作確認
python server.py --http --port 8000 &
sleep 2
curl -s -X POST http://localhost:8000/mcp/tools/list \
-H "Content-Type: application/json" \
-d '{}' | jq '.tools[].name'
MCP 公開レジストリ登録状況
収益化経路: GitHub README → Smithery(未登録)→ Apify Store(86 Actors・PPE課金)への流入。 Smithery 登録は API で自動実行不可のためユーザー手動操作待ち(【要ユーザー対応】タグ継続)。
収益ゲート(この README の役割)
License
MIT License. See Kensho project for the full stack.
Install via Smithery
Connect this MCP server to your AI client (Claude Desktop, Cursor, VS Code) in one command:
npx @smithery/cli install atushi1841/japan-ec-mcp --client claude
Replace claude with cursor, vscode, or cline for other clients.
Alternatively, install directly from the Smithery registry.
Note: Smithery server listing is pending verification. Once verified, this server will appear in search results with useCount tracking.
MCP公式レジストリ登録済み
本サーバーは MCP 公式レジストリに io.github.atushi1841/japan-anime-figure-mcp として登録済み(status: active)です。
# レジストリでの登録確認
curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=atushi1841" | grep -o "\"io.github.atushi1841/japan-anime-figure-mcp\""
Data & Store
- Apify Store: https://apify.com/fruitful_quintessence
- Gumroad datasets: https://atushi5.gumroad.com/l/kutuxe