（14706期）Shopee-店铺广告 – Shopee 广告智能投放管家

Shopee 广告智能投放管家 LinkFox 官方推出的 Shopee 站内广告管理工具，覆盖23个 Ads 模块 API，支持余额查询、手动广告创建、CPC 效果追踪与 GMS 推广，助力跨境卖家精准投放、提升 ROI。 使用说明 核心用法 本 Skill 是 LinkFox 官方针对 Shopee（虾皮）电商平台推出的站内广告管理工具，通过 POST /shopee/developerProxy 转发调用 Shopee Open Platform 的 Ads 模块 23 个核心接口。使用前必须确保目标店铺已完成 appType=ad 的广告授权（ERP 授权不可替代），服务端会自动注入 AD Token，用户无需手动处理 accessToken。支持 Python 脚本直调与通用 API 入口两种模式，所有响应默认落盘至项目目录的 linkfox/ 子文件夹，大响应体自动摘要输出以节省上下文。 主要功能覆盖四大场景：账户管理（余额查询、店铺开关状态）、智能推荐（关键词/商品推荐、预算建议、ROI 目标）、手动商品广告（创建、编辑、关键词优化）、效果报表（CPC 日/小时级数据、Campaign 维度追踪）以及 GMS 推广（创建活动、编辑商品、性能追踪）。所有 create/edit 操作建议传入唯一 reference_id 防重，复杂 POST 接口通过 body 字段封装参数。 显著优点 官方背书与生态整合：作为 LinkFox 官方技能，与 linkfox-shopee-store-auth 深度联动，授权链路清晰，避免 Token 泄露风险；全链路覆盖：从预算建议、广告创建到效果追踪形成完整投放闭环，无需多工具切换；数据安全设计：强制落盘 + 智能摘要机制，防止大 JSON 污染对话上下文，同时保留完整数据供 jq 等工具二次提取；零积分成本：该 Skill 不消耗用户积分，降低试错成本；防呆设计：内置授权前置检查（exit code 42 自动引导）、重复请求防护、清晰的错误码映射文档。 潜在缺点与局限性 授权门槛较高：必须单独完成 appType=ad 授权，且部分站点/店铺可能因 Shopee 侧限制无法开通广告能力，易因授权类型混淆导致调用失败；功能边界明确：不包含即将下线的自动广告（auto product ads）及联盟营销 AMS（module=127），需切换至其他 Skill；技术依赖前置：需先安装 auth 依赖项，对纯业务用户有一定技术门槛；平台锁定：仅支持 Shopee 平台，无法迁移至 Amazon 等其他电商平台；数据时效性：效果报表依赖 Shopee 官方数据回流，可能存在 T+1 延迟。 适合的目标群体 Shopee 跨境卖家：需批量管理多店铺广告投放的运营团队；电商代运营（TP）：为多个品牌客户执行广告投放策略的代理商；数据分析师：需定期拉取 CPC、GMS 效果数据进行 ROI 复盘；中小卖家新手：依赖系统推荐关键词/商品及预算建议，降低投放门槛。不适合无 Shopee 店铺、仅需社媒广告投放，或需要 Amazon/速卖通等多平台统一管理的用户。 使用风险 授权失效风险：AD Token 可能过期或店铺权限变更，需定期通过 authorized_stores.py 复核；数据一致性风险：Shopee 官方 API 限流或故障时，代理层可能返回延迟数据；误操作风险：edit 类接口直接影响线上广告花费，建议先在测试店铺验证参数；路径拼写风险：API 路径须严格使用 api/v2/ads/... 格式，错误路径会导致路由失败；存储权限风险：执行目录需可写权限，否则落盘失败报错，禁止写入 /tmp 等临时目录。 原始说明 Shopee（虾皮）店铺站内广告 Ads（与 linkfox-shopee-store-auth 同系列），经 /shopee/developerProxy 转发 Shopee Open API Ads 模块 23 个接口：get_total_balance、create_manual_product_ads、get_product_campaign_daily_performance、GMS 广告等。调用前须确认目标店已有 appType=ad 授权（ERP 授权不能代替）。当用户提到 Shopee 广告、Ads、广告余额、CPC、商品推广、手动广告、campaign、广告效果、ROI、get_total_balance、广告授权 时触发。即使未明确提及"广告"，只要涉及已授权 Shopee 店铺的广告账户、推广或效果查询，也应触发。