Amazon Ads 广告管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-ads-manager-111。
技能介绍
要解决的问题
在 Agent 里管理 Amazon 广告时,难点往往不在「调哪个 HTTP 路径」,而在 profileId 与 token 链路、SP/SB/SD 三套 API 形态不一,以及 list 时 过滤器字段写法各不相同。手工拼 developerProxy 请求、跟 nextToken 或 startIndex 翻页,还容易被 SB V3/V4 混用打断流程。
技能如何工作
本技能通过 Python 脚本 + POST /amazonAds/developerProxy 完成广告的 查询(list)与创建/修改(create/update)。调用时传入数字 profileId 与 region(NA/EU/FE),由服务端解析 token;不要先 storeTokens 再传 raw token。
- SP(Sponsored Products)v3:覆盖 campaigns、adGroups、keywords、negativeKeywords、productAds、targets 及预算规则等,脚本在
scripts/sp/。 - SB:默认走 V4(
scripts/sb/v4/);Legacy 或多广告组结构需用 V4,V3 仅用于已确认的 Legacy campaign。 - SD(Sponsored Display)v3:REST +
startIndex/count分页,支持扩展字段路径切换。
默认 fetchAll=true 自动分页(maxPages=50 兜底),并对常见写错的过滤器做规范化。返回的是实体 元数据(id、名称、状态等);曝光、点击、花费等需用 linkfox-amazon-ads-report 按 id 关联。
多账号场景下须先通过 linkfox-amazon-ads-auth 的 authorized_stores.py 解析站点与账号,同站多号时必须向用户澄清,禁止让用户报 profileId 数字或在歧义下默认选第一个。
边界与注意
- 强依赖
linkfox-amazon-ads-auth;未安装脚本exit 42。 - 不支持 DELETE;归档可通过
update将 state 设为ARCHIVED(不可逆)。 - 创建/更新会直接生效并影响花费;未获明确授权时应先输出确认摘要再执行。
- DSP/ST、SB 部分高级能力与 SD 非基础实体不在本技能范围;报表与授权分别交给 report 与 auth 技能。
使用场景
- 用户说「美国站」要查活跃 SP 活动,需先解析 profileId 再 list_campaigns 并跟分页
- 要把某 SP 关键词出价调高,需 update_keywords 且创建类操作前先做花费确认
- Legacy SB 活动结构不明时,先用 V4 list 确认再决定是否走 sb/v3
- 按 ASIN 反查 SD 商品广告投放时,用客户端 asinFilter 并配合 campaignIdFilter 收窄
适合人员
- 负责北美/EU 多店铺广告投放、需用自然语言改出价与状态的亚马逊卖家
- 广告运营同学要经常批量 list 活动/广告组/关键词并偶尔 create 新定向的实操者
- 用 Agent 接 LinkFox 工具链、要把 ads-auth 与 ads-manager 串起来的跨境技术运营
- 需要区分元数据查询与报表指标、会用 report 技能按 id join 的分析同学