japan-offmall-market-mcp

日本 OffMall 二手商品市场 — Hard Off 官方爬虫

从 OffMall（オフモール）采集二手商品价格。OffMall 是 Hard Off（ハードオフ）的官方在线商店；Hard Off 是日本最大的二手商品连锁店，在全国有 800 多家参与门店。

一个数据集涵盖日本最大的二手商品生态：相机、手表、乐器、奢侈品牌、智能手机、游戏机、音频设备等。

用途

• 汇集 800 多家门店 — OffMall 汇总了日本各地 Hard Off 门店的商品信息（每日更新）
• 每件商品仅有一件 — 每条商品信息都对应一件独一无二的实物，并标注成色等级（S/A/B/C）
• 扫描整个市场 — 可按关键词搜索或扫描整个类别（共 13 个类别）
• 跨店套利 — 通过 Japan Market 系列 Actor，将 OffMall 价格与 Kitamura/Fujiya/Jackroad 的价格进行比较

输入

字段	类型	默认值	说明
searchKeyword	字符串	iPhone	要搜索的关键词（例如：iPhone、ロレックス、ニンテンドー）
category	选择	``	关键词为空时要扫描的类别（カメラ/時計/楽器/ブランド品 等 13 种）
maxItems	整数	100	最多采集的商品数量
maxPages	整数	2	每个来源的最大页数（每页 30 件商品）

输出字段

字段	说明
productId	商品 ID
title	商品名称
brand	品牌（例如：APPLE、Canon、Rolex）
modelCode	型号代码（例如：MWLX2J/A）
price	价格（JPY）
rank	成色等级（S/A/B/C）
imageUrl	商品图片 URL
productUrl	商品页面 URL
shop	OffMall
source	offmall
category	类别标签
scrapedAt	采集时间戳

输出示例

{
  "productId": "6426181",
  "title": "iPhone 11",
  "brand": "APPLE",
  "modelCode": "MWLX2J/A",
  "price": 27500,
  "rank": "B",
  "imageUrl": "https://p1-d9ebd2ee.imageflux.jp/c!/w=231,h=182,a=0,u=0,q=75/201328/2026_08_10_18_26_49.jpg",
  "productUrl": "https://netmall.hardoff.co.jp/product/6426181/",
  "shop": "OffMall",
  "source": "offmall",
  "category": "検索:iPhone",
  "scrapedAt": "2026-08-10T10:10:00Z"
}

定价

按事件付费 — 每次运行 $0.00005 + 每件商品 $0.002。

数据来源说明

• OffMall (netmall.hardoff.co.jp)：Hard Off 官方在线商店，拥有 800 多家参与门店
• 搜索页面由服务端渲染，robots.txt 允许抓取（仅禁止抓取 /api/、/users/、/statics/ 等路径）
• 仅采集事实性商品信息（名称、价格、品牌、成色等级）

MCP 服务与注册表

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

• MCP Registry：io.github.atushi1841/japan-offmall-market-mcp
• Apify Store：https://apify.com/fruitful_quintessence/japan-offmall-market-scraper
• Gumroad：https://atushi5.gumroad.com/l/kutuxe

通过 MCP 安装：将其添加到 MCP 配置中：

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

Smithery

通过 Smithery 安装：

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