linkfox-amazon-store-customer-feedback

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Amazon 店铺 Customer Feedback

Amazon店铺Customer Feedback

本 skill 与 linkfox-amazon-store-auth
等同属 Amazon Store 系列：先 POST /spApi/storeTokens
，再 POST /spApi/developerProxy
转发 GET。

说明：接口属于 Customer Feedback（买家评论/退货洞察），不是 Orders 订单 API。订单见 linkfox-amazon-store-orders
。

本Skill与 linkfox-amazon-store-auth
同属 Amazon Store 系列：先调用 POST /spApi/storeTokens
，再通过 POST /spApi/developerProxy
转发 GET 请求。

说明：接口属于 Customer Feedback（买家评论/退货洞察），并非Orders订单API。订单相关功能请查看 linkfox-amazon-store-orders
。

官方参考索引

能力	文档
getItemReviewTopics	getItemReviewTopics
getItemBrowseNode	getItemBrowseNode
getBrowseNodeReviewTopics	getBrowseNodeReviewTopics
getItemReviewTrends	getItemReviewTrends
getBrowseNodeReviewTrends	getBrowseNodeReviewTrends
getBrowseNodeReturnTopics	getBrowseNodeReturnTopics
getBrowseNodeReturnTrends	getBrowseNodeReturnTrends

能力	文档
getItemReviewTopics	getItemReviewTopics
getItemBrowseNode	getItemBrowseNode
getBrowseNodeReviewTopics	getBrowseNodeReviewTopics
getItemReviewTrends	getItemReviewTrends
getBrowseNodeReviewTrends	getBrowseNodeReviewTrends
getBrowseNodeReturnTopics	getBrowseNodeReturnTopics
getBrowseNodeReturnTrends	getBrowseNodeReturnTrends

Prerequisites

前置条件

依赖 linkfox-amazon-store-auth
。
通常需 Brand Analytics 或 Selling Partner Insights 等角色；站点以官方为准（常见 US/UK/DE 等）。
ASIN 一般为子体 ASIN；topics 类接口需 sortBy
：
```
MENTIONS
```
或
```
STAR_RATING_IMPACT
```
（常各调一次对比）。

依赖 linkfox-amazon-store-auth
。
通常需要 Brand Analytics 或 Selling Partner Insights 等权限角色；支持的站点以官方说明为准（常见如US/UK/DE等）。
ASIN 一般为子体ASIN；topics类接口需传入 sortBy
参数：
```
MENTIONS
```
或
```
STAR_RATING_IMPACT
```
（建议各调用一次进行对比）。

Current Capabilities

当前功能

脚本	path 要点
`get_item_review_topics.py`	`.../items/{asin}/reviews/topics`
`get_item_browse_node.py`	`.../items/{asin}/browseNode`
`get_item_review_trends.py`	`.../items/{asin}/reviews/trends`
`get_browse_node_review_topics.py`	`.../browseNodes/{browseNodeId}/reviews/topics`
`get_browse_node_review_trends.py`	`.../browseNodes/{browseNodeId}/reviews/trends`
`get_browse_node_return_topics.py`	`.../browseNodes/{browseNodeId}/returns/topics`
`get_browse_node_return_trends.py`	`.../browseNodes/{browseNodeId}/returns/trends`

前缀均为 customerFeedback/2024-06-01/
。共享模块：_spapi_customer_feedback_common.py
。

脚本	路径要点
`get_item_review_topics.py`	`.../items/{asin}/reviews/topics`
`get_item_browse_node.py`	`.../items/{asin}/browseNode`
`get_item_review_trends.py`	`.../items/{asin}/reviews/trends`
`get_browse_node_review_topics.py`	`.../browseNodes/{browseNodeId}/reviews/topics`
`get_browse_node_review_trends.py`	`.../browseNodes/{browseNodeId}/reviews/trends`
`get_browse_node_return_topics.py`	`.../browseNodes/{browseNodeId}/returns/topics`
`get_browse_node_return_trends.py`	`.../browseNodes/{browseNodeId}/returns/trends`

所有接口路径前缀均为 customerFeedback/2024-06-01/
。共享模块：_spapi_customer_feedback_common.py
。

Quick Parameters

快速参数

公共：

sellerId

、

region

、

marketplaceId

（或

marketplaceIds

取首项）。

ASIN 类：
```
asin
```
；topics 类另需 sortBy
。
Browse node 类：
```
browseNodeId
```
（可先
```
get_item_browse_node
```
取得）。

公共参数：
```
sellerId
```
、
```
region
```
、
```
marketplaceId
```
（若传入
```
marketplaceIds
```
则取第一项）。
ASIN相关接口：需传入
```
asin
```
；topics类接口额外需要 sortBy
参数。
Browse node相关接口：需传入
```
browseNodeId
```
（可先调用
```
get_item_browse_node
```
获取）。

