japan-car-market-mcp

Goo-net 日本二手车爬虫

从 goo-net.com 抓取二手车信息——这是日本最大的二手车门户网站之一，包含价格、制造商和经销商信息。

为什么需要这些数据

• 日本在 2025 年创下二手车出口纪录，出口量达 171 万辆（JUMVEA），这是一个庞大的全球市场
• 二手车出口商（BE FORWARD、carused.jp、SBT Japan 等）持续需要最新的库存和价格数据
• **JDM（日本国内市场）**车型在全球备受青睐
• 上线时，Apify Store 上没有专门提供跨站刊登服务的竞品

功能

• ✅ 服务端渲染页面（无需浏览器——快速且省钱）
• ✅ 全国库存（47 个都道府县），支持分页
• ✅ 每条信息包含车型名称、价格（JPY）、制造商、图片、经销商店铺和详情 URL
• ✅ 都道府县筛选（例如，01 = 北海道，13 = 东京，47 = 冲绳）
• ✅ 自动处理 EUC-JP 编码
• ✅ 通过 Apify 代理运行——不会遇到 IP 封锁问题

输入

字段	类型	默认值	描述
searchKeyword	string	empty	车型 / 品牌关键词（例如，ハイエース、アクア）。留空 = 扫描全部
statsMode	boolean	false	true = 返回汇总价格统计数据，而非车辆信息
statsKeyword	string	empty	要汇总的车型名称（例如，N-BOX、ハイエース）
prefecture	string	empty	都道府县代码 01–47。留空 = 日本全国
maxItems	integer	100	最多采集的信息条数
maxPages	integer	5	最多抓取的页数
proxyConfiguration	object	auto	Apify 代理（自动）

输出

每条记录包含：itemId、title、maker、price（JPY）、imageUrl、detailUrl、shop、source、scrapedAt。

示例：

{
  "itemId": "988026080400207235003",
  "title": "ハイエースバン スーパーGL",
  "maker": "トヨタ",
  "price": 2796000,
  "detailUrl": "https://www.goo-net.com/usedcar/spread/goo/15/988026080400207235003.html",
  "shop": "ハイエース／キャラバン専門店 ファイントラスト土岐店",
  "source": "goo-net"
}

使用场景

• 🚗 二手车出口商和进口商（库存跟踪、价格调研）
• 📊 市场研究人员（JDM 市场趋势、价格分析）
• 🔍 寻找特定车型的 JDM 爱好者

价格统计 API 模式（相場統計API）

同一个 Actor 也可作为价格统计 API用于市场调研——无需下载完整车辆信息，即可返回特定车型的汇总价格统计数据。

请求（Apify 同步 API）：

curl -X POST "https://api.apify.com/v2/acts/bgm5Gxn4BeBmoO7xD/run-sync-get-dataset-items?token=YOUR_TOKEN&timeout=120" \
  -H "Content-Type: application/json" \
  -d '{"statsMode": true, "statsKeyword": "N-BOX", "maxItems": 30, "maxPages": 1}'

响应（JSON）：

{
  "statsType": "goo-net-car-price",
  "keyword": "N-BOX",
  "count": 5,
  "priceMin": 230000,
  "priceMax": 1907000,
  "priceAvg": 974400,
  "priceMedian": 596000,
  "sampleItems": [{"title": "...", "price": 230000, "detailUrl": "...", "shop": "..."}]
}

• statsKeyword：车型名称（例如，N-BOX、ハイエース）。自动处理全角 / 半角匹配
• 可与 bodyType 组合以缩小范围（例如，KEI、SUV）
• 使用场景：市场调研、经销商定价基准、出口估值

定价

按结果付费：每条记录 $0.002（每 1,000 条信息 $2）。

法律声明

• 遵守 goo-net 的 robots.txt（搜索端点除外；允许访问分类页面）
• 仅用于研究和合法商业用途。用于商业用途前，请查看 goo-net 的条款。
• 按设计进行速率限制（重试 3 次，采用指数退避）。

技术栈

• Python 3.11 + httpx + BeautifulSoup
• Apify Actor SDK v3
• 支持 EUC-JP 解码

MCP 服务与注册表

此爬虫也可作为 MCP 服务供 AI Agent 使用：

• MCP 注册表：io.github.atushi1841/japan-car-market-mcp
• Apify Store：https://apify.com/fruitful_quintessence/goo-net-car-scraper
• Gumroad：https://atushi5.gumroad.com/l/kutuxe

通过 MCP 安装：将以下内容添加到 MCP 配置中：

{"mcpServers": {"japan-car-market-mcp": {"command": "python3", "args": ["src/stdio_main.py"]}}}

Smithery

通过 Smithery 安装：

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