Japan E-Commerce & Secondary Market Search MCP

日本EC-MCP (japan-ec-mcp)

日本电商与二级市场搜索：MCP 服务

这是一个 Model Context Protocol (MCP) 服务，可通过 Claude / Cursor / VS Code 等 AI 客户端，直接查询日本主要市场平台（Mercari、Yahoo Auctions、骏河屋、乐天、价格.com）的价格、库存和趋势。

• 作者：atushi1841
• 许可证：MIT
• MCP 规范：FastMCP 2.x（同时支持 stdio / HTTP）
• 相关项目：Kensho：数据采集与分析基础设施

---

工具（MCP 工具列表）

工具名称	功能	目标平台
search_japan_marketplace	按关键词跨平台搜索商品价格与库存	Mercari、Yahoo Auctions、Suruga-ya
get_japan_resale_guidance	二手转售市场采购指南（TCG / 相机 / 高级腕表 / 高端品牌 / 手办）	5 个类别

工具 1：search_japan_marketplace

result = await mcp.call_tool(
    "search_japan_marketplace",
    {"keyword": "ポケモンカード 151", "platform": "all", "limit": 10}
)

• platform："mercari" | "yahoo" | "surugaya" | "all"（默认：all）
• 返回值：{query, platforms_searched, results: [{platform, search_url, notes, recommended_actor}]}

工具 2：get_japan_resale_guidance

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：

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

2. HTTP 服务模式

cd japan-ec-mcp
pip install fastmcp
python server.py --http --port 8000

检查 HTTP 端点：

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

3. 从 Python 直接导入

from japan_ec_mcp.server import mcp
# FastMCP インスタンスを直接組み込める

4. 从 n8n / Apify 工作流调用（通过 HTTP）

可使用 Apify 的 Webhook 节点，向 POST /mcp 发送 JSON-RPC。 （示例工作流正在开发中；MCP 的 HTTP mode 将于 2026-10 实现）

---

相关 Apify Actor

此 MCP 服务与 Apify Store 的 86 个 Actors 协同工作，需要实际获取数据时，建议搭配相应的 Actor 使用。采用 PPE（按事件付费）计费，并提供免费额度。

主力市场平台爬虫

Actor	用途	价格
mercari-japan-search-scraper	搜索 Mercari 日本版商品并提取价格	PPE
yahoo-auctions-japan-scraper	提取 Yahoo Auctions 的竞拍与成交记录	PPE
surugaya-japan-hobby-prices	骏河屋（爱好品、TCG）二手价格	PPE
japan-kakaku-price-search	价格.com 家电与日用品比价	PPE
rakuten-japan-mcp	乐天市场的商品与价格数据	PPE

二手商品与专卖店爬虫

Actor	类别
mandarake-auction-scraper	万代、二手手办与模型
kitamura-japan-used-camera-scraper	二手相机（Kitamura）
jackroad-used-watch-scraper	二手腕表（Jackroad）
komehyo-japan-brand-scraper	高端品牌（Komehyo）
tackleberry-japan-fishing-tackle-scraper	钓鱼装备（Tackleberry）

Japan Market MCP 系列

• japan-market-mcp，综合宏观经济与市场数据
• japan-anime-figure-price-data，动漫手办价格
• japan-anime-figure-demand-features，动漫手办需求特征

---

快速开始

# 1. クローン
git clone https://github.com/atushi1841/japan-ec-mcp.git
cd japan-ec-mcp

# 2. 依存
pip install fastmcp

# 3. stdio mode で起動（Claude Desktop 等から接続）
python server.py

# 4. HTTP mode で起動（別プロセスから接続）
python server.py --http --port 8000

验证运行

python server.py --http --port 8000 &
sleep 2
curl -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	✅ 已登记	atushi1841/japan_ec_mcp
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（需要用户操作）导向 86 个 Apify PPE
30 天内可以衡量什么	README 中指向 apify.com 的链接数 >= 4（当前 >= 10）・Smithery API 200（持续未注册）
已有内容如何复用	现有 README（2 个工具）+ Apify 86 个 actors URL 群组 + smithery.yaml 模板

---

许可证

MIT License。完整技术栈请参阅 Kensho 项目。

通过 Smithery 安装

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

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

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

或者，直接从 Smithery 注册表 安装。

注意： Smithery 服务列表正在等待验证。验证通过后，此服务将出现在搜索结果中，并跟踪 useCount。

已注册到 MCP 官方注册表

本服务已在 MCP 官方注册表中注册为 io.github.atushi1841/japan-anime-figure-mcp（status: active）。

# レジストリでの登録確認
curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=atushi1841" | grep -o "\"io.github.atushi1841/japan-anime-figure-mcp\""

---

数据与商店

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