japan-market-mcp

Japan Market MCP — AI エージェント向けショップ横断価格比較

AI エージェント（Claude、Cursor、VS Code Copilot、ChatGPT）が、1 回のツール呼び出しで日本の主要ショップ間の中古品価格を比較できる MCP サーバーです。サイトごとにスクレイピングする代わりに、エージェントは 1 つのサーバーにクエリを送り、同じ商品のショップ間の価格差を取得します。日本の中古市場における 転売による裁定取引、価格モニタリング、市場調査に最適です。

仕組み

このサーバーは、市場スクレイピングおよび公式 API のアクター（楽天市場を含む）を 1 つの MCP エンドポイントの背後にまとめています。各ツールは、商品ごとに価格、ブランド、ショップ、状態、リンクを返し、ショップの組み合わせを横断して価格差をひと目で確認できます。

利用可能なツール

ツール	市場	ショップの組み合わせ
search_camera_market	中古カメラ・レンズ	キタムラ + フジヤカメラ
search_watch_market	高級腕時計	ジャックロード + キタムラ中古時計
search_luxury_market	中古高級ブランド品	コメ兵 + ジャックロード
search_instrument_market	中古楽器	デジマート + イシバシ U-BOX
search_offmall_market	一般中古品	OffMall（ハードオフ公式、800 店舗以上）
search_kakaku_prices	新品の価格比較	Kakaku.com（数千店舗の集約情報）
search_car_market	中古車	goo-net（全国、ボディタイプ別）
search_car_price_stats	中古車の価格統計（JPY の最低／最高／平均／中央値）	goo-net（車種キーワード別、例：N-BOX、Alphard）
search_rakuten_items	新品（公式 API）	楽天市場（キーワード、価格帯、並べ替え）
get_rakuten_ranking	売れ筋ランキング（公式 API）	楽天市場（総合またはジャンル別）
get_maff_market_report	青果卸売市場レポート（農林水産省の公式オープンデータ）	日本の中央卸売市場（旬別、JPY/100kg、前年比%）
search_maff_price_trend	青果卸売価格の推移（農林水産省の公式オープンデータ）	複数市場、複数期間の比較
get_maff_top_movers	青果の前年比価格変動（農林水産省の公式オープンデータ）	日本の中央卸売市場（供給ショックの兆候）
get_maff_markets	農林水産省の卸売市場一覧	無料

各ツールはキーワード（例：SONY α7、ROLEX、Hermes、Fender）を受け取り、組み合わせ対象のショップから結果を返します。キーワードを空欄にすると、カテゴリ全体を検索します。

料金

イベントごとの従量課金です。検索 1 回あたり $0.001に加えて、アクターの起動料金がかかります。数秒で完了するため、通常、キーワードを 1 つ検索するコストは $0.01 を大きく下回ります。

MCP サーバーとして接続する

Apify Store から実行し（Run ボタン）、MCP クライアントをエンドポイントに接続します。スタンバイモードで待機します。

MCP クライアントの設定（Claude Desktop / Cursor / VS Code）：

