概览
Rakuten 商品评论呈现买家体验、使用场景和售后感受。App 根据商品详情页链接返回评论正文、评分、发布时间及商品、用户信息,形成口碑明细。
它保留评论编号、父评论关系和图片文本,方便把分散反馈放在同一张底表中观察。评论数量是期望值,实际结果遵循来源平台的完整批次规则。
数据说明
数据来自 Rakuten 商品详情页的评论区,评论编号用于识别同一条评论,父评论编号用于保留回复关系。评分和评论类型保留原始文本,图片和视频链接列表也保留为原始文本;创建时间和更新时间是毫秒时间戳,发布时间保留来源中的时间表现。评论标题、销售属性和用户信息可能为空。
结果长什么样
每条记录代表一条 Rakuten 商品评论:
| 评论编号 | 评分 | 评论正文 | 评论标题 | 发布时间 |
|---|---|---|---|---|
| ce889f82-c853-11f0-a58b-005056a73e5f | 5 | ロボット掃除機を導入して数週間が経ちますが、買って良かったと感じています。 | とても良い買い物 | 2025-11-23T00:00:00 |
| adb39f3c9a29f5906efa1e00dff5c3de | 丁寧で詳細なレビューをお寄せくださいましてありがとうございます。 | 2025-11-28T00:00:00 |
另有商品链接、店铺信息、评论标题、用户名称、父评论编号、图片和视频链接等字段。
应用场景
- 做商品口碑体检时,结合「评分」和「评论正文」统计正负反馈,定位体验问题。
- 做评论主题整理时,按「评论标题」「评论正文」归纳商品的优点、缺点和使用场景。
- 做评论关系分析时,使用「评论编号」「父评论编号」还原买家评论与商家回复的关联。
- 做时间趋势观察时,按「发布时间」汇总评论数量,比较反馈变化。
适用边界
单次任务处理 1 个 Rakuten 商品详情页链接,可指定期望采集的评论条数;实际评论条数可能按完整批次高于期望值;当前拉取保护容量约为 1000 条;仅覆盖接口可采集到的商品评论。
- 适合用于
- 需要获取指定 Rakuten 商品的评论正文、评分和发布时间时
- 需要分析 Rakuten 商品的买家反馈、评论层级和用户信息时
- 不要用于
- 需要一次处理多个商品时——本 App 每次任务只接受一个商品详情页链接
- 需要商品价格、库存或订单数据时——本 App 只提供商品评论及其关联信息
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回无数据记录时,先确认商品详情页链接准确且页面存在可采集评论
- 2任务部分成功时可使用已返回的评论记录,实际条数可能少于期望值
- 3任务失败、过期、限流或请求超时时,核对商品链接后再重新提交
- 4鉴权失败、任务不存在或任务上下文不匹配时,先检查执行环境凭证和调用配置
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| rakuten_item_url | Rakuten 商品详情页链接 | 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 | 商品标识 | string | https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/ | 评论所属商品的 Rakuten 商品详情页链接;无值时上游返回空值。 |
| comment_id | 评论编号 | string | ce889f82-c853-11f0-a58b-005056a73e5f | 评论的唯一编号;无值时上游返回空值。 |
| comment_text | 评论正文 | string | ロボット掃除機を導入して数週間が経ちますが、買って良かったと感じています。 | 买家评论的完整正文;无值时上游返回空值。 |
| comment_time_raw | 原始评论日期 | string | 2025/11/23 | 来源中的原始评论日期文本;无值时上游返回空值。 |
| comment_title | 评论标题 | string | とても良い買い物 | 买家为评论填写的标题;无值时上游返回空值。 |
| comment_type | 评论类型 | string | 1 | 上游提供的评论类型编码;无值时上游返回空值。 |
| crawl_time | 采集时间 | string | 2026-09-14T14:07:08 | 平台采集该评论的时间文本;无值时上游返回空值。 |
| created_at | 创建时间戳 | integer | 1789366028130 | 评论记录的 Unix 毫秒时间戳;无值时上游返回空值。 |
| image_url_list | 评论图片 | string | [] | 评论图片链接列表的原始 JSON 文本;无值时上游返回空值。 |
| item_image_url_list | 商品图片 | string | [] | 评论关联商品图片链接列表的原始 JSON 文本;无值时上游返回空值。 |
| item_sale_prop | 商品销售属性 | string | — | 评论关联商品的销售属性原始文本;无值时上游返回空值。 |
| job_type | 任务类型 | string | Comment | 上游返回的任务类型标识。 |
| level_name | 层级名称 | string | octopus | 上游返回的评论层级名称;无值时上游返回空值。 |
| parent_comment_id | 父评论编号 | string | 0 | 该评论直接回复的父评论编号,根评论通常为 0;无值时上游返回空值。 |
| platform_code | 平台编码 | string | rakuten | 评论来源平台编码。 |
| product_title | 商品标题 | string | — | 评论关联的商品标题;无值时上游返回空值。 |
| product_url | 商品链接 | string | https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/ | 评论关联商品的 Rakuten 商品详情页链接;无值时上游返回空值。 |
| publish_time | 发布时间 | string | 2025-11-23T00:00:00 | 评论在来源平台显示的发布时间文本;无值时上游返回空值。 |
| rating_score | 评分 | string | 5 | 来源平台提供的评分文本,通常为 1 至 5 的整数;无值时上游返回空值。 |
| sale_prop | 销售属性 | string | — | 评论对应的商品销售属性原始文本;无值时上游返回空值。 |
| shop_id | 店铺编号 | string | 346082 | Rakuten 店铺编号;无值时上游返回空值。 |
| shop_name | 店铺名称 | string | — | Rakuten 店铺名称;无值时上游返回空值。 |
| site_code | 站点编码 | string | .co.jp | Rakuten 站点后缀编码。 |
| sku_id | SKU 编号 | string | 10000405 | 评论对应的 SKU 编号;无值时上游返回空值。 |
| spu_id | SPU 编号 | string | — | 评论对应的 SPU 编号;无值时上游返回空值。 |
| task_item | 任务商品链接 | string | https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/ | 提交任务时使用的 Rakuten 商品详情页链接。 |
| no_data | 是否无数据 | boolean | false | 该任务商品是否没有可返回的评论数据。 |
| updated_at | 更新时间戳 | integer | 1789366028130 | 评论记录的 Unix 毫秒更新时间戳;无值时上游返回空值。 |
| use_situation | 使用场景 | string | 实用品・普段使い|自分用|はじめて | 买家填写的使用场景原始文本;无值时上游返回空值。 |
| user_age | 用户年龄段 | string | 40代 | 评论用户填写或推断的年龄段;无值时上游返回空值。 |
| user_avatar_url | 用户头像 | string | — | 评论用户头像链接;无值时上游返回空值。 |
| user_id | 用户编号 | string | — | 评论用户公开编号;无值时上游返回空值。 |
| user_name | 用户名称 | string | 购买者さん | 评论用户公开名称;无值时上游返回空值。 |
| user_sex | 用户性别 | string | 男性 | 评论用户公开性别信息;无值时上游返回空值。 |
| video_url_list | 评论视频 | string | [] | 评论视频链接列表的原始 JSON 文本;无值时上游返回空值。 |
记录 Schema
输出按记录逐条返回。记录主键为 comment_id,去重、增量、关联以它为准。
{
"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": {
"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)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。