logo

Rakuten 商品评论

给一个 Rakuten 商品详情页链接和期望评论条数,返回商品评论及其商品、用户与时间信息

概览

Rakuten 商品评论呈现买家体验、使用场景和售后感受。App 根据商品详情页链接返回评论正文、评分、发布时间及商品、用户信息,形成口碑明细。

它保留评论编号、父评论关系和图片文本,方便把分散反馈放在同一张底表中观察。评论数量是期望值,实际结果遵循来源平台的完整批次规则。

数据说明

数据来自 Rakuten 商品详情页的评论区,评论编号用于识别同一条评论,父评论编号用于保留回复关系。评分和评论类型保留原始文本,图片和视频链接列表也保留为原始文本;创建时间和更新时间是毫秒时间戳,发布时间保留来源中的时间表现。评论标题、销售属性和用户信息可能为空。

结果长什么样

每条记录代表一条 Rakuten 商品评论:

评论编号评分评论正文评论标题发布时间
ce889f82-c853-11f0-a58b-005056a73e5f5ロボット掃除機を導入して数週間が経ちますが、買って良かったと感じています。とても良い買い物2025-11-23T00:00:00
adb39f3c9a29f5906efa1e00dff5c3de丁寧で詳細なレビューをお寄せくださいましてありがとうございます。2025-11-28T00:00:00

另有商品链接、店铺信息、评论标题、用户名称、父评论编号、图片和视频链接等字段。

应用场景

  • 做商品口碑体检时,结合「评分」和「评论正文」统计正负反馈,定位体验问题。
  • 做评论主题整理时,按「评论标题」「评论正文」归纳商品的优点、缺点和使用场景。
  • 做评论关系分析时,使用「评论编号」「父评论编号」还原买家评论与商家回复的关联。
  • 做时间趋势观察时,按「发布时间」汇总评论数量,比较反馈变化。

适用边界

单次任务处理 1 个 Rakuten 商品详情页链接,可指定期望采集的评论条数;实际评论条数可能按完整批次高于期望值;当前拉取保护容量约为 1000 条;仅覆盖接口可采集到的商品评论。

  • 适合用于
  • 需要获取指定 Rakuten 商品的评论正文、评分和发布时间时
  • 需要分析 Rakuten 商品的买家反馈、评论层级和用户信息时
  • 不要用于
  • 需要一次处理多个商品时——本 App 每次任务只接受一个商品详情页链接
  • 需要商品价格、库存或订单数据时——本 App 只提供商品评论及其关联信息

失败处理

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

  1. 1返回无数据记录时,先确认商品详情页链接准确且页面存在可采集评论
  2. 2任务部分成功时可使用已返回的评论记录,实际条数可能少于期望值
  3. 3任务失败、过期、限流或请求超时时,核对商品链接后再重新提交
  4. 4鉴权失败、任务不存在或任务上下文不匹配时,先检查执行环境凭证和调用配置

输入参数

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

字段名业务名称类型必填默认值枚举 / 约束示例说明
rakuten_item_urlRakuten 商品详情页链接string是——https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/要采集评论的 Rakuten 商品详情页完整 URL,必须以 https://item.rakuten.co.jp/ 开头,长度不超过 512 个字符。
comment_limit期望采集评论条数string是——2填写正整数文本作为期望采集数量;结果按上游完整批次返回,实际评论条数可能高于该值。当前拉取保护容量约为 1000 条,超过该容量时结果可能不完整。

输出数据

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