{
  "mcpServers": {
    "japan-market-mcp": {
      "url": "https://fruitful-quintessence--japan-market-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

• URL：<your-username>--japan-market-mcp.apify.actor/mcp
• 認証：Authorization: Bearer ヘッダーに Apify API トークンを指定します（Apify Console → Settings → Integrations）

**URL に関する注意：**ユーザー名にはアンダースコアではなくハイフンを使用してください（fruitful-quintessence）。ホスト名にアンダースコアを含めると名前解決できません。

ディスカバリーとレジストリ

• エージェント向けインストールガイド：llms-install.md を参照してください。このサーバーをユーザー向けにセットアップする AI エージェント（Cline、Claude Code、Cursor）向けの、根拠に基づいたガイダンスです。
• MCP ディスカバリーマニフェスト：.well-known/mcp.json で、標準の MCP Directory ディスカバリー形式に従ってエンドポイント、認証、ツール一覧、料金を公開しています。
• Cline MCP Marketplace：cline/mcp-marketplace に審査を申請済みです。承認されると、Cline のマーケットプレイスからワンクリックでインストールできるようになります。
• **Apify Store：**公開アクター fruitful_quintessence/japan-market-mcp としてデプロイされています（イベントごとの従量課金）。

関連する Apify アクター

この MCP サーバーは、リアルタイムデータを取得するため、Kensho エコシステム内の 86 以上の Apify アクターに接続します。主な関連アクターは次のとおりです。

Marketplace & Price Comparison

• fruitful_quintessence/japan-market-mcp — Core MCP server
• fruitful_quintessence/japan-anime-figure-price-data — Anime figure prices
• fruitful_quintessence/japan-figure-plamo-resale-price-stats — Figure/plamo resale stats
• fruitful_quintessence/japan-minimum-wage-mcp — Minimum wage data
• fruitful_quintessence/japan-food-delivery-mcp — Food delivery prices

Retail & E-commerce

• fruitful_quintessence/rakuten-japan-mcp — Rakuten Ichiba data
• fruitful_quintessence/japan-kakaku-price-search — Kakaku.com price comparison
• fruitful_quintessence/amazon-japan-bestsellers — Amazon JP bestsellers
• fruitful_quintessence/yahoo-shopping-japan — Yahoo! Shopping
• fruitful_quintessence/mercari-japan-price — Mercari pricing

Used Goods & Auctions

• fruitful_quintessence/yahoo-auctions-japan-scraper — Yahoo! Auctions
• fruitful_quintessence/mercari-japan-search-scraper — Mercari search
• fruitful_quintessence/surugaya-japan-hobby-prices — Suruga-ya hobby
• fruitful_quintessence/mandarake-auction-scraper — Mandarake auction
• fruitful_quintessence/off-mall-japan-scraper — OffMall (Hard Off)

Local Business & Services

• fruitful_quintessence/google-maps-japan-reviews — Google Maps reviews
• fruitful_quintessence/tabelog-japan-restaurants — Tabelog restaurants
• fruitful_quintessence/hotpepper-beauty-salons — Beauty salons
• fruitful_quintessence/japan-post-office-locations — Post offices

Government & Public Data

• fruitful_quintessence/japan-maff-markets — MAFF wholesale markets
• fruitful_quintessence/japan-maff-price-trend — MAFF price trends
• fruitful_quintessence/japan-maff-top-movers — MAFF top movers
• fruitful_quintessence/japan-maff-market-report — MAFF market reports

特化型コレクション

• fruitful_quintessence/japan-anime-figure-demand-features — アニメフィギュアの需要
• fruitful_quintessence/japan-vintage-clothing-prices — ヴィンテージ衣料
• fruitful_quintessence/japan-used-book-prices — 古本
• fruitful_quintessence/japan-record-store-prices — レコードショップ
• fruitful_quintessence/japan-toy-collector-prices — コレクター向け玩具

MCP 接続例

6. 外部実行の例（フォールバック）

# If GitHub API returns 403, use curl + git clone
curl -s https://raw.githubusercontent.com/atushi1841/japan-market-mcp/main/README.md > README.patch
# edit README.patch as needed
git clone https://github.com/atushi1841/japan-market-mcp.git
cd japan-market-mcp
cp ../README.patch README.md
git add README.md
git commit -m "update README via external run"
git push

1. 標準入出力（stdio）— Claude Desktop、Cursor など

claude_desktop_config.json に記述します。

{
  "mcpServers": {
    "japan-market-mcp": {
      "command": "python",
      "args": ["-m", "src.main"]
    }
  }
}

2. HTTP サーバーモード

# Install dependencies
pip install -r requirements.txt

# Run as HTTP server on port 3000
APIFY_TOKEN=your_token python -m src.main --http --port 3000

# Test the endpoint
curl http://localhost:3000/mcp/tools | jq .

3. Python から直接インポート

from src.main import mcp
# FastMCP instance can be embedded directly

4. n8n / Apify ワークフロー（HTTP 経由）

Apify の Webhook ノードを使用して、POST /mcp エンドポイントに JSON-RPC を POST します。

5. Docker デプロイ

docker build -t japan-market-mcp .
docker run -p 3000:3000 -e APIFY_TOKEN=your_token japan-market-mcp

"Compare used prices for Sony a7 III between Kitamura and Fujiya"
→ search_camera_market(keyword="SONY α7 III")

"What's the inter-store price gap for a Rolex Submariner?"
→ search_watch_market(keyword="ROLEX Submariner")

"What's the market price for a Hermes Birkin 25?"
→ search_luxury_market(keyword="Hermes Birkin 25")

"What's a used Fender Stratocaster going for?"
→ search_instrument_market(keyword="Fender Stratocaster")

"Show this 旬's wholesale market report for Tokyo (Toyosu) fresh vegetables"
→ get_maff_market_report(market="toyosu")

"Which fresh produce items have spiked in price vs last year at Osaka?"
→ get_maff_top_movers(market="oosakaho")

"Track the price of daikon (だいこん) across Tokyo and Osaka this month"
→ search_maff_price_trend(item="だいこん", markets=["toyosu","oosakaho"])

ユースケース

• 転売の裁定取引 — ショップ間で同じ商品に異なる価格が付いているものを見つけます
• 市場調査 — カメラ、時計、高級品、楽器、自動車の中古価格を追跡します
• 輸出向け仕入れ — 輸出業者向けの goo-net の JDM 在庫および goo-net の価格確認
• コレクター向け価格確認 — OffMall の商品を状態別にランク付けした中古品の価格を確認します

データソース

• 各アクターが収集するのは事実データのみ（商品名、価格、ブランド、状態、在庫、URL）です。写真や説明文は収集しません。
• 対象サイトはすべて、robots.txt でクロールが許可されています。
• MAFF 青果物卸売市場調査（旬別・市場別） は、農林水産省の公式オープンデータ CSV から提供されています。スクレイピングは行わず、直接ダウンロードします。政府標準利用規約2.0 に基づいて公開されており、出典を明記すれば商用利用が可能です。価格の単位は100kgあたりの日本円です。データは MAFF により旬（10日間）ごとに更新されます。

ローカル開発

pip install -r requirements.txt
APIFY_TOKEN=apify_api_xxx python -m src.main
# Streamable HTTP endpoint at http://localhost:3000/mcp

ライセンス

MIT

Smithery 経由でインストール

次のコマンドを1つ実行するだけで、この MCP サーバーを AI クライアント（Claude Desktop、Cursor、VS Code）に接続できます。

npx @smithery/cli install atushi1841/japan-market-mcp --client claude

他のクライアントでは、claude を cursor、vscode、または cline に置き換えてください。

または、Smithery レジストリから直接インストールしてください。

注： Smithery でのサーバー掲載は、現在確認待ちです。確認が完了すると、このサーバーが検索結果に表示され、useCount の追跡が行われます。

---

データとストア

• Apify Store： https://apify.com/fruitful_quintessence
• Gumroad データセット： https://atushi5.gumroad.com/l/kutuxe