Agent skill · linkfox-ai
linkfox-amazon-ads
亚马逊广告（Amazon Ads）全链路一站式 AI 工具集，整合授权与令牌管理、SP/SB/SD 广告查询与创建修改、广告报告一站式获取 3 项子能力，覆盖授权→管理→报表全链路。
What it needs
About 5k tokens when loaded.
What this skill does
Linkfox 亚马逊广告（Amazon Ads） 亚马逊广告（Amazon Ads）全链路一站式 AI 工具集，整合 3 项子能力，覆盖授权与令牌、SP/SB/SD 广告查询与写操作、广告报告一站式获取。三条子能力构成「授权 → 管理 → 报表」链路：linkfox-amazon-ads-auth 是前置依赖（产出 profileId + 访问令牌），linkfox-amazon-ads-manager（实体元数据）与 linkfox-amazon-ads-report（指标报表）均依赖它。各子能力完整参数、响应字段与错误码见 references/ 下对应文件，可执行脚本见 scripts/<auth manager report>/。 能力边界 ✅ 能力范围 授权与令牌管理（子能力 linkfox-amazon-ads-auth，toolkey amazonads）：为新账号生成 LWA OAuth 授权链接，一次授权自动发现并绑定同账号下所有可用站点的广告 profile（每站点一个 profileId）；查询已授权账号 × 站点列表与 profile 列表；读取与刷新访问令牌（accessToken 1 小时有效）；为下游解析 profileId。支持 NA（美加墨巴）/ EU（英德法意西荷印等）/ FE（日澳新）三大区域，默认 NA。 广告管理（子能力 linkfox-amazon-ads-manager，toolkey amazonads）：查询（list）与创建/修改（create/update）SP/SB/SD 三条产品线的广告活动、广告组、关键词、否定关键词、商品广告、定向、否定定向、创意、预算规则等实体元数据；含出价调整、预算修改、状态变更、Budget Rules；自动分页、过滤器结构规范化、多账号 profileId 解析。写操作遵循财务安全指引（先确认再执行、执行后输出回执）。 广告报告（子能力 linkfox-amazon-ads-report，toolkey amazonads）：一站式获取 SP/SB/SD 全量广告报告，脚本内部完成报告创建 → 等待生成 → 下载 → 解压，直接返回结构化数据；支持全链路模式与仅轮询模式（用 reportId 救回上次超时）。每个 reportTypeId 的可用 columns/groupBy/filters/timeUnit/日期约束以 references/report-types/<adProduct-dir>/<reportTypeId>.md 为单一真相源。 链路依赖：manager 与 report 调用前必须先经 auth 拿到 profileId（数字，内部传递不播报）；令牌过期（下游 HTTP 401）时回 auth 用 refreshtoken.py 续签。多账号场景按 countryCode/accountName 澄清，严禁让用户直接报 profileId 数字、严禁歧义下挑第一个。 ❌ 边界与限制 API Key 必需：所有工具均需环境变量 LINKFOXAGENTAPIKEY（或 LINKFOXAGENTAPIKEY）；各子能力独立计费、独立限频。 accountName 必填：调 authorizeurl.py 前必须先向用户确认一个非空账号名。 令牌时效：accessToken 有效期 1 小时，过期后下游返回 HTTP 401，需用 refreshtoken.py 续签。 manager 只给元数据，不含指标：返回实体字段（id/名称/状态/匹配类型等）；曝光/点击/花费/转化等指标交给 report，按 id join。 manager 不支持 DELETE：可通过 update state=ARCHIVED 归档，但不可逆；SB keywords/targets 等无 list all（Amazon 官方未提供，需按 id 单查，不在本 skill）；SD 非基础实体接口（brandSafety/recommendations/forecasts/optimizationRules/locations 等）不在范围。 report 日期约束：多数报告跨度上限 31 天，sbPurchasedProduct 731 天，GrossAndInvalids 系列 365 天（以 frontmatter dateRange.maxSpanDays 为准）；回溯窗口 SP 默认 95 天、SB 60 天、GrossAndInvalids 365 天（以 dateRange.dataRetentionDays 为准）；数据延迟约 12 小时。 未覆盖：Sponsored Television (ST) / Amazon DSP；B …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills linkfox-ai/linkfox-amazon-ads