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.