Back to Details

linkfox-amazon-store-aplus-content

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Amazon 店铺 A+ Content Management

Amazon 店铺 A+ Content Management

本 skill 与 
linkfox-amazon-store-auth
、
linkfox-amazon-store-listings
 等同属 Amazon Store 系列：使用 
POST /spApi/storeTokens
 取 
accessToken
，再经 
POST /spApi/developerProxy
 转发上游 GET 或 POST。
操作官方参考
搜索文档列表searchContentDocuments
新建文档createContentDocument
获取文档（内容/元数据）getContentDocument
更新文档updateContentDocument
列出 ASIN 关联listContentDocumentAsinRelations
替换 ASIN 关联postContentDocumentAsinRelations
校验文档与 ASINvalidateContentDocumentAsinRelations
按 ASIN 查发布记录searchContentPublishRecords
提交审核/发布postContentDocumentApprovalSubmission
暂停前台展示postContentDocumentSuspendSubmission
本 skill 与 
linkfox-amazon-store-auth
、
linkfox-amazon-store-listings
 等同属 Amazon Store 系列：使用 
POST /spApi/storeTokens
 获取 
accessToken
，再通过 
POST /spApi/developerProxy
 转发上游 GET 或 POST 请求。
操作官方参考
搜索文档列表searchContentDocuments
新建文档createContentDocument
获取文档（内容/元数据）getContentDocument
更新文档updateContentDocument
列出 ASIN 关联listContentDocumentAsinRelations
替换 ASIN 关联postContentDocumentAsinRelations
校验文档与 ASINvalidateContentDocumentAsinRelations
按 ASIN 查发布记录searchContentPublishRecords
提交审核/发布postContentDocumentApprovalSubmission
暂停前台展示postContentDocumentSuspendSubmission

Prerequisites（必须先读）

前置条件（必读）

本 skill 依赖 
linkfox-amazon-store-auth
。
  1. 运行 
    python scripts/check_auth_dependency.py
    ；若 exit code 42 且 stderr 含 
    DEPENDENCY_MISSING:
    ，请先安装 
    linkfox-amazon-store-auth
    。
  2. 不要在本 skill 内绕过依赖实现授权或令牌逻辑。
本 skill 依赖 
linkfox-amazon-store-auth
。
  1. 运行 
    python scripts/check_auth_dependency.py
    ；若退出码为 42 且标准错误输出包含 
    DEPENDENCY_MISSING:
    ，请先安装 
    linkfox-amazon-store-auth
    。
  2. 请勿在本 skill 内绕过依赖实现授权或令牌逻辑。

Current Capabilities

当前功能

能力Path 要点脚本
搜索 A+ 文档
aplus/2020-11-01/contentDocuments
+ 
marketplaceId
scripts/search_content_documents.py
创建 A+ 文档同上 POST + body 
contentDocument
scripts/create_content_document.py
获取单篇文档
.../contentDocuments/{contentReferenceKey}
+ 
includedDataSet
（必填，至少 1 项）
scripts/get_content_document.py
更新文档同上 POST + body
scripts/update_content_document.py
列出关联 ASIN
.../contentDocuments/{key}/asins
scripts/list_content_document_asin_relations.py
全量替换关联 ASIN
.../asins
POST + body 
asinSet
scripts/post_content_document_asin_relations.py
校验与 ASIN 的可用性
.../contentAsinValidations
POST
scripts/validate_content_document_asin_relations.py
发布记录（按 ASIN）
.../contentPublishRecords
+ 
asin
scripts/search_content_publish_records.py
提交审核
.../approvalSubmissions
POST
scripts/post_content_document_approval_submission.py
暂停展示
.../suspendSubmissions
POST
scripts/post_content_document_suspend_submission.py
注意：
postContentDocumentAsinRelations
为 全量替换 
asinSet
；从集合中移除 ASIN 会导致该 ASIN 上内容被 suspend（以 Amazon 行为为准）。详见 
references/api.md
。
能力Path 要点脚本
搜索 A+ 文档
aplus/2020-11-01/contentDocuments
+ 
marketplaceId
scripts/search_content_documents.py
创建 A+ 文档同上 POST + 请求体 
contentDocument
scripts/create_content_document.py
获取单篇文档
.../contentDocuments/{contentReferenceKey}
+ 
includedDataSet
（必填，至少 1 项）
scripts/get_content_document.py
更新文档同上 POST + 请求体
scripts/update_content_document.py
列出关联 ASIN
.../contentDocuments/{key}/asins
scripts/list_content_document_asin_relations.py
全量替换关联 ASIN
.../asins
POST + 请求体 
asinSet
scripts/post_content_document_asin_relations.py
校验与 ASIN 的可用性
.../contentAsinValidations
POST
scripts/validate_content_document_asin_relations.py
发布记录（按 ASIN）
.../contentPublishRecords
+ 
asin
scripts/search_content_publish_records.py
提交审核
.../approvalSubmissions
POST
scripts/post_content_document_approval_submission.py
暂停展示
.../suspendSubmissions
POST
scripts/post_content_document_suspend_submission.py
注意：
postContentDocumentAsinRelations
会全量替换 
asinSet
；从集合中移除 ASIN 会导致该 ASIN 上的内容被 suspend（以 Amazon 实际行为为准）。详情请查看 
references/api.md
。