字段名业务名称类型示例说明
biz_id商品标识stringhttps://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/评论所属商品的 Rakuten 商品详情页链接;无值时上游返回空值。
comment_id评论编号stringce889f82-c853-11f0-a58b-005056a73e5f评论的唯一编号;无值时上游返回空值。
comment_text评论正文stringロボット掃除機を導入して数週間が経ちますが、買って良かったと感じています。买家评论的完整正文;无值时上游返回空值。
comment_time_raw原始评论日期string2025/11/23来源中的原始评论日期文本;无值时上游返回空值。
comment_title评论标题stringとても良い買い物买家为评论填写的标题;无值时上游返回空值。
comment_type评论类型string1上游提供的评论类型编码;无值时上游返回空值。
crawl_time采集时间string2026-09-14T14:07:08平台采集该评论的时间文本;无值时上游返回空值。
created_at创建时间戳integer1789366028130评论记录的 Unix 毫秒时间戳;无值时上游返回空值。
image_url_list评论图片string[]评论图片链接列表的原始 JSON 文本;无值时上游返回空值。
item_image_url_list商品图片string[]评论关联商品图片链接列表的原始 JSON 文本;无值时上游返回空值。
item_sale_prop商品销售属性string—评论关联商品的销售属性原始文本;无值时上游返回空值。
job_type任务类型stringComment上游返回的任务类型标识。
level_name层级名称stringoctopus上游返回的评论层级名称;无值时上游返回空值。
parent_comment_id父评论编号string0该评论直接回复的父评论编号,根评论通常为 0;无值时上游返回空值。
platform_code平台编码stringrakuten评论来源平台编码。
product_title商品标题string—评论关联的商品标题;无值时上游返回空值。
product_url商品链接stringhttps://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/评论关联商品的 Rakuten 商品详情页链接;无值时上游返回空值。
publish_time发布时间string2025-11-23T00:00:00评论在来源平台显示的发布时间文本;无值时上游返回空值。
rating_score评分string5来源平台提供的评分文本,通常为 1 至 5 的整数;无值时上游返回空值。
sale_prop销售属性string—评论对应的商品销售属性原始文本;无值时上游返回空值。
shop_id店铺编号string346082Rakuten 店铺编号;无值时上游返回空值。
shop_name店铺名称string—Rakuten 店铺名称;无值时上游返回空值。
site_code站点编码string.co.jpRakuten 站点后缀编码。
sku_idSKU 编号string10000405评论对应的 SKU 编号;无值时上游返回空值。
spu_idSPU 编号string—评论对应的 SPU 编号;无值时上游返回空值。
task_item任务商品链接stringhttps://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/提交任务时使用的 Rakuten 商品详情页链接。
no_data是否无数据booleanfalse该任务商品是否没有可返回的评论数据。
updated_at更新时间戳integer1789366028130评论记录的 Unix 毫秒更新时间戳;无值时上游返回空值。
use_situation使用场景string实用品・普段使い|自分用|はじめて买家填写的使用场景原始文本;无值时上游返回空值。
user_age用户年龄段string40代评论用户填写或推断的年龄段;无值时上游返回空值。
user_avatar_url用户头像string—评论用户头像链接;无值时上游返回空值。
user_id用户编号string—评论用户公开编号;无值时上游返回空值。
user_name用户名称string购买者さん评论用户公开名称;无值时上游返回空值。
user_sex用户性别string男性评论用户公开性别信息;无值时上游返回空值。
video_url_list评论视频string[]评论视频链接列表的原始 JSON 文本;无值时上游返回空值。

记录 Schema

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

