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