Quick Parameters

快速参数

通用

通用

字段必填说明
sellerId是已授权 Seller ID（与 
storeTokens
一致）
region是
NA
/ 
EU
/ 
FE
marketplaceId 或 marketplaceIds是目标站点；数组时脚本仅取 第一个
字段必填说明
sellerId是已授权的 Seller ID（与 
storeTokens
一致）
region是
NA
/ 
EU
/ 
FE
marketplaceId 或 marketplaceIds是目标站点；为数组时脚本仅取第一个值

contentReferenceKey

contentReferenceKey

多数操作需要 
contentReferenceKey
（来自 
searchContentDocuments
等）。官方说明该 key 非永久链接、未来可能变化。
多数操作需要 
contentReferenceKey
（可从 
searchContentDocuments
等接口获取）。官方说明该 key 非永久链接，未来可能会发生变化。

getContentDocument

getContentDocument

字段必填说明
includedDataSet是至少一项；
CONTENTS
、
METADATA
（可并存）
字段必填说明
includedDataSet是至少选择一项；可选值为 
CONTENTS
、
METADATA
（可同时选择）

searchContentPublishRecords

searchContentPublishRecords

字段必填说明
asin是长度 ≥ 10
字段必填说明
asin是长度 ≥ 10

Scripts

脚本列表

  • scripts/search_content_documents.py
  • scripts/create_content_document.py
  • scripts/get_content_document.py
  • scripts/update_content_document.py
  • scripts/list_content_document_asin_relations.py
  • scripts/post_content_document_asin_relations.py
  • scripts/validate_content_document_asin_relations.py
  • scripts/search_content_publish_records.py
  • scripts/post_content_document_approval_submission.py
  • scripts/post_content_document_suspend_submission.py
  • scripts/check_auth_dependency.py
示例：
bash
export LINKFOXAGENT_API_KEY="<your-key>"

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

python scripts/get_content_document.py '{"sellerId":"A1...","region":"NA","marketplaceId":"ATVPDKIKX0DER","contentReferenceKey":"YOUR_KEY","includedDataSet":["CONTENTS","METADATA"]}'

python scripts/post_content_document_asin_relations.py '{"sellerId":"A1...","region":"NA","marketplaceId":"ATVPDKIKX0DER","contentReferenceKey":"YOUR_KEY","asinSet":["B0XXXXXXXXXX"]}'

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

python scripts/post_content_document_approval_submission.py '{"sellerId":"A1...","region":"NA","marketplaceId":"ATVPDKIKX0DER","contentReferenceKey":"YOUR_KEY"}'
  • scripts/search_content_documents.py
  • scripts/create_content_document.py
  • scripts/get_content_document.py
  • scripts/update_content_document.py
  • scripts/list_content_document_asin_relations.py
  • scripts/post_content_document_asin_relations.py
  • scripts/validate_content_document_asin_relations.py
  • scripts/search_content_publish_records.py
  • scripts/post_content_document_approval_submission.py
  • scripts/post_content_document_suspend_submission.py
  • scripts/check_auth_dependency.py
示例：
bash
export LINKFOXAGENT_API_KEY="<your-key>"

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

python scripts/get_content_document.py '{"sellerId":"A1...","region":"NA","marketplaceId":"ATVPDKIKX0DER","contentReferenceKey":"YOUR_KEY","includedDataSet":["CONTENTS","METADATA"]}'

python scripts/post_content_document_asin_relations.py '{"sellerId":"A1...","region":"NA","marketplaceId":"ATVPDKIKX0DER","contentReferenceKey":"YOUR_KEY","asinSet":["B0XXXXXXXXXX"]}'

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

python scripts/post_content_document_approval_submission.py '{"sellerId":"A1...","region":"NA","marketplaceId":"ATVPDKIKX0DER","contentReferenceKey":"YOUR_KEY"}'

