Agent skill · linkfox-ai
linkfox-amazon-ads-sp-insights-report
亚马逊广告 Sponsored Products（SP）洞察报告技能，统一获取 Audience 受众细分表现和 Search Term Impression Share/Rank 搜索词展示份额/排名两类 Amazon Ads Reporting API v1 beta 报告。自动完成 profile 到 advertiser account 映射、报告创建、状态轮询、多分片 CSV 下载和落盘。只有用户明确要求 SP 受众报告、SP 搜索词展示份额或展示份额排名时触发；普通 SP 搜索词表现报告、SB/SD/DSP 报告不得触发。本技能依赖 linkfox-amazon-ads-auth。
What it needs
About 4k tokens when loaded.
What this skill does
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 打 DEPENDENCYMISSING）。 ⚠️ 多账号场景：调用前必须解析好 profileId 用户经常只说自然语言（“美国站”“日本站”“我的店铺”），本 Skill 的所有入口都必须拿到数字 profileId 才能调用。按下列顺序处理，不要跳过： 1. 先调 linkfox-amazon-ads-auth 的 authorizedstores.py，拉出用户已授权的账号 × 站点清单。 2. 根据用户提到的站点匹配 countryCode： 只有 1 个候选 → 静默使用对应 profileId；不要向用户播报该数字。 ≥ 2 个候选 → 必须用 accountName 向用户确认，禁止默认选择第一个。 0 个候选 → 告知用户该站点未授权，引导使用 linkfox-amazon-ads-auth 完成授权。 3. 严禁要求用户直接提供 profileId 数字。 4. 严禁在账号有歧义时自行选择默认账号。 完整决策表见 linkfox-amazon-ads-auth SKILL.md 的多账号场景说明。 调用方式 API 端点：POST /amazonAds/developerProxy（脚本内部按顺序调用三个 Ads v1 路径；完整参数/响应/错误码见 references/api.md） Python 脚本：python scripts/<脚本名>.py '<JSON 参数>' [--inline] [--no-cache]（可用脚本见下文） 成本约束：本工具不消耗算力；同一会话、同一报告类型和同一参数组合默认只调用一次，成功结果缓存 24 小时。失败、未完成或空报告不得自动换日期、切换账号或连续试探。 输出策略（脚本默认行为）： 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-ads-sp-insights-report-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<session> 取自环境变量 SESSIONID；禁止写入 /tmp，当前目录不可写则报错） 报告 CSV 分片写入同一会话的 data/；最终响应不暴露 Amazon 预签名 URL 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout 响应体 > 8 KB：落盘后 stdout 只输出摘要 加 --inline 强制全量打印到 stdout（同样落盘）；加 --no-cache 强制重新获取 读数据建议：先看摘要和 preview；响应 JSON 用 jq / ConvertFrom-Json 按需抽取，完整报告行从 dataFiles[].path 指向的文件用 CSV 工具或 Import-Csv 读取，避免整份报告进入上下文。 解决认证和算力问题 发生以下情况时，按 references/onboarding.md 引导解决： 异常情况 未配置 API Key：环境变量未配置 LINKFOXAGENTAPIKEY，也未配置 LINKFOXAGENTAPIKEY 响应 401 或 402 状态码 响应提示算力、余额、套餐或额度不足 Core Concepts 覆盖范围：只覆盖 Sponsored Products Audience 和 Search Term Impression Share/Rank 两类 Reporting API v1 beta 报告 一站式：自动完成 advertiser account 映射 → 创建报告 → 等待生成 → 下载全部 CSV/gzip 分片 → 返回预览与文件路径 双入口、共享流程：两个公开入口分别固定报告类型，共用 reportingv1workflow …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills linkfox-ai/linkfox-amazon-ads-sp-insights-report