Japan E-Commerce & Secondary Market Search MCP

io.github.atushi1841v0.1.0Updated Oct 6, 2026

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

Overview

AI-generated overview

Lets an assistant search Japanese marketplaces such as Mercari, Yahoo Auctions and Suruga-ya for prices and stock, and get resale sourcing guidance.

What it does
The server exposes two tools. search_japan_marketplace takes a keyword and an optional platform (mercari, yahoo, surugaya or all) plus a result limit, and returns a query summary, the platforms searched, and results with platform, search URL, notes and a recommended actor. get_japan_resale_guidance takes a category (tcg, camera, luxury, figure or watch) and keywords, and returns market characteristics, recommended sourcing channels and pointers to related Apify actors.
When to use it
Useful when an assistant needs Japanese marketplace or secondary-market pricing and availability context, or resale sourcing guidance for collectibles, cameras, watches and luxury goods. It is a desktop-only local server, so it suits Claude Desktop, Cursor or VS Code style clients rather than web deployment.
Requirements
Runs as a local process over stdio (or optionally HTTP mode on a chosen port). Needs Python and the fastmcp package installed; the README shows pip install fastmcp and running server.py. No authentication, environment variables or headers are declared. The README notes HTTP mode is planned for 2026-10.
Before you install
The README states the server is intended to be used together with Apify Store actors, which are billed pay-per-event with a free tier, so actual data retrieval may involve paid third-party services. The README also describes a monetization path funnelling users from the README to Apify actors, and lists Smithery and mcp.so registration as pending manual user action. No credentials are requested by the server itself.

Installation

In SourceWeft

  1. Open Japan E-Commerce & Secondary Market Search MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: README.md at commit 534cace

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.0LatestOct 6, 2026