设计与多媒体

亚马逊-店铺目录

试用

亚马逊店铺商品目录 Catalog（与 linkfox-amazon-store-auth / report / listings / pricing / orders / feeds 同系列），经 /spApi/developerProxy 调用 SP-API Catalog Items：v0 listCatalogCategories；v2022-04-01（默认）或 v2020-12-01 的 searchCatalogItems、getCatalogItem。当用户提到亚马逊目录、Catalog Items、listCatalogCategories、searchCatalogItems、getCatalogItem、按 ASIN 查目录、关键词搜商品目录、类目节点、includedData、summaries/images 时触发。

它能做什么

亚马逊店铺商品目录 Catalog（与 linkfox-amazon-store-auth / report / listings / pricing / orders / feeds 同系列），经 /spApi/developerProxy 调用 SP-API Catalog Items：v0 listCatalogCategories；v2022-04-01（默认）或 v2020-12-01 的 searchCatalogItems、getCatalogItem。当用户提到亚马逊目录、Catalog Items、listCatalogCategories、searchCatalogItems、getCatalogItem、按 ASIN 查目录、关键词搜商品目录、类目节点、includedData、summaries/images 时触发。

技能文档

Amazon 店铺 Catalog Items

本 skill 与 linkfox-amazon-store-auth 等同属 Amazon Store 系列：依赖 linkfox-amazon-store-auth 选店（sellerId+region）；直接 POST /spApi/developerProxy 传入 sellerId+region，由服务端解析 token（勿传 amzAccessToken，除非兼容旧调用）。转发 GET。

调用方式

  • API 端点：POST /spApi/developerProxy（不同操作通过请求体区分；完整参数/响应/错误码见 references/api.md）
  • Python 脚本：python scripts/<脚本名>.py '' [--inline]（可用脚本见上文脚本一览）
  • 成本约束：本工具会消耗积分；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 /linkfox///data/linkfox-amazon-store-catalog-.json（ 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录； 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
  • 加 --inline 强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

  • 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
  • 响应401或402状态码
  • 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

官方参考索引

能力文档
listCatalogCategorieslistCatalogCategories
searchCatalogItemssearchCatalogItems
getCatalogItemgetCatalogItem

Prerequisites

  1. 依赖 linkfox-amazon-store-auth；python scripts/check_auth_dependency.py，exit 42 时需先安装授权 skill。
  2. 应用需具备 Catalog Items 相关角色；searchCatalogItems 按 identifiers+SKU 检索时 query 须带 sellerId（脚本在 identifiersType=SKU 时自动使用入参 sellerId）。

Current Capabilities

能力path脚本
listCatalogCategoriescatalog/v0/categorieslist_catalog_categories.py
searchCatalogItemscatalog/{2022-04-01|2020-12-01}/itemssearch_catalog_items.py
getCatalogItemcatalog/{version}/items/{asin}get_catalog_item.py

默认 Catalog Items 版本：2022-04-01；入参 catalogItemsVersion 可改为 2020-12-01。

共享模块：_spapi_catalog_common.py。

Quick Parameters

  • listCatalogCategories：marketplaceId + asin 或 sellerSku（二选一）。
  • searchCatalogItems：marketplaceIds + keywords 或 identifiers + identifiersType（互斥）；可选 includedData、brandNames、classificationIds、pageSize、pageToken。
  • getCatalogItem：asin、marketplaceIds；可选 includedData、locale。

Scripts

export LINKFOXAGENT_API_KEY=""

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

python scripts/search_catalog_items.py '{"sellerId":"A1...","region":"NA","marketplaceIds":["ATVPDKIKX0DER"],"keywords":["wireless mouse"]}'

python scripts/get_catalog_item.py '{"sellerId":"A1...","region":"NA","asin":"B08N5WRWNW","marketplaceIds":["ATVPDKIKX0DER"],"includedData":["summaries","images"]}'

Display Rules

  1. 先看 developerProxy.errcode / httpStatus，再读 categories / catalogItems / catalogItem。
  2. listCatalogCategories 使用 v0 查询键 MarketplaceId（单数），与 search/get 的 marketplaceIds 不同。
  3. 网关 path 白名单需包含 catalog/v0/ 与 catalog/2022-04-01/（或 2020-12-01）。

Important Limitations

  • 本 skill 读的是 Amazon 商品目录（Catalog），不是卖家订单；订单见 linkfox-amazon-store-orders。
  • includedData、返回字段以 Amazon schema 为准，详见 references/api.md。

积分消耗规则

不消耗积分。

Feedback： skillName：linkfox-amazon-store-catalog。

更多跨境 skill：LinkFox Skills

相关技能

亚马逊-店铺订单

通过 /spApi/developerProxy 调用 SP-API Orders，覆盖 v2026-01-01 与 v0 的查询、发货与管制订单接口。

14 次安装

亚马逊-店铺Listing管理

通过统一代理端点调用亚马逊 SP-API 的 Listings、Restrictions 与 Product Type Definitions。

14 次安装

亚马逊-店铺定价

选定亚马逊卖家店铺后，按 ASIN/SKU 单条或批量拉取 SP-API Product Pricing 报价、竞争摘要与 FOEP 数据。

15 次安装

亚马逊-店铺数据上传

亚马逊店铺 Feeds（与 linkfox-amazon-store-auth / report / listings / pricing / orders 同系列），经 /spApi/developerProxy 调用 SP-API Feeds v2021-06-30：createFeedDocument、getFeedDocument、createFeed、getFeed、getFeeds、cancelFeed；另含 upload_feed_document 向预签名 URL 上传内容。当用户提到亚马逊 Feed、提交库存/Listing Feed、POST_FLAT_FILE、feedType、feedDocumentId、feedId、取消 Feed、查询 Feed 处理状态、Feeds API、SP-API 上传文件 时触发。

14 次安装

亚马逊-店铺授权

亚马逊店铺授权与管理技能，提供完整的授权流程、令牌刷新、已授权店铺查询以及授权状态查询能力。获取授权链接时店铺名 sellerName 为必填，用于区分已授权店铺。当用户提到亚马逊店铺授权、绑定亚马逊店铺、刷新令牌、查询店铺授权状态、管理授权店铺、Amazon seller authorization, bind Amazon seller account, refresh access token, query store token status, manage authorized stores时触发此技能。只要其需求涉及亚马逊卖家账号授权、令牌生命周期管理或店铺列表查询，也应触发此技能。

19 次安装

亚马逊-店铺A+页面

经 SP-API A+ Content Management v2020-11-01 管理亚马逊 A+ 页面文档的检索、创建、更新、关联、审核与暂停。

14 次安装