linkfox-amazon-ads-sp-insights-report
Installation
SKILL.md
Amazon Ads SP 洞察报告获取
两类 Sponsored Products 专项报告一站式获取:脚本经 developerProxy 传 profileId(服务端解析 token),自动完成 advertiser account 映射、报告创建、等待(通常约 2–10 分钟)、多分片 CSV 下载和落盘。
脚本使用 Amazon Reporting API v1 beta 允许的固定字段组合,不接受调用方自由拼接字段。Audience 与 Search Term Impression Share/Rank 的完整字段依据分别见 references/sp-audience-reporting-v1.md 和 references/sp-search-impression-share-v1.md。
依赖 linkfox-amazon-ads-auth(脚本启动自动检查;未安装时 exit 42,stderr 打 DEPENDENCY_MISSING)。
⚠️ 多账号场景:调用前必须解析好 profileId
用户经常只说自然语言(“美国站”“日本站”“我的店铺”),本 Skill 的所有入口都必须拿到数字 profileId 才能调用。按下列顺序处理,不要跳过:
- 先调
linkfox-amazon-ads-auth的authorized_stores.py,拉出用户已授权的账号 × 站点清单。 - 根据用户提到的站点匹配
countryCode:- 只有 1 个候选 → 静默使用对应
profileId;不要向用户播报该数字。 - ≥ 2 个候选 → 必须用
accountName向用户确认,禁止默认选择第一个。 - 0 个候选 → 告知用户该站点未授权,引导使用
linkfox-amazon-ads-auth完成授权。
- 只有 1 个候选 → 静默使用对应
- 严禁要求用户直接提供
profileId数字。 - 严禁在账号有歧义时自行选择默认账号。