概览
Rakuten 商品详情把一批已知商品页的信息整理成统一明细,覆盖标题、商品编号、店铺、在售状态、SKU 和页面链接,适合日本市场的选品、建档与竞品观察。
每个商品保留采集时的页面快照;没有可用详情时也会留下无数据标记。SKU 信息按来源文本保留,可继续提取颜色、价格和规格。
数据说明
数据来自 Rakuten 商品详情页,按任务商品去重并稳定返回。标题、店铺、在售状态、链接状态和 SKU 都是采集时的页面信息,页面后续变化不会回溯更新。采集时间按来源原文保留且未附时区,创建时间和更新时间使用 Unix 毫秒时间戳。已下架或不可访问的商品可能只带链接与无数据标记。
结果长什么样
每条记录代表一个 Rakuten 商品详情页在采集时的快照:
| 商品编号 | 店铺编号 | 在售状态 | 商品链接 | SPU 编号 |
|---|---|---|---|---|
| 10005020 | 406191 | 在售 | https://item.rakuten.co.jp/alice00/19rdv6003/ | 19rdv6003 |
| 10000405 | 346082 | 在售 | https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/ | dkx55-12ee |
另有业务编号、输入商品链接、主图链接、SPU 编号、SKU 信息、采集时间、更新时间戳、链接状态和无数据标记。
应用场景
- 做商品主档时,用「商品编号」「商品标题」「店铺编号」建目录,以「采集时间」判断资料新旧。
- 做竞品盘点时,按「店铺编号」比较「商品标题」「在售状态」和「链接状态」。
- 做规格价格与完整性检查时,从「SKU 信息」提取规格,并对照「输入商品链接」「是否无数据」。
适用边界
单次最多提交 200 个 Rakuten 商品详情页 URL;每个输入项对应一条详情记录或无数据标记,结果按采集时间稳定返回,不提供业务筛选、聚合或自定义排序。
- 适合用于
- 需要批量获取已知 Rakuten 商品页面的标题、商品编号、店铺、状态和 SKU 信息时
- 需要把多个 Rakuten 商品详情整理成统一明细进行选品或竞品观察时
- 不要用于
- 需要按关键词发现 Rakuten 商品时——本应用只采集已知详情页 URL
- 需要评论、销量或历史价格走势时——本应用只提供商品详情快照
- 需要实时页面状态时——结果反映商品被采集时的页面信息
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回无数据标记时,检查详情页 URL 是否完整、商品是否仍可访问
- 2部分成功时保留已完成商品的数据,并根据任务状态中的失败数量排查对应 URL
- 3限流、超时或服务暂不可用时可稍后用同一 URL 清单重试;鉴权失败、任务上下文不匹配或任务过期时先检查执行环境凭证并重新提交
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- Rakuten 商品详情页
items必填array<object>要采集的 Rakuten 商品详情页完整 URL 清单,每项包含一个商品页地址;一次可提交 1 至 200 项数量最多 200 项示例[{"item":"https://item.rakuten.co.jp/alice00/19rdv6003/"}]
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 业务编号
biz_idstringRakuten 商品详情记录的业务标识,通常为商品详情页 URL示例https://item.rakuten.co.jp/alice00/19rdv6003/ - 评论数量
comment_countstring商品页面展示的评论数量原始文本示例0 - 采集时间
crawl_timestring商品详情被采集的时间原始文本,来源值未附时区示例2026-09-14T11:34:55 - 创建时间戳
created_atinteger记录创建时间的 Unix 毫秒时间戳示例1789356895498
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"biz_id": "https://item.rakuten.co.jp/alice00/19rdv6003/",
"comment_count": "0",
"crawl_time": "2026-09-14T11:34:55",
"created_at": 1789356895498,
"item": "https://item.rakuten.co.jp/alice00/19rdv6003/",
"job_type": "BasicInfo",
"main_image_url": "<main_image_url>",
"platform_code": "rakuten",
"product_id": "10005020",
"product_title": "Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー",
"product_url": "https://item.rakuten.co.jp/alice00/19rdv6003/",
"shop_id": "406191",
"skus": "[{\"discount\": null, \"images\": null, \"originalPrice\": \"34500.0\", \"price\": \"34500.0\", \"skuId\": \"19rdv6003-00\", \"skuName\": \"ミッドナイトブラック\"}]",
"source_name": "rakuten_detail_202609",
"spu_id": "19rdv6003",
"status_code": "在售",
"task_item": "https://item.rakuten.co.jp/alice00/19rdv6003/",
"no_data": false,
"updated_at": 1789356895498,
"url_status": "有效"
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/rakuten-product-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。