Display Rules

展示规则

  1. 先展示网关 
    errcode
    / 
    httpStatus
    ；成功后再解析 
    developerProxy.body
     或各脚本附带的 
    *Response
     字段。
  2. 说明 
    contentReferenceKey
     与前台「A+ ID」不一定一致。
  3. 写操作（创建/更新/关联/校验/提交/暂停）前确认用户意图；替换 ASIN 与 暂停展示 影响线上详情页。
  1. 先展示网关的 
    errcode
    / 
    httpStatus
    ；请求成功后再解析 
    developerProxy.body
     或各脚本附带的 
    *Response
     字段。
  2. 需要说明 
    contentReferenceKey
     与前台的「A+ ID」不一定一致。
  3. 执行写操作（创建/更新/关联/校验/提交/暂停）前需确认用户意图；替换ASIN 与 暂停展示 会影响线上商品详情页。

Important Limitations

重要限制

  • 应用权限：Seller Central 应用须具备 A+ Content 相关 角色/权限；否则 403。
  • 白名单：
    aplus/2020-11-01/
    须在网关 developerProxy 放行；1005 需运维配置。
  • contentDocument
     结构复杂，须符合 Amazon 官方模型；本 skill 只做透传，不内置模板校验。
  • marketplaceId：A+ 接口 Query 使用单数 
    marketplaceId
    （与 Listings 的 
    marketplaceIds
    不同）。
Feedback： 见 
references/api.md
，
skillName
：
linkfox-amazon-store-aplus-content
。
更多跨境 skill：LinkFox Skills
<!-- LF_LARGE_RESPONSE_BLOCK -->
  • 应用权限：Seller Central 应用必须具备 A+ Content 相关的 角色/权限；否则会返回 403 错误。
  • 白名单：
    aplus/2020-11-01/
    必须在网关 developerProxy 的放行列表中；出现 1005 错误时需联系运维配置。
  • contentDocument
     结构复杂，必须符合 Amazon 官方模型；本 skill 仅做透传，不内置模板校验。
  • marketplaceId：A+ 接口的查询参数使用单数形式 
    marketplaceId
    （与 Listings 接口的 
    marketplaceIds
    不同）。
反馈： 请查看 
references/api.md
，
skillName
：
linkfox-amazon-store-aplus-content
。
更多跨境 skill：LinkFox Skills
<!-- LF_LARGE_RESPONSE_BLOCK -->

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
, 
create_content_document.py
, 
get_content_document.py
, 
list_content_document_asin_relations.py
, 
post_content_document_approval_submission.py
, 
post_content_document_asin_relations.py
, 
post_content_document_suspend_submission.py
, 
search_content_documents.py
, 
search_content_publish_records.py
, 
update_content_document.py
, 
validate_content_document_asin_relations.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
.
<!-- /LF_LARGE_RESPONSE_BLOCK -->
为避免超出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>"   # 或使用 --path "<JMESPath>"
请选择 
<out-dir>
到Git工作区外的路径（例如Unix系统的 
/tmp/...
，Windows系统的 
%TEMP%/...
）。持久化的响应结果可能包含个人身份信息（PII）、定价或敏感授权数据——请勿提交到代码仓库。文件不会自动删除，完成任务后请自行清理。
本skill提供多个入口脚本：
check_auth_dependency.py
, 
create_content_document.py
, 
get_content_document.py
, 
list_content_document_asin_relations.py
, 
post_content_document_approval_submission.py
, 
post_content_document_asin_relations.py
, 
post_content_document_suspend_submission.py
, 
search_content_documents.py
, 
search_content_publish_records.py
, 
update_content_document.py
, 
validate_content_document_asin_relations.py
。通过传递 
--script scripts/<name>.py
参数选择所需脚本。
run
命令会将完整响应写入文件，并仅输出架构预览+文件路径。
read
命令提取指定字段，可使用 
--limit/--offset
进行切片，
--format json|jsonl|csv|table
指定输出格式。
何时优先使用此模式——根据响应特性判断，例如：
  • 每条记录字段数量多，或包含不需要的字段
  • 批量/分页结果（单次调用返回多条数据）
  • 长文本字段（描述、评论、HTML、时间序列）
  • 输出结果需在后续步骤复用，而非立即使用
对于小型、一次性的响应结果，直接调用主脚本即可。
⚠️ 预览内容是截断的架构+示例，而非完整数据。任何字段级别的决策必须通过 
read
命令从持久化文件中读取。
<!-- /LF_LARGE_RESPONSE_BLOCK -->