用途：通过 LinkFox 代理调用 Shopee Open Platform 的 Ads 模块（23 个 API，不含即将下线的 auto product ads），用于 Shopee 店铺站内广告的查询与管理。
主要能力：账户与推荐（get_total_balance、get_shop_toggle_info、get_recommended_keyword_list、get_recommended_item_list）；CPC 效果（get_all_cpc_ads_daily_performance、get_all_cpc_ads_hourly_performance）；手动商品广告（create_manual_product_ads、edit_manual_product_ads、edit_manual_product_ad_keywords、get_product_level_campaign_id_list 等）；GMS 系列（create_gms_product_campaign、get_gms_campaign_performance 等）；通用入口 ads_api.py（JSON 含 api 字段）。
使用方式：先运行 python scripts/check_auth_dependency.py，exit code 42 表示需先安装 linkfox-shopee-store-auth；再用 auth 的 authorized_stores.py 确认目标店存在 appType=ad，缺失则用 authorize_url.py 传 appType=ad 引导授权。业务调用走 POST /shopee/developerProxy，传 shopId（或 merchantId）+ api/v2/ads/... 路径，服务端自动注入 AD Token，禁止传 accessToken 或 appType。脚本形式为 python scripts/<脚本名>.py '<JSON 参数>' [--inline]。
输出与限制：完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下 JSON 文件，≤8 KB 全量打印，>8 KB 只输出摘要，--inline 强制全量；建议用 jq 按需抽取。本工具会消耗算力，失败或空结果不得自动换关键词、翻页或连续试探。Ads API 还需 Shopee 侧开通广告能力，并非所有站点/店铺可用。店铺授权、商品 listing、联盟营销 AMS、Amazon 广告均属其他技能。
算力消耗规则：不消耗算力。