logo

Rakuten 商品详情

给一组 Rakuten 商品详情页 URL,返回商品标题、品牌标识、店铺、状态和 SKU 等详情信息

概览

Rakuten 商品详情把一批已知商品页的信息整理成统一明细,覆盖标题、商品编号、店铺、在售状态、SKU 和页面链接,适合日本市场的选品、建档与竞品观察。

每个商品保留采集时的页面快照;没有可用详情时也会留下无数据标记。SKU 信息按来源文本保留,可继续提取颜色、价格和规格。

数据说明

数据来自 Rakuten 商品详情页,按任务商品去重并稳定返回。标题、店铺、在售状态、链接状态和 SKU 都是采集时的页面信息,页面后续变化不会回溯更新。采集时间按来源原文保留且未附时区,创建时间和更新时间使用 Unix 毫秒时间戳。已下架或不可访问的商品可能只带链接与无数据标记。

结果长什么样

每条记录代表一个 Rakuten 商品详情页在采集时的快照:

商品编号店铺编号在售状态商品链接SPU 编号
10005020406191在售https://item.rakuten.co.jp/alice00/19rdv6003/19rdv6003
10000405346082在售https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/dkx55-12ee

另有业务编号、输入商品链接、主图链接、SPU 编号、SKU 信息、采集时间、更新时间戳、链接状态和无数据标记。

应用场景

  • 做商品主档时,用「商品编号」「商品标题」「店铺编号」建目录,以「采集时间」判断资料新旧。
  • 做竞品盘点时,按「店铺编号」比较「商品标题」「在售状态」和「链接状态」。
  • 做规格价格与完整性检查时,从「SKU 信息」提取规格,并对照「输入商品链接」「是否无数据」。

适用边界

单次最多提交 200 个 Rakuten 商品详情页 URL;每个输入项对应一条详情记录或无数据标记,结果按采集时间稳定返回,不提供业务筛选、聚合或自定义排序。

  • 适合用于
  • 需要批量获取已知 Rakuten 商品页面的标题、商品编号、店铺、状态和 SKU 信息时
  • 需要把多个 Rakuten 商品详情整理成统一明细进行选品或竞品观察时
  • 不要用于
  • 需要按关键词发现 Rakuten 商品时——本应用只采集已知详情页 URL
  • 需要评论、销量或历史价格走势时——本应用只提供商品详情快照
  • 需要实时页面状态时——结果反映商品被采集时的页面信息

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1返回无数据标记时,检查详情页 URL 是否完整、商品是否仍可访问
  2. 2部分成功时保留已完成商品的数据,并根据任务状态中的失败数量排查对应 URL
  3. 3限流、超时或服务暂不可用时可稍后用同一 URL 清单重试;鉴权失败、任务上下文不匹配或任务过期时先检查执行环境凭证并重新提交

输入参数

调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
itemsRakuten 商品详情页array<object>是—最多 200 项[{"item":"https://item.rakuten.co.jp/alice00/19rdv6003/"}]要采集的 Rakuten 商品详情页完整 URL 清单,每项包含一个商品页地址;一次可提交 1 至 200 项

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
biz_id业务编号stringhttps://item.rakuten.co.jp/alice00/19rdv6003/Rakuten 商品详情记录的业务标识,通常为商品详情页 URL
comment_count评论数量string0商品页面展示的评论数量原始文本
crawl_time采集时间string2026-09-14T11:34:55商品详情被采集的时间原始文本,来源值未附时区
created_at创建时间戳integer1789356895498记录创建时间的 Unix 毫秒时间戳
item输入商品链接stringhttps://item.rakuten.co.jp/alice00/19rdv6003/本条详情记录对应的输入商品详情页 URL
job_type采集类型stringBasicInfo商品详情记录对应的采集类型原文
main_image_url主图链接string—商品主图链接;来源没有图片时为空
platform_code平台代码stringrakuten商品所属平台代码
product_id商品编号string10005020Rakuten 商品编号
product_title商品标题stringAnker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー商品详情页展示的完整标题
product_url商品链接stringhttps://item.rakuten.co.jp/alice00/19rdv6003/商品详情页链接
shop_id店铺编号string406191销售该商品的店铺标识
skusSKU 信息string[{"discount": null, "images": null, "originalPrice": "34500.0", "price": "34500.0", "skuId": "19rdv6003-00", "skuName": "ミッドナイトブラック"}]商品 SKU、价格和规格信息的 JSON 文本,保留来源原文
source_name来源名称stringrakuten_detail_202609详情记录携带的来源数据名称
spu_idSPU 编号string19rdv6003商品所属标准产品单元的标识
status_code在售状态string在售商品被采集时页面展示的销售状态
task_item任务商品stringhttps://item.rakuten.co.jp/alice00/19rdv6003/本条结果对应的任务商品 URL,也是稳定的记录标识
no_data是否无数据booleanfalse该商品是否未采集到可用详情
updated_at更新时间戳integer1789356895498记录更新时间的 Unix 毫秒时间戳
url_status链接状态string有效商品详情页链接被采集时的有效状态原文

