profileId

1. 先调

   linkfox-amazon-ads-auth

   的

   authorized_stores.py

   拉出用户已授权的账号 × 站点清单。
2. 根据用户提到的站点（映射到

   countryCode

   ，如 美国→

   US

   ）匹配候选 profile：
   • 只有 1 个候选 → 静默取对应 profileId，继续调用；不要把 profileId 数字播报给用户。
   • ≥ 2 个候选（同站点下多个授权账号） → 必须向用户澄清，用

     accountName

     问："你在美国站授权了 A 和 B 两个账号，这次用哪个？"
   • 0 个候选 → 告知用户该站点未授权，引导去

     linkfox-amazon-ads-auth

     做授权。
3. 严禁让用户直接报 profileId 数字。
4. 严禁在歧义下"挑第一个"或"选默认"绕过澄清。

linkfox-amazon-ads-auth

• 自动分页：

  fetchAll=true

  （默认）跟随分页 token 到结束或

  maxPages=50

  兜底（约 5000 条，超出标

  truncated=true

  ）；SP / SB 用

  nextToken

  ，SD 用

  startIndex + count

  偏移分页
• 过滤器结构不统一：不同字段需要不同写法（详见下方"过滤器结构速查"）；本 skill 已对常见写错格式做自动兜底规范化，但仍建议按速查表准确传入
• 只给 metadata，不含指标：返回实体字段（id / 名称 / 状态 / 匹配类型 等），曝光 / 点击 / 花费 / 转化 等指标要调

  linkfox-amazon-ads-report

  ，按 id join
• 支持 create / update：各模块下

  create_*.py

  /

  update_*.py

  脚本创建或修改实体（campaign / adGroup / keyword / target / productAd / creative / budgetRule），payload 透传 Amazon 原生格式
• SB 和 SP 的差异：SB 只有 campaigns/adGroups/ads 三个 list；其 keywords/targets 官方未提供 list all
• SD 接口形态：Sponsored Display 是 v3 REST endpoint，

  GET /sd/<entity>

  + querystring，分页用

  startIndex + count

  ；state / id 类过滤为逗号分隔字符串；

  includeExtendedDataFields:true

  时请求

  /sd/<entity>/extended

  路径。所有过滤字段统一支持

  {"include":[...]}

  入参

{"include":[...]}

{"exclude":[...]}

["EXACT","BROAD"]

"AUTO"

{"queryTermMatchType":"BROAD_MATCH","include":["..."]}

• SP

  matchTypeFilter

  是裸数组

  ["EXACT"]

  （传错本 skill 自动规范化）

• expressionTypeFilter

  反而是 Object（与 matchType 不同）

• asinFilter

  /

  skuFilter

  客户端过滤，建议同时传

  campaignIdFilter

  /

  adGroupIdFilter

  收窄

• 返回字段原样保留；不改名、不翻译、不补算派生指标
• 非 2xx 不自动重试；保留

  httpStatus

  +

  body

  告知用户

• truncated=true

  时明确提示数据未取完

• 删除 / 归档 → 本 skill 不支持 DELETE（可通过 update state 为 ARCHIVED 实现归档，但归档不可逆）
• SB 的 keywords / negativeKeywords / targets / negativeTargets 的 list all → Amazon 官方未提供，需按 id 单查（不在本 skill）
• SD 的按 id 单查 / brandSafety / recommendations / forecasts / optimizationRules / locations 等"非基础实体"接口 → 不在本 skill
• DSP / ST 实体 → 不在本 skill
• 指标报表 →

  linkfox-amazon-ads-report

• 授权 / token / profile →

  linkfox-amazon-ads-auth

1. The functionality or purpose described in this skill does not match actual behavior
2. The skill's results do not match the user's intent
3. The user expresses dissatisfaction or praise about this skill
4. Anything you believe could be improved

references/api.md

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

,

sb/create_ad_groups.py

,

sb/create_ads.py

,

sb/create_budget_rules.py

,

sb/create_campaigns.py

,

sb/list_ad_groups.py

,

sb/list_ads.py

,

sb/list_budget_rules.py

,

sb/list_campaigns.py

,

sb/update_ad_groups.py

,

sb/update_ads.py

,

sb/update_budget_rules.py

,

sb/update_campaigns.py

,

sd/create_ad_groups.py

,

sd/create_budget_rules.py

,

sd/create_campaigns.py

,

sd/create_creatives.py

,

sd/create_negative_targets.py

,

sd/create_product_ads.py

,

sd/create_targets.py

,

sd/list_ad_groups.py

,

sd/list_budget_rules.py

,

sd/list_campaigns.py

,

sd/list_creatives.py

,

sd/list_negative_targets.py

,

sd/list_product_ads.py

,

sd/list_targets.py

,

sd/update_ad_groups.py

,

sd/update_budget_rules.py

,

sd/update_campaigns.py

,

sd/update_creatives.py

,

sd/update_negative_targets.py

,

sd/update_product_ads.py

,

sd/update_targets.py

,

sp/create_ad_groups.py

,

sp/create_budget_rules.py

,

sp/create_budget_rules_association.py

,

sp/create_campaign_negative_keywords.py

,

sp/create_campaign_negative_targets.py

,

sp/create_campaigns.py

,

sp/create_keywords.py

,

sp/create_negative_keywords.py

,

sp/create_negative_targets.py

,

sp/create_product_ads.py

,

sp/create_targets.py

,

sp/list_ad_groups.py

,

sp/list_budget_rules.py

,

sp/list_campaigns.py

,

sp/list_keywords.py

,

sp/list_negative_keywords.py

,

sp/list_product_ads.py

,

sp/list_targets.py

,

sp/update_ad_groups.py

,

sp/update_budget_rules.py

,

sp/update_campaign_negative_keywords.py

,

sp/update_campaign_negative_targets.py

,

sp/update_campaigns.py

,

sp/update_keywords.py

,

sp/update_negative_keywords.py

,

sp/update_negative_targets.py

,

sp/update_product_ads.py

,

sp/update_targets.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