Agent Skills
返回列表
🏢

Amazon 店铺 Feeds

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在亚马逊卖家中心批量改价、补库存或更新 listing 时,往往需要走 Feeds 管道:先申请上传地址,把 TSV/XML 传到 Amazon 给的 URL,再创建 feed 任务并轮询 processingStatus,最后在 DONE 后下载处理结果文档。直接对接 SP-API 还要处理 LWA 令牌、区域与 sellerId 绑定。本技能挂在 LinkFox 的 POST /spApi/developerProxy 上,与 linkfox-amazon-store-auth 共用选店逻辑,把 Feeds 2021-06-30 相关读写收敛成一组 Python 脚本和统一落盘策略。

技能如何工作

调用时传入 sellerId 与 region(不要自行传 amzAccessToken,由服务端解析)。网关按白名单转发 GET / POST / DELETE,路径前缀为 feeds/2021-06-30/。

典型链路:

  • createfeeddocument.py → 拿到 feedDocumentId 与上传 url
  • uploadfeeddocument.py → 对返回 URL 直接 PUT 文件(不经过 developerProxy)
  • create_feed.py → 提交 inputFeedDocumentId、feedType、marketplaceIds
  • getfeed.py / getfeeds.py → 查看 IN_QUEUE、IN_PROGRESS、DONE、FATAL 等状态
  • getfeeddocument.py → 用 resultFeedDocumentId 取结果文档元数据,再自行 HTTP GET 下载正文
  • 需要中止时用 cancel_feed.py

脚本会把完整响应写入当前项目目录下的 linkfox/.../data/linkfox-amazon-store-feeds-*.json;过大响应默认只向 stdout 打摘要,可用 --inline 全量输出。共享逻辑在 _spapi_feeds_common.py。

适用边界与注意点

  • 必须先安装并配置 linkfox-amazon-store-auth(check_auth_dependency.py 退出码 42 表示缺授权 skill)。
  • 店铺应用需具备 Feeds 相关 IAM 角色;feedType 必须与文件格式匹配(以 Amazon Feed Type Values 为准)。
  • 本技能不替你校验 feed 文件 schema;上传失败常是 Content-Type 与 createFeedDocument 不一致或 uploadUrl 过期。
  • getFeeds 分页:下一页用上一页返回的 nextToken 作为请求里的 paginationToken(Amazon 侧参数名仍为 nextToken)。
  • 出现未配置 API Key、401/402 或余额类提示时,按 references/onboarding.md 处理;失败或空结果时不要自动换词、翻页或连续试探。

使用场景

  • 新调价表生成后,需要先 createFeedDocument、PUT 上传 TSV,再 createFeed 并轮询直到 DONE
  • 批量补库存 feed 提交后,用 get_feeds 按 nextToken 翻页核对多条任务是否仍为 IN_PROGRESS
  • 某条 feed 卡在队列过久,需要 cancelFeed 中止后再换文档重提
  • 处理完成要从 resultFeedDocumentId 拉取 getFeedDocument 元数据并自行下载结果文件核对报错行

适合人员

  • 负责亚马逊多站点 listing 批量更新的运营,需要把脚本化 Feeds 流程接到现有选店授权上
  • ERP 对接工程师,要在不自行维护 LWA 的情况下转发 feeds/2021-06-30 的 POST 与 GET
  • 每天提交价格或库存 feed 的组长,需要统一把 API 响应落盘并用 jq 从 JSON 抽字段
  • 首次接入 SP-API Feeds 的开发者,想按官方五步工作流对照项目内 Python 脚本