Scripts

脚本示例

bash

export LINKFOXAGENT_API_KEY="<your-key>"

python scripts/get_item_review_topics.py '{"sellerId":"A1...","region":"NA","asin":"B0...","marketplaceId":"ATVPDKIKX0DER","sortBy":"MENTIONS"}'

python scripts/get_item_browse_node.py '{"sellerId":"A1...","region":"NA","asin":"B0...","marketplaceId":"ATVPDKIKX0DER"}'

python scripts/get_browse_node_review_topics.py '{"sellerId":"A1...","region":"NA","browseNodeId":"123456","marketplaceId":"ATVPDKIKX0DER","sortBy":"STAR_RATING_IMPACT"}'

bash

export LINKFOXAGENT_API_KEY="<your-key>"

python scripts/get_item_review_topics.py '{"sellerId":"A1...","region":"NA","asin":"B0...","marketplaceId":"ATVPDKIKX0DER","sortBy":"MENTIONS"}'

python scripts/get_item_browse_node.py '{"sellerId":"A1...","region":"NA","asin":"B0...","marketplaceId":"ATVPDKIKX0DER"}'

python scripts/get_browse_node_review_topics.py '{"sellerId":"A1...","region":"NA","browseNodeId":"123456","marketplaceId":"ATVPDKIKX0DER","sortBy":"STAR_RATING_IMPACT"}'

Display Rules

展示规则

先看 developerProxy.errcode
/
httpStatus
，再读各脚本解析字段（如 itemReviewTopics
）。
网关白名单需包含 customerFeedback/2024-06-01/
。
数据刷新频率以 Amazon 为准（通常按周）。

Feedback：

skillName

：

linkfox-amazon-store-customer-feedback

。

更多跨境 skill：LinkFox Skills

优先查看 developerProxy.errcode
/ httpStatus
状态码，再读取各脚本解析的字段（如 itemReviewTopics
）。
网关白名单需包含 customerFeedback/2024-06-01/
路径。
数据刷新频率以亚马逊官方为准（通常为每周更新）。

反馈信息：

skillName

：

linkfox-amazon-store-customer-feedback

。

更多跨境Skill：LinkFox Skills

Handling Large Responses

处理大响应数据

To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:

python scripts/response_io.py run --script scripts/check_auth_dependency.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

Pick
--out-dir
outside any git working tree (e.g.
/tmp/...
on Unix,
%TEMP%/...
on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.

This skill exposes multiple entry scripts:

check_auth_dependency.py

get_browse_node_return_topics.py

get_browse_node_return_trends.py

get_browse_node_review_topics.py

get_browse_node_review_trends.py

get_item_browse_node.py

get_item_review_topics.py

get_item_review_trends.py

. Pass

--script scripts/<name>.py

to choose the one you need.

run

writes the full response to a file and emits only a schema preview + file path.

read

projects specific fields, with

--limit/--offset

for slicing and

--format json|jsonl|csv|table

for output.

When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:

High field count per record, or fields you don't need
Batch/paginated results (multiple items per call)
Long-text fields (descriptions, reviews, HTML, time series)
Output reused across later steps rather than consumed immediately

For small, single-use responses, calling the main script directly is fine.

⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via

read

为避免超出Agent上下文限制，可将响应数据持久化到磁盘，仅提取所需字段：

python scripts/response_io.py run --script scripts/check_auth_dependency.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

请选择非Git工作目录作为
--out-dir
（例如Unix系统的
/tmp/...
，Windows系统的
%TEMP%/...
）。持久化的响应数据可能包含个人身份信息（PII）、定价或敏感授权数据——请勿提交到Git仓库。文件不会自动删除，完成任务后请自行清理。

本Skill提供多个入口脚本：

check_auth_dependency.py

、

get_browse_node_return_topics.py

、

get_browse_node_return_trends.py

、

get_browse_node_review_topics.py

、

get_browse_node_review_trends.py

、

get_item_browse_node.py

、

get_item_review_topics.py

、

get_item_review_trends.py

。通过

--script scripts/<name>.py

参数指定所需脚本。

run

命令会将完整响应写入文件，并仅输出模式预览和文件路径。

read

命令可提取指定字段，支持

--limit/--offset

进行切片，以及

--format json|jsonl|csv|table

指定输出格式。

何时优先使用此模式——根据响应数据特性判断，例如：

每条记录字段数量多，或包含不需要的字段
批量/分页结果（单次调用返回多条数据）
长文本字段（描述、评论、HTML、时间序列数据）
输出结果需在后续步骤重复使用，而非立即消费

对于小型、单次使用的响应，直接调用主脚本即可。

⚠️ 预览内容是截断的模式+示例，而非完整数据。任何字段相关的决策必须通过

read

命令从持久化文件中读取。