linkfox-amazon-store-auth

linkfox-amazon-store-report

1. 运行

   python scripts/check_auth_dependency.py

   ；若 exit code 42 且 stderr 含

   DEPENDENCY_MISSING:

   ，请先安装

   linkfox-amazon-store-auth

   。
2. 不要在本 skill 内绕过依赖实现授权或令牌逻辑。

• scripts/get_listings_item.py

  — 单条 listing。

• scripts/search_listings_items.py

  — 搜索列表。

• scripts/patch_listings_item.py

  — PATCH 部分更新。

• scripts/put_listings_item.py

  — PUT 创建或全量更新。

• scripts/delete_listings_item.py

  — DELETE 删除刊登。

• scripts/get_listings_restrictions.py

  — GET 刊登限制。

• scripts/search_definitions_product_types.py

  — GET 搜索 product type。

• scripts/get_definitions_product_type.py

  — GET product type JSON Schema。

• scripts/check_auth_dependency.py

  — 依赖检测。

export LINKFOXAGENT_API_KEY="<your-key>"

python scripts/get_listings_item.py '{"sellerId":"A1...","region":"NA","sku":"MY-SKU","marketplaceIds":["ATVPDKIKX0DER"]}'

python scripts/search_listings_items.py '{"sellerId":"A1...","region":"NA","marketplaceIds":["ATVPDKIKX0DER"],"identifiers":["B0XXXXXXXX"],"identifiersType":"ASIN"}'

python scripts/patch_listings_item.py '{"sellerId":"A1...","region":"NA","sku":"MY-SKU","marketplaceIds":["ATVPDKIKX0DER"],"productType":"LUGGAGE","patches":[{"op":"replace","path":"/attributes/item_name","value":[{"value":"New Title","marketplace_id":"ATVPDKIKX0DER"}]}]}'

python scripts/put_listings_item.py '{"sellerId":"A1...","region":"NA","sku":"MY-SKU","marketplaceIds":["ATVPDKIKX0DER"],"productType":"LUGGAGE","requirements":"LISTING","attributes":{"item_name":[{"value":"Title","marketplace_id":"ATVPDKIKX0DER"}]}}'

python scripts/delete_listings_item.py '{"sellerId":"A1...","region":"NA","sku":"MY-SKU","marketplaceIds":["ATVPDKIKX0DER"]}'

python scripts/get_listings_restrictions.py '{"sellerId":"A1...","region":"NA","asin":"B0XXXXXXXX","marketplaceIds":["ATVPDKIKX0DER"]}'

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

python scripts/get_definitions_product_type.py '{"sellerId":"A1...","region":"NA","productType":"LUGGAGE","marketplaceIds":["ATVPDKIKX0DER"],"querySellerId":"A1..."}'

1. items 类接口：路径含 卖家 SKU 时强调非 ASIN；searchListingsItems 路径仅到

   sellerId

   。
2. 展示网关结果时说明

   errcode

   /

   httpStatus

   ；成功后再解析

   body

   （

   listing

   /

   searchResult

   /

   patchResult

   /

   putResult

   /

   deleteResult

   /

   restrictionsResult

   /

   productTypesSearchResult

   /

   productTypeDefinitionResult

   ）。
3. searchListingsItems 多页：从

   searchResult

   取下一页 token（字段名以 Amazon 响应为准），传入

   pageToken

   。
4. restrictions / definitions 路径与 items 不同；1005 时需为

   listings/2021-08-01/restrictions

   与

   definitions/2020-09-01/productTypes

   等前缀分别配置白名单（以运维为准）。
5. patch / put / delete 为写操作；delete 须谨慎；put 为全量

   attributes

   ；patch 仅顶层属性可 patch（以官方为准）。

• marketplaceIds：get / searchListingsItems 脚本对多 id 常仅取第一个；put / delete / getDefinitionsProductType 多于 1 个即报错；patch、restrictions、searchDefinitionsProductTypes 行为见

  references/api.md

  。
• searchListingsItems：

  pageSize

  ≤ 20；

  identifiers

  ≤ 20。
• patch：

  patches

  至少 1 条；JSON Patch 的

  delete

  与 deleteListingsItem 接口不同；Vendor 对部分 patch 可能 400。
• put：LISTING_OFFER_ONLY 对 Vendor 400。
• 白名单：

  listings/.../items

  、

  listings/.../restrictions

  、

  definitions/2020-09-01/productTypes

  均须按需放行。

references/api.md

skillName

linkfox-amazon-store-listings

python scripts/response_io.py run --script scripts/check_auth_dependency.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

Pick

--out-dir

outside any git working tree (e.g.

/tmp/...

on Unix,

%TEMP%/...

on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.

This skill exposes multiple entry scripts:

check_auth_dependency.py

,

delete_listings_item.py

,

get_definitions_product_type.py

,

get_listings_item.py

,

get_listings_restrictions.py

,

patch_listings_item.py

,

put_listings_item.py

,

search_definitions_product_types.py

,

search_listings_items.py

. Pass

--script scripts/<name>.py

to choose the one you need.

run

read

--limit/--offset

--format json|jsonl|csv|table

• High field count per record, or fields you don't need
• Batch/paginated results (multiple items per call)
• Long-text fields (descriptions, reviews, HTML, time series)
• Output reused across later steps rather than consumed immediately

read