output.schema
{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "商品标识",
      "description": "评论所属商品的 Rakuten 商品详情页链接;无值时上游返回空值。",
      "prefill": "https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/"
    },
    "comment_id": {
      "type": "string",
      "title": "评论编号",
      "description": "评论的唯一编号;无值时上游返回空值。",
      "prefill": "ce889f82-c853-11f0-a58b-005056a73e5f"
    },
    "comment_text": {
      "type": "string",
      "title": "评论正文",
      "description": "买家评论的完整正文;无值时上游返回空值。",
      "prefill": "ロボット掃除機を導入して数週間が経ちますが、買って良かったと感じています。"
    },
    "comment_time_raw": {
      "type": "string",
      "title": "原始评论日期",
      "description": "来源中的原始评论日期文本;无值时上游返回空值。",
      "prefill": "2025/11/23"
    },
    "comment_title": {
      "type": "string",
      "title": "评论标题",
      "description": "买家为评论填写的标题;无值时上游返回空值。",
      "prefill": "とても良い買い物"
    },
    "comment_type": {
      "type": "string",
      "title": "评论类型",
      "description": "上游提供的评论类型编码;无值时上游返回空值。",
      "prefill": "1"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "平台采集该评论的时间文本;无值时上游返回空值。",
      "prefill": "2026-09-14T14:07:08"
    },
    "created_at": {
      "type": "integer",
      "title": "创建时间戳",
      "description": "评论记录的 Unix 毫秒时间戳;无值时上游返回空值。",
      "prefill": 1789366028130
    },
    "image_url_list": {
      "type": "string",
      "title": "评论图片",
      "description": "评论图片链接列表的原始 JSON 文本;无值时上游返回空值。",
      "prefill": "[]"
    },
    "item_image_url_list": {
      "type": "string",
      "title": "商品图片",
      "description": "评论关联商品图片链接列表的原始 JSON 文本;无值时上游返回空值。",
      "prefill": "[]"
    },
    "item_sale_prop": {
      "type": "string",
      "title": "商品销售属性",
      "description": "评论关联商品的销售属性原始文本;无值时上游返回空值。"
    },
    "job_type": {
      "type": "string",
      "title": "任务类型",
      "description": "上游返回的任务类型标识。",
      "prefill": "Comment"
    },
    "level_name": {
      "type": "string",
      "title": "层级名称",
      "description": "上游返回的评论层级名称;无值时上游返回空值。",
      "prefill": "octopus"
    },
    "parent_comment_id": {
      "type": "string",
      "title": "父评论编号",
      "description": "该评论直接回复的父评论编号,根评论通常为 0;无值时上游返回空值。",
      "prefill": "0"
    },
    "platform_code": {
      "type": "string",
      "title": "平台编码",
      "description": "评论来源平台编码。",
      "prefill": "rakuten"
    },
    "product_title": {
      "type": "string",
      "title": "商品标题",
      "description": "评论关联的商品标题;无值时上游返回空值。"
    },
    "product_url": {
      "type": "string",
      "title": "商品链接",
      "description": "评论关联商品的 Rakuten 商品详情页链接;无值时上游返回空值。",
      "prefill": "https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/"
    },
    "publish_time": {
      "type": "string",
      "title": "发布时间",
      "description": "评论在来源平台显示的发布时间文本;无值时上游返回空值。",
      "prefill": "2025-11-23T00:00:00"
    },
    "rating_score": {
      "type": "string",
      "title": "评分",
      "description": "来源平台提供的评分文本,通常为 1 至 5 的整数;无值时上游返回空值。",
      "prefill": "5"
    },
    "sale_prop": {
      "type": "string",
      "title": "销售属性",
      "description": "评论对应的商品销售属性原始文本;无值时上游返回空值。"
    },
    "shop_id": {
      "type": "string",
      "title": "店铺编号",
      "description": "Rakuten 店铺编号;无值时上游返回空值。",
      "prefill": "346082"
    },
    "shop_name": {
      "type": "string",
      "title": "店铺名称",
      "description": "Rakuten 店铺名称;无值时上游返回空值。"
    },
    "site_code": {
      "type": "string",
      "title": "站点编码",
      "description": "Rakuten 站点后缀编码。",
      "prefill": ".co.jp"
    },
    "sku_id": {
      "type": "string",
      "title": "SKU 编号",
      "description": "评论对应的 SKU 编号;无值时上游返回空值。",
      "prefill": "10000405"
    },
    "spu_id": {
      "type": "string",
      "title": "SPU 编号",
      "description": "评论对应的 SPU 编号;无值时上游返回空值。"
    },
    "task_item": {
      "type": "string",
      "title": "任务商品链接",
      "description": "提交任务时使用的 Rakuten 商品详情页链接。",
      "prefill": "https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/"
    },
    "no_data": {
      "type": "boolean",
      "title": "是否无数据",
      "description": "该任务商品是否没有可返回的评论数据。",
      "prefill": false
    },
    "updated_at": {
      "type": "integer",
      "title": "更新时间戳",
      "description": "评论记录的 Unix 毫秒更新时间戳;无值时上游返回空值。",
      "prefill": 1789366028130
    },
    "use_situation": {
      "type": "string",
      "title": "使用场景",
      "description": "买家填写的使用场景原始文本;无值时上游返回空值。",
      "prefill": "实用品・普段使い|自分用|はじめて"
    },
    "user_age": {
      "type": "string",
      "title": "用户年龄段",
      "description": "评论用户填写或推断的年龄段;无值时上游返回空值。",
      "prefill": "40代"
    },
    "user_avatar_url": {
      "type": "string",
      "title": "用户头像",
      "description": "评论用户头像链接;无值时上游返回空值。"
    },
    "user_id": {
      "type": "string",
      "title": "用户编号",
      "description": "评论用户公开编号;无值时上游返回空值。"
    },
    "user_name": {
      "type": "string",
      "title": "用户名称",
      "description": "评论用户公开名称;无值时上游返回空值。",
      "prefill": "购买者さん"
    },
    "user_sex": {
      "type": "string",
      "title": "用户性别",
      "description": "评论用户公开性别信息;无值时上游返回空值。",
      "prefill": "男性"
    },
    "video_url_list": {
      "type": "string",
      "title": "评论视频",
      "description": "评论视频链接列表的原始 JSON 文本;无值时上游返回空值。",
      "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-comment": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/rakuten-comment",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。

如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。

价格

提交一次评论采集

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

¥0.001/ 次
返回30条记录

按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。

¥0.015/ 30 条

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

立即体验

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

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