用途:面向亚马逊卖家的 Listing 刊登与商品类型定义管理,属于 Amazon Store 系列技能,依赖 linkfox-amazon-store-auth 完成选店(sellerId+region)。
主要能力:获取单条 Listing(getListingsItem)、搜索刊登列表(searchListingsItems)、部分更新(patchListingsItem)、创建或全量更新(putListingsItem)、删除刊登(deleteListingsItem)、查询 ASIN 刊登限制(getListingsRestrictions),以及搜索 product type(searchDefinitionsProductTypes)和获取 product type 定义 JSON Schema(getDefinitionsProductType)。
使用方式:通过 POST /spApi/developerProxy 调用,请求体区分操作,由服务端解析 token(勿传 amzAccessToken,除非兼容旧调用);也可用 Python 脚本,如 python scripts/get_listings_item.py '{"sellerId":"A1...","region":"NA","sku":"MY-SKU","marketplaceIds":["ATVPDKIKX0DER"]}'。需先配置 LINKFOXAGENT_API_KEY,并运行 python scripts/check_auth_dependency.py 检查依赖。脚本默认将完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下,响应超 8 KB 时 stdout 只输出摘要,可用 --inline 强制全量打印。
限制:searchListingsItems 的 identifiers、variationParentSku、packageHierarchySku 三者互斥,identifiers 最多 20 个,pageSize ≤ 20;put、delete、getDefinitionsProductType 的 marketplaceIds 仅允许一个;patch 至少 1 条 JSON Patch;写操作需谨慎,delete 尤其如此。连续触发 400/403/404/429 时网关返回 450/453/454/459 并冷却,应停止自动重试。本技能不消耗算力。其余细节见 references/api.md。