japan-market-mcp

日本市场 MCP — 面向 AI Agent 的跨店价格比较

一个 MCP 服务，让 AI Agent（Claude、Cursor、VS Code Copilot、ChatGPT）通过一次工具调用，即可比较日本主要商店中二手商品的价格。Agent 无需逐个抓取网站，只需查询一个服务，即可获取同一商品在不同商店之间的价格差——非常适合在日本二手市场进行转售套利、价格监控和市场调研。

工作原理

该服务将市场数据抓取和官方 API Actor 封装在一个 MCP 端点后（包括 Rakuten Ichiba）。每个工具都会返回商品的价格、品牌、商店、成色和链接，并交叉比对各商店，让你一眼看出价格差。

可用工具

工具	市场	商店组合
search_camera_market	二手相机和镜头	Kitamura + Fujiya Camera
search_watch_market	奢侈手表	Jackroad + Kitamura 二手手表
search_luxury_market	二手奢侈品牌商品	Komehyo + Jackroad
search_instrument_market	二手乐器	Digimart + Ishibashi U-BOX
search_offmall_market	综合二手商品	OffMall（Hard Off 官方，800 多家门店）
search_kakaku_prices	新品价格比较	Kakaku.com（汇总数千家商店）
search_car_market	二手车	goo-net（全国范围，按车身类型筛选）
search_car_price_stats	二手车价格统计（最低／最高／平均／中位数，日元）	goo-net（按车型关键词筛选，例如 N-BOX、Alphard）
search_rakuten_items	零售新品（官方 API）	Rakuten Ichiba 楽天市場（关键词、价格范围、排序）
get_rakuten_ranking	畅销商品排名（官方 API）	Rakuten Ichiba 楽天市場（综合或按品类）
get_maff_market_report	生鲜农产品批发市场报告（MAFF 官方开放数据）	日本中央批发市场（旬别，日元／100kg，同比百分比）
search_maff_price_trend	生鲜农产品批发价格趋势（MAFF 官方开放数据）	多市场、多时段比较
get_maff_top_movers	生鲜农产品同比价格变动排名（MAFF 官方开放数据）	日本中央批发市场（供应冲击信号）
get_maff_markets	可用的 MAFF 批发市场列表	免费

每个工具都接受一个关键词（例如 SONY α7、ROLEX、Hermes、Fender），并返回来自交叉比对商店的结果。关键词留空则会扫描整个品类。

定价

按事件付费——每次搜索 $0.001，另加 Actor 启动费。运行仅需几秒，因此完整的关键词查询通常不到 $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），不要使用下划线——带下划线的主机名无法解析。

发现与注册表

• **Agent 安装指南：**参阅 llms-install.md——为 AI Agent（Cline、Claude Code、Cursor）提供可靠的指导，帮助其为用户配置此服务。
• MCP 发现清单：.well-known/mcp.json 按标准 MCP Directory 发现格式公布端点、身份验证方式、工具列表和定价。
• **Cline MCP Marketplace：**已提交至 cline/mcp-marketplace 等待审核——审核通过后，即可从 Cline 的市场一键安装。
• **Apify Store：**已部署为公开 Actor fruitful_quintessence/japan-market-mcp（按事件付费）。

相关 Apify Actor

此 MCP 服务连接到 Kensho 生态系统中的 86 个以上 Apify Actor，以获取实时数据。相关的主要 Actor 包括：

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 端点发送 POST JSON-RPC 请求。

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 上按成色排序的实体二手商品

数据来源

• 每个 actor 仅收集事实数据（商品名称、价格、品牌、成色、库存、URL）。不会采集照片或描述。
• 所有目标网站均允许通过其 robots.txt 进行爬取。
• MAFF 青果物卸売市場調査（旬別・市場別） 数据来自日本农林水产省官方开放数据 CSV，无需抓取，可直接下载。该数据依据政府标准利用条款 2.0（政府標準利用規約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 安装

只需一条命令，即可将此 MCP 服务连接到你的 AI 客户端（Claude Desktop、Cursor、VS Code）：

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

对于其他客户端，请将 claude 替换为 cursor、vscode 或 cline。

或者，直接从 Smithery registry 安装。

注意： Smithery 服务列表正等待审核。审核通过后，此服务将在搜索结果中显示，并跟踪 useCount。

---

数据与商店

• Apify Store： https://apify.com/fruitful_quintessence
• Gumroad 数据集： https://atushi5.gumroad.com/l/kutuxe