概览
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 商品详情页链接
rakuten_item_url必填string要采集评论的 Rakuten 商品详情页完整 URL,必须以 https://item.rakuten.co.jp/ 开头,长度不超过 512 个字符。示例https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/ - 期望采集评论条数
comment_limit必填string填写正整数文本作为期望采集数量;结果按上游完整批次返回,实际评论条数可能高于该值。当前拉取保护容量约为 1000 条,超过该容量时结果可能不完整。示例2
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 商品标识
biz_idstring评论所属商品的 Rakuten 商品详情页链接;无值时上游返回空值。示例https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/ - 评论编号
comment_idstring评论的唯一编号;无值时上游返回空值。示例ce889f82-c853-11f0-a58b-005056a73e5f - 评论正文
comment_textstring买家评论的完整正文;无值时上游返回空值。示例ロボット掃除機を導入して数週間が経ちますが、買って良かったと感じています。 - 原始评论日期
comment_time_rawstring来源中的原始评论日期文本;无值时上游返回空值。示例2025/11/23
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"biz_id": "https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/",
"comment_id": "ce889f82-c853-11f0-a58b-005056a73e5f",
"comment_text": "ロボット掃除機を導入して数週間が経ちますが、買って良かったと感じています。",
"comment_time_raw": "2025/11/23",
"comment_title": "とても良い買い物",
"comment_type": "1",
"crawl_time": "2026-09-14T14:07:08",
"created_at": 1789366028130,
"image_url_list": "[]",
"item_image_url_list": "[]",
"item_sale_prop": "<item_sale_prop>",
"job_type": "Comment",
"level_name": "octopus",
"parent_comment_id": "0",
"platform_code": "rakuten",
"product_title": "<product_title>",
"product_url": "https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/",
"publish_time": "2025-11-23T00:00:00",
"rating_score": "5",
"sale_prop": "<sale_prop>",
"shop_id": "346082",
"shop_name": "<shop_name>",
"site_code": ".co.jp",
"sku_id": "10000405",
"spu_id": "<spu_id>",
"task_item": "https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/",
"no_data": false,
"updated_at": 1789366028130,
"use_situation": "实用品・普段使い|自分用|はじめて",
"user_age": "40代",
"user_avatar_url": "<user_avatar_url>",
"user_id": "<user_id>",
"user_name": "购买者さん",
"user_sex": "男性",
"video_url_list": "[]"
}调用方式
本 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-comment",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。