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 才能调用。按下列顺序处理,不要跳过:

  1. 先调 linkfox-amazon-ads-auth 的 authorized_stores.py,拉出用户已授权的账号 × 站点清单。
  2. 根据用户提到的站点匹配 countryCode:
    • 只有 1 个候选 → 静默使用对应 profileId;不要向用户播报该数字。
    • ≥ 2 个候选 → 必须用 accountName 向用户确认,禁止默认选择第一个。
    • 0 个候选 → 告知用户该站点未授权,引导使用 linkfox-amazon-ads-auth 完成授权。
  3. 严禁要求用户直接提供 profileId 数字。
  4. 严禁在账号有歧义时自行选择默认账号。
Installs
69
GitHub Stars
109
First Seen
Aug 22, 2026