（14747期）Linkfox 亚马逊广告 – 亚马逊广告智能运营中枢

亚马逊广告智能运营中枢 LinkFox 官方出品，覆盖亚马逊 SP/SB/SD 广告授权、管理、报告全链路，支持 OAuth 一键多站绑定、智能出价调价与全量数据报表自动化获取。 使用说明 核心用法 Linkfox 亚马逊广告技能是一套面向亚马逊卖家的全链路广告运营工具集，由 授权认证（auth）、广告管理（manager）、数据报告（report） 三大子能力构成闭环工作流。用户需首先通过 authorize_url.py 完成 LWA OAuth 授权，一次绑定即可自动发现同账号下北美（NA）、欧洲（EU）、远东（FE）三大区域的所有站点 profile；随后借助 manager 子能力查询或修改 SP/SB/SD 各产品线广告实体（活动、广告组、关键词、定向、创意、预算规则等），执行出价调整、预算修改、状态变更等写操作；最终通过 report 子能力一键获取全量广告效果报表，内部自动完成创建→轮询→下载→解压流程，直接返回结构化数据。 显著优点 全链路覆盖：打破传统工具「授权-管理-报表」割裂的痛点，三条子能力深度耦合，profileId 与令牌自动透传，无需人工维护多站点凭证。 多区域多站点支持：原生支持 NA/EU/FE 三大区域，一次 OAuth 授权自动绑定同账号下全部 marketplace，显著降低多站卖家的运营复杂度。 智能写操作防护：所有 create/update 操作遵循「先确认、后执行、输出回执」的财务安全指引，变更不可逆但全程可追溯。 报告自动化：get_report.py 封装报告全生命周期，支持 31 天内任意维度报表（搜索词、购买商品、无效流量等）的自动创建与结构化返回，省去人工轮询与解压步骤。 冷热数据分离架构：manager 专注实体元数据（id/名称/状态/结构），report 专注效果指标（曝光/点击/花费/转化），两者按 id join 可构建完整的广告分析链路。 潜在缺点与局限性 API Key 与计费门槛：所有子能力均需配置 LINKFOXAGENTAPI_KEY，且独立计费、独立限频，中小卖家需关注 token 消耗成本。 令牌时效约束：accessToken 仅 1 小时有效，过期后下游返回 HTTP 401，需调用 refresh_token.py 续签，长会话场景存在中断风险。 功能边界明确：不支持 DELETE 操作（仅支持归档）、SB keywords/targets 无 list all 接口、SD 非基础实体（brandSafety/forecasts 等）未覆盖，ST/DSP/Brand Analytics 等高级功能亦不在范围内。 日期与数据延迟：多数报告跨度上限 31 天，数据延迟约 12 小时，实时性要求高的场景需预留缓冲。 多账号歧义处理：严禁自动挑选首个 profile，多账号场景必须经用户确认 countryCode/accountName，交互步骤增加。 适合的目标群体 亚马逊多站点卖家：需同时运营北美、欧洲、日本等多区域广告账户，追求一站式授权与跨站点数据整合。 广告运营专员/操盘手：日常需大量执行出价调价、预算规则配置、活动状态变更等高频操作，重视写操作安全性与回执可追溯性。 数据分析师/增长团队：依赖搜索词报告、购买商品报告、ACOS/ROAS 指标进行投放策略优化，需要自动化报表获取能力。 品牌广告主：使用 SP/SB/SD 组合投放，需打通实体元数据与效果指标做关联分析。 常规使用风险 计费失控风险：同一会话同一参数组合默认仅调用一次，但失败或空结果时若自动换关键词、翻页或连续试探将产生额外消耗，需在继续检索前向用户明确说明。 写操作不可逆：manager 的 update 操作立即生效且无撤回机制，执行前务必输出确认摘要，避免因误操作导致广告暂停或预算清零。 报告链接过期：extractedFileHttpUrl 仅约 5 分钟有效，超时需重新触发报告流程；轮询耗尽但报告仍在生成时返回 STILL_PROCESSING，需用户决策是否继续等待。 依赖项缺失：manager 与 report 均强依赖 auth 子能力，缺失时脚本 exit 42 并报 DEPENDENCY_MISSING，需确保三项子能力完整安装。 原始说明 集成亚马逊广告授权、SP/SB/SD广告管理及报表一站式工具，支持广告查询、创建修改及完整报告获取。