Japan E-Commerce & Secondary Market Search MCP

io.github.atushi1841v0.1.0更新於 Oct 6, 2026

Japanese e-commerce search MCP for AI agents. Search Mercari, Yahoo Auctions, Suruga-ya.

概覽

AI 產生的概覽

讓助理搜尋 Mercari、Yahoo Auctions、駿河屋等日本電商與二手市場,查詢價格與庫存,並取得轉售採購指引。

功能
此伺服器提供兩個工具。search_japan_marketplace 接收關鍵字、可選平台(mercari、yahoo、surugaya 或 all)與結果數量上限,回傳查詢資訊、已搜尋平台,以及包含平台、搜尋連結、備註與推薦 actor 的結果。get_japan_resale_guidance 接收類別(tcg、camera、luxury、figure、watch)與關鍵字,回傳該類別的市場特性、推薦採購管道,以及相關 Apify actor 的指引。
適用情境
適合助理需要日本市場或二手市場的價格與庫存背景資訊,或需要卡牌、相機、手錶、精品等品類的轉售採購指引時使用。它是僅限桌面的本機伺服器,適合 Claude Desktop、Cursor、VS Code 類用戶端,而非網頁部署。
執行需求
以本機程序方式透過 stdio 執行(也可選用 HTTP 模式並指定連接埠)。需要安裝 Python 與 fastmcp 套件;README 提供 pip install fastmcp 並執行 server.py。未宣告任何驗證、環境變數或標頭。README 說明 HTTP 模式預計於 2026-10 實作。
安裝前請注意
README 說明此伺服器預期與 Apify Store 的 actor 搭配使用,這些 actor 採按事件計費(PPE)並提供免費額度,因此實際取得資料可能涉及付費第三方服務。README 也描述了從 README 導流至 Apify actor 的變現路徑,並將 Smithery 與 mcp.so 的註冊列為待使用者手動處理。伺服器本身不要求任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Japan E-Commerce & Secondary Market Search MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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 ツール一覧)

ツール名機能対象プラットフォーム
search_japan_marketplaceキーワードで商品価格・在庫を横断検索Mercari, Yahoo Auctions, Suruga-ya
get_japan_resale_guidance中古リセール市場の調達指針(TCG / カメラ / 高級時計 / 高級ブランド / フィギュア)5カテゴリ

Tool 1 — search_japan_marketplace

python
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

python
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:

json
{  "mcpServers": {    "japan-ec-mcp": {      "command": "python",      "args": ["/path/to/japan-ec-mcp/server.py"]    }  }}

2. HTTP サーバーモード

bash
cd japan-ec-mcppip install fastmcppython server.py --http --port 8000

HTTP エンドポイント確認:

bash
curl http://localhost:8000/mcp/tools | jq .

3. Python から直接 import

python
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

Actor用途価格
mercari-japan-search-scraperメルカリ日本版の商品検索・価格抽出PPE
yahoo-auctions-japan-scraperヤフオク入札・落札履歴抽出PPE
surugaya-japan-hobby-prices駿河屋(ホビー・TCG)中古価格PPE
japan-kakaku-price-search価格.com の家電・日用品価格比較PPE
rakuten-japan-mcp楽天市場の商品・価格データPPE

中古 / 専門店 Scrapers

Actorカテゴリ
mandarake-auction-scraper万代・中古フィギュア・プラモ
kitamura-japan-used-camera-scraper中古カメラ(キタムラ)
jackroad-used-watch-scraper中古時計(ジャックロード)
komehyo-japan-brand-scraper高級ブランド(こめはよ)
tackleberry-japan-fishing-tackle-scraperフィッシングタックル(タックルベリー)

Japan Market MCP 系列


Quickstart

bash
# 1. クローンgit clone https://github.com/atushi1841/japan-ec-mcp.gitcd japan-ec-mcp
# 2. 依存pip install fastmcp
# 3. stdio mode で起動(Claude Desktop 等から接続)python server.py
# 4. HTTP mode で起動(別プロセスから接続)python server.py --http --port 8000

動作確認

bash
python server.py --http --port 8000 &sleep 2curl -s -X POST http://localhost:8000/mcp/tools/list \  -H "Content-Type: application/json" \  -d '{}' | jq '.tools[].name'

MCP 公開レジストリ登録状況

レジストリ状態備考
MCP 公式レジストリ✅ 登録済みio.github.atushi1841/japan-ec-mcp
Smithery.ai📝 【要ユーザー対応】 未登録mcp/kensho-*/smithery.yaml テンプレあり(本サーバーはテンプレ未作成・要追加)
mcp.so📝 【要ユーザー対応】 未登録YAML テンプレは Kensho 側に mcp_so_configs/ 予定

収益化経路: GitHub README → Smithery(未登録)→ Apify Store(86 Actors・PPE課金)への流入。 Smithery 登録は API で自動実行不可のためユーザー手動操作待ち(【要ユーザー対応】タグ継続)。


収益ゲート(この README の役割)

項目内容
誰が買うMCP クライアント利用者(Claude/Cursor/VS Code + 日本マーケットデータ需要層)
どのチャネルで届くかGitHub README 直接流入 → Smithery / mcp.so(要ユーザー対応)経由で Apify PPE 86本へ
30日で何を測れるかREADME への apify.com リンク数 >= 4(現在 >= 10)・Smithery api 200(未登録継続)
既存何を再利用既存 README(2tools)+ Apify 86 actors URL 群 + smithery.yaml テンプレ

License

MIT License. See Kensho project for the full stack.

來源:README.md,提交 534cace

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 6, 2026