让 agent 直接拉亚马逊广告报表：Ads 报告技能使用指南

让 agent 直接拉亚马逊广告报表：Amazon Ads 报告技能使用指南

每周看广告数据不用再导出整理了——装上这个技能，对 agent 说一句"拉上周的关键词报告"，它会按流程生成报告、等它出、下载解压，把能直接分析的数据交回给你。

查看原图 ↗

实测：技能触发与依赖检查

本机在 Claude Code 里真实触发过一次（截图为真实会话捕获）：agent 读技能说明后，如实提示它依赖的授权技能 linkfox-amazon-ads-auth 还没装——这是它的第一道检查，装好授权技能后即可正常拉报告。

查看原图 ↗

在 WorkBuddy 图形界面里实测（2026-09-16）

WorkBuddy 是腾讯出品的图形界面版 AI 助手（和 Claude Code 一样属于"能装技能的那个软件"，不用敲命令行）。把技能包装进它的技能目录后，新建任务、照上面的模板说一句话，它会真实加载技能、跑检查脚本，把"缺什么"说清楚。下面是本机实测（1 分 10 秒，消耗 1.84 积分）：

它检查后如实汇报：

• 已就绪：起步时真实踩了个坑并当场修好：报表脚本检测到依赖的 ads-auth 技能没装（exit 42）→ agent 在 WorkBuddy 推荐市场搜到官方打包技能「Linkfox 亚马逊广告 v1.2.3」（含授权/管理/报告三项能力）→ 安装并建好依赖链接 → 复检 DEPENDENCY_OK，授权脚本（authorized_stores.py、refresh_token.py、authorize_url.py）全部就位
• 阻断项：环境变量 LINKFOX_AGENT_API_KEY（或 LINKFOXAGENT_API_KEY）没配置，连第一步"拉取已授权店铺清单"都调不了
• 它给出的下一步：把 LinkFox 开放平台的 Agent API Key 发给 agent；拿到后它先拉授权店铺清单确认站点，再按周拉 SP 广告报告（字段含曝光、点击、花费、7 天销售额、ACOS），报告生成约 2–10 分钟它会持续轮询

查看原图 ↗

看图要点：回复底部有"已完成"耗时与积分消耗（模型 GLM-5.3-Flash）；因为没配 Key，agent 没有编造数据，而是按技能规范停下来向用户要 Key——装对了技能就该是这个表现。这一轮是真实排错：依赖缺失→市场安装→复检通过，全程有命令回显，可作为你遇到 exit 42 时的处理参照。

装好后，你可以这样开口

周复盘：

用广告报表技能拉上周 SP 广告的关键词报告，按花费降序，标出 ACOS 超过 40% 的词。

三品对比：

分别拉这三个产品近 30 天的 SD 报告，对比点击率和转化差异。

异常排查：

拉最近的流量异常报告，列出曝光骤降的广告组。

agent 会怎么回应（官方文档口径）

报告覆盖 Sponsored Products、Sponsored Brands、Sponsored Display 三类：广告活动、关键词、搜索词、投放商品、购买商品、广告组、流量异常等。流程是"创建报告 → 等待（约 2-10 分钟）→ 下载解压 → 返回结构化数据"；选哪些列、怎么分组由 agent 先查技能自带的报告类型清单再传参，不会瞎选。

第一次跑通前要准备什么

1. 装两个技能：先装授权技能 linkfox-amazon-ads-auth（负责广告账号授权），再装本技能。本站包见文末。
2. 多账号：先让 agent 解析好用哪个 profileId 再发起。
3. 费用预期：报告拉取经 LinkFox 接口按其计费规则。

出问题怎么办

• 报 DEPENDENCY_MISSING：授权技能没装或没配好，先完成 ads-auth。
• 等了 10 分钟没结果：报告生成高峰会更慢，让 agent 查任务状态；超过技能说明的等待上限它会如实报错，不会假装成功。

安全注意（重点读）

注册表安全扫描标了较重提示，如实转述：这个技能包含静默反馈上报和可重定向的带凭据请求路径。三句缓解：用测试账号起步；别跑含客户资料的任务；首次使用时留意它实际请求的接口地址与官方文档一致。

配对资源

固定版本 v1.0.8 完整包（含 32 份报告类型规格文档）点此打开本站资源页：Amazon 广告报告技能（免费下载）。