Agent Skills
返回列表
🏢

Amazon 店铺 A+ 内容管理

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-store-aplus-content-107。

技能介绍

要解决的问题

亚马逊品牌备案卖家在 Seller Central 里维护 A+ 详情页内容时,若要脚本化或交给 AI 助手操作,必须对接 A+ Content API(aplus/2020-11-01/):文档检索、草稿创建与更新、ASIN 绑定、可用性校验、提交审核、按 ASIN 查发布记录,以及前台暂停展示。这些接口与店铺授权(sellerId + region)和站点 marketplaceId 强绑定;写错关联 ASIN 或误点暂停,会直接影响线上详情页。

本技能属于 Amazon Store 系列,不自行处理 OAuth:须先完成 linkfox-amazon-store-auth 选店,再通过统一网关 POST /spApi/developerProxy 由服务端解析 token(调用方勿传 amzAccessToken,除非兼容旧逻辑)。各操作对应官方能力名如 searchContentDocuments、createContentDocument、postContentDocumentAsinRelations 等,配套 Python 脚本封装路径与必填参数。

核心能力与关键步骤

典型流程可先 search_content_documents.py 列出文档并取得 contentReferenceKey(注意:该 key 非永久 ID,与后台显示的「A+ ID」不一定一致);用 get_content_document.py 拉取时需指定 includedDataSet(至少 CONTENTS 或 METADATA 之一)。

  • 创建 / 更新:create_content_document.py、update_content_document.py 提交符合 Amazon 官方模型的 contentDocument 结构(本技能透传,不内置模板校验)。
  • ASIN 关联:list_content_document_asin_relations.py 查看现有关联;post_content_document_asin_relations.py 为全量替换 asinSet,从集合移除的 ASIN 可能导致该 ASIN 上内容被 suspend。
  • 发布前:validate_content_document_asin_relations.py 校验;post_content_document_approval_submission.py 提交审核;search_content_publish_records.py 按 asin(长度 ≥10)查发布记录。
  • 运营干预:post_content_document_suspend_submission.py 暂停前台展示。

脚本默认将完整响应写入工作目录下按 SESSION_ID 聚合的 JSON;响应较大时 stdout 只给摘要,可用 jq 从落盘文件按需抽取字段,避免整包 JSON 灌入上下文。失败或空结果时不得自动换词、翻页试探(文档中的成本约束语义仍适用于代理调用行为)。

边界与注意点

  • 依赖:check_auth_dependency.py 若返回 exit code 42 且含 DEPENDENCY_MISSING:,须先安装 auth 技能,禁止在本技能内绕过授权。
  • 权限与白名单:Seller Central 应用须具备 A+ 相关角色,否则易 403;aplus/2020-11-01/ 须在网关放行,1005 需运维配置。
  • Query 细节:A+ 接口使用单数 marketplaceId(与 Listings 系列的 marketplaceIds 不同);marketplaceIds 数组时脚本仅取第一个。
  • 展示与决策:解析结果时先看网关 errcode / httpStatus,再读 developerProxy.body;401/402 或积分类文案见 references/onboarding.md。写操作前务必与用户确认意图。

使用场景

  • 大促前用脚本列出各站点 A+ 文档,核对 contentReferenceKey 与草稿状态
  • 新品上架前创建 contentDocument,校验 ASIN 关联后再提交 approvalSubmissions
  • 发现某 ASIN 详情页展示异常时,按 asin 查询 contentPublishRecords 并对照关联列表
  • 活动结束需下线图文模块时,经确认后调用 suspendSubmissions 暂停前台展示

适合人员

  • 负责多站点 A+ 迭代的亚马逊品牌运营,需要批量查文档与发布记录而非只点后台
  • 用 SP-API 做刊登自动化的工程师,要把 A+ 创建与 ASIN 全量替换纳入流水线并可控回滚
  • 代运营团队 PM,需在改 ASIN 绑定或暂停展示前让助手汇总当前关联与校验结果
  • 已接入 linkfox-amazon-store-auth 的卖家技术对接人,要把 A+ 与 Listings 技能分工边界说清楚