记录 Schema

输出按记录逐条返回。记录主键为 task_item,去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "业务编号",
      "description": "Rakuten 商品详情记录的业务标识,通常为商品详情页 URL",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "comment_count": {
      "type": "string",
      "title": "评论数量",
      "description": "商品页面展示的评论数量原始文本",
      "prefill": "0"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "商品详情被采集的时间原始文本,来源值未附时区",
      "prefill": "2026-09-14T11:34:55"
    },
    "created_at": {
      "type": "integer",
      "title": "创建时间戳",
      "description": "记录创建时间的 Unix 毫秒时间戳",
      "prefill": 1789356895498
    },
    "item": {
      "type": "string",
      "title": "输入商品链接",
      "description": "本条详情记录对应的输入商品详情页 URL",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "job_type": {
      "type": "string",
      "title": "采集类型",
      "description": "商品详情记录对应的采集类型原文",
      "prefill": "BasicInfo"
    },
    "main_image_url": {
      "type": "string",
      "title": "主图链接",
      "description": "商品主图链接;来源没有图片时为空"
    },
    "platform_code": {
      "type": "string",
      "title": "平台代码",
      "description": "商品所属平台代码",
      "prefill": "rakuten"
    },
    "product_id": {
      "type": "string",
      "title": "商品编号",
      "description": "Rakuten 商品编号",
      "prefill": "10005020"
    },
    "product_title": {
      "type": "string",
      "title": "商品标题",
      "description": "商品详情页展示的完整标题",
      "prefill": "Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー"
    },
    "product_url": {
      "type": "string",
      "title": "商品链接",
      "description": "商品详情页链接",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "shop_id": {
      "type": "string",
      "title": "店铺编号",
      "description": "销售该商品的店铺标识",
      "prefill": "406191"
    },
    "skus": {
      "type": "string",
      "title": "SKU 信息",
      "description": "商品 SKU、价格和规格信息的 JSON 文本,保留来源原文",
      "prefill": "[{\"discount\": null, \"images\": null, \"originalPrice\": \"34500.0\", \"price\": \"34500.0\", \"skuId\": \"19rdv6003-00\", \"skuName\": \"ミッドナイトブラック\"}]"
    },
    "source_name": {
      "type": "string",
      "title": "来源名称",
      "description": "详情记录携带的来源数据名称",
      "prefill": "rakuten_detail_202609"
    },
    "spu_id": {
      "type": "string",
      "title": "SPU 编号",
      "description": "商品所属标准产品单元的标识",
      "prefill": "19rdv6003"
    },
    "status_code": {
      "type": "string",
      "title": "在售状态",
      "description": "商品被采集时页面展示的销售状态",
      "prefill": "在售"
    },
    "task_item": {
      "type": "string",
      "title": "任务商品",
      "description": "本条结果对应的任务商品 URL,也是稳定的记录标识",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "no_data": {
      "type": "boolean",
      "title": "是否无数据",
      "description": "该商品是否未采集到可用详情",
      "prefill": false
    },
    "updated_at": {
      "type": "integer",
      "title": "更新时间戳",
      "description": "记录更新时间的 Unix 毫秒时间戳",
      "prefill": 1789356895498
    },
    "url_status": {
      "type": "string",
      "title": "链接状态",
      "description": "商品详情页链接被采集时的有效状态原文",
      "prefill": "有效"
    }
  },
  "required": [],
  "additionalProperties": false
}

调用方式

本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。

通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "mona_kk__rakuten-product-detail": {
      "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)。

价格

提交一次商品详情任务

每提交一次任务计费一次,与返回条数无关。

¥0.001/ 次
返回一条商品详情

按实际成功返回的数据条数计费,任务失败不计费。

¥0.015/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
登录后返回,确认参数再提交运行。
¥0.015 / 条