Agent Skills
返回列表
🏢

Amazon Ads 广告管理

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 的分析同学