Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-adsgit clone --depth 1 https://github.com/linkfox-ai/linkfox-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/linkfox-ai/linkfox-skills/linkfox-amazon-ads)<a href="https://agentmods.dev/skills/linkfox-ai/linkfox-skills/linkfox-amazon-ads"><img src="https://agentmods.dev/badge/skills/linkfox-ai/linkfox-skills/linkfox-amazon-ads/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/linkfox-ai/linkfox-skills/linkfox-amazon-ads"><img src="https://agentmods.dev/badge/skills/linkfox-ai/linkfox-skills/linkfox-amazon-ads.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.06595 |
| Opus 5.5 | $0.00000 | $0.02638 |
| Sonnet 5.5 | $0.00000 | $0.01319 |
| Haiku 4.5 | $0.00000 | $0.00660 |
Grade A, and why
linkfox-amazon-ads scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
- **完整参数**:每个子能力的请求参数、响应字段、错误码、curl 示例见 `references/linkfox-amazon-ads-<auth|manager|report>.md`(文件内含该子能力 SKILL.md 正文与 api.md 全文);manager 的 SP/SB/SD 过滤器/枚举/字段见 `references/api/{sp,sb,sd}.md`,report 的报告类型规格见 `references/r How it starts
The opening of the file, as written. The whole thing — 217 lines — stays where its author put it; the contents beside it link to each section on GitHub.
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,tool_keyamazon_ads):为新账号生成 LWA OAuth 授权链接,一次授权自动发现并绑定同账号下所有可用站点的广告 profile(每站点一个profileId);查询已授权账号 × 站点列表与 profile 列表;读取与刷新访问令牌(accessToken1 小时有效);为下游解析profileId。支持NA(美加墨巴)/EU(英德法意西荷印等)/FE(日澳新)三大区域,默认NA。 - 广告管理(子能力
linkfox-amazon-ads-manager,tool_keyamazon_ads):查询(list)与创建/修改(create/update)SP/SB/SD 三条产品线的广告活动、广告组、关键词、否定关键词、商品广告、定向、否定定向、创意、预算规则等实体元数据;含出价调整、预算修改、状态变更、Budget Rules;自动分页、过滤器结构规范化、多账号profileId解析。写操作遵循财务安全指引(先确认再执行、执行后输出回执)。 - 广告报告(子能力
linkfox-amazon-ads-report,tool_keyamazon_ads):一站式获取 SP/SB/SD 全量广告报告,脚本内部完成报告创建 → 等待生成 → 下载 → 解压,直接返回结构化数据;支持全链路模式与仅轮询模式(用reportId救回上次超时)。每个reportTypeId的可用columns/groupBy/filters/timeUnit/日期约束以references/report-types/<adProduct-dir>/<reportTypeId>.md为单一真相源。 - 链路依赖:manager 与 report 调用前必须先经 auth 拿到
profileId(数字,内部传递不播报);令牌过期(下游 HTTP 401)时回 auth 用refresh_token.py续签。多账号场景按countryCode/accountName澄清,严禁让用户直接报profileId数字、严禁歧义下挑第一个。
❌ 边界与限制
- API Key 必需:所有工具均需环境变量
LINKFOX_AGENT_API_KEY(或LINKFOXAGENT_API_KEY);各子能力独立计费、独立限频。 - accountName 必填:调
authorize_url.py前必须先向用户确认一个非空账号名。 - 令牌时效:
accessToken有效期 1 小时,过期后下游返回 HTTP 401,需用refresh_token.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 天,
sbPurchasedProduct731 天,GrossAndInvalids 系列 365 天(以 frontmatterdateRange.maxSpanDays为准);回溯窗口 SP 默认 95 天、SB 60 天、GrossAndInvalids 365 天(以dateRange.dataRetentionDays为准);数据延迟约 12 小时。 - 未覆盖:Sponsored Television (ST) / Amazon DSP;Brand Analytics / Retail Analytics / Attribution 报告;报告删除/修改/定时任务。
- 计费约束:同一会话同一参数组合默认只调用一次;失败或空结果不得自动换关键词、翻页或连续试探;需继续检索时先向用户说明会产生额外消耗(各子能力计费规则见
skills-version.json对应条目与 references 内 api.md 的costToken字段)。 - 不在范围内:店铺运营(Listing 刊登/订单/库存,用 SP-API 系列)、选品调研(用亚马逊选品系列)、1688 找货源、TikTok/沃尔玛等其他平台、与平台或卖家的直接沟通。
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- references/api/sb.md 4.0 KB
- references/api/sd.md 7.6 KB
- references/api/sp.md 5.1 KB
- references/linkfox-amazon-ads-auth.md 13 KB
- references/linkfox-amazon-ads-manager.md 14 KB
- references/linkfox-amazon-ads-report.md 22 KB
- references/onboarding.md 2.0 KB
- references/report-types/index.md 552 B
- references/report-types/sb/index.md 562 B
- references/report-types/sb/sbAdGroup.md 3.8 KB
- references/report-types/sb/sbAds.md 3.2 KB
- references/report-types/sb/sbCampaignPlacement.md 3.5 KB
- references/report-types/sb/sbCampaigns.md 4.1 KB
- references/report-types/sb/sbGrossAndInvalids.md 1.6 KB
- references/report-types/sb/sbPromptAdExtension.md 3.9 KB
- references/report-types/sb/sbPurchasedProduct.md 2.2 KB
- references/report-types/sb/sbSearchTerm.md 3.6 KB
- references/report-types/sb/sbTargeting.md 4.1 KB
- references/report-types/sd/index.md 428 B
- references/report-types/sd/sdAdGroup.md 3.6 KB
- references/report-types/sd/sdAdvertisedProduct.md 3.4 KB
- references/report-types/sd/sdCampaigns.md 3.7 KB
- references/report-types/sd/sdGrossAndInvalids.md 2.4 KB
- references/report-types/sd/sdPurchasedProduct.md 2.7 KB
- references/report-types/sd/sdTargeting.md 4.5 KB
- references/report-types/sp/index.md 496 B
- references/report-types/sp/spAdvertisedProduct.md 2.7 KB
- references/report-types/sp/spCampaigns.md 6.2 KB
- references/report-types/sp/spGrossAndInvalids.md 2.6 KB
- references/report-types/sp/spPromptAdExtension.md 3.7 KB
- references/report-types/sp/spPurchasedProduct.md 2.7 KB
- references/report-types/sp/spSearchTerm.md 4.6 KB
- references/report-types/sp/spTargeting.md 5.2 KB
- scripts/auth/_lf_output.py 6.3 KB runs code
- scripts/auth/authorize_url.py 6.7 KB runs code
- scripts/auth/authorized_stores.py 2.3 KB runs code
- scripts/auth/profiles.py 2.8 KB runs code
- scripts/auth/refresh_token.py 3.0 KB runs code
- scripts/auth/store_tokens.py 3.1 KB runs code
- scripts/manager/_common.py 30 KB runs code
- scripts/manager/check_auth_dependency.py 6.4 KB runs code
- scripts/manager/sb/create_ad_groups.py 1.7 KB runs code
- scripts/manager/sb/create_ads.py 2.3 KB runs code
- scripts/manager/sb/create_budget_rules.py 1.7 KB runs code
- scripts/manager/sb/create_campaigns.py 1.7 KB runs code
- scripts/manager/sb/list_ad_groups.py 2.9 KB runs code
- scripts/manager/sb/list_ads.py 3.0 KB runs code
- scripts/manager/sb/list_budget_rules.py 2.7 KB runs code
- scripts/manager/sb/list_campaigns.py 3.0 KB runs code
- scripts/manager/sb/update_ad_groups.py 1.7 KB runs code
- scripts/manager/sb/update_ads.py 1.7 KB runs code
- scripts/manager/sb/update_budget_rules.py 1.7 KB runs code
- scripts/manager/sb/update_campaigns.py 1.7 KB runs code
- scripts/manager/sd/create_ad_groups.py 1.7 KB runs code
- scripts/manager/sd/create_budget_rules.py 1.7 KB runs code
- scripts/manager/sd/create_campaigns.py 1.7 KB runs code
- scripts/manager/sd/create_creatives.py 1.7 KB runs code
- scripts/manager/sd/create_negative_targets.py 1.7 KB runs code
- scripts/manager/sd/create_product_ads.py 1.7 KB runs code
- scripts/manager/sd/create_targets.py 1.6 KB runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 217 lines · 0 tokens per session scan A 5be4efeb0170
linkfox-amazon-ads is a skill published in the GitHub repository linkfox-ai/linkfox-skills (119 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 6,595 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
linkfox-amazon-ads compared with skills from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| linkfox-amazon-adslinkfox-ai/linkfox-skills | Skill | 119 | yesterday | MIT | A | 0 | Claude Code, Codex |
| e-commercefirecrawl/web-agent | Skill | 1.3k | 15d ago | MIT | A | 29 | Claude Code, Codex |
| ecom-image2buluslan/gpt-image2-ecommerce | Skill | 442 | 1mo ago | MIT | A | 198 | Claude Code |
| review-analyzer-skillbuluslan/review-analyzer-skill | Skill | 139 | 1mo ago | MIT | A | 340 | Claude Code |
| descricao-de-produtoricneves-ai/flowgrammers-skills | Skill | 117 | 1mo ago | MIT | A | 57 | Claude Code, Codex |
| shadcnspree/spree | Skill | 16k | today | BSD-3-Clause | A | 90 | Claude Code, Codex |
| animatespree/spree | Skill | 16k | today | BSD-3-Clause | A | 96 | Claude Code, Codex |