Amazon 店铺 A+ 内容管理
将以下提示词粘贴到你的 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 技能分工边界说清楚