用途：调研 TikTok 公开广告与创意素材，发现广告、查看单条详情、把广告关联到推广商品，或拆解创意的内容结构。属于公开市场情报，不是用户私有 TikTok 广告账户或投放后台数据。
主要能力（5 个端点）：广告搜索 /chuhaijiang/ad-creative/ads/search、广告详情 /chuhaijiang/ad-creative/ads/detail、广告关联商品 /chuhaijiang/ad-creative/ads/related-products、创意搜索 /chuhaijiang/ad-creative/creatives/search、创意详情 /chuhaijiang/ad-creative/creatives/detail。搜索与关联商品每页最多 10 条；广告详情可用 include=core 取效果指标，创意详情可用 include=analysis、include=embedding 或二者逗号组合。金额类指标常为 {unit,value} 对象，计算前需检查运行时类型。
使用方式：所有端点均 POST，参数用 references/api.md 中的 camelCase 字段；必须先读 references/api.md。country 为必填小写市场码：br,de,es,fr,gb,id,it,jp,mx,my,ph,sg,th,us,vn。脚本调用：python scripts/<entry>.py '<JSON 参数>' [--inline]。搜索先于详情：详情需用广告搜索返回的顶层 item id，创意详情用创意搜索返回的 id，不要用 video_id、product_id 或 advertiser_id 替代。示例：python scripts/chuhaijiang_ad_search.py '{"country":"us","keyword":"beauty","page":1,"pageSize":3}'。输出默认落盘到 <cwd>/linkfox/<日期>/<session>/data/，≤8KB 全量打印，>8KB 只打摘要，可用 jq 按需抽取；--inline 强制全量打印，--no-cache 强制真实请求。
计费：按端点独立计费，广告/创意详情 9 算力/次，广告搜索、关联商品、创意搜索 18 算力/次；成功响应缓存 24 小时，失败不缓存。高频或多端点钻取前应说明预计调用次数与消耗。
限制：不能创建、编辑、启动、暂停或优化广告活动，不能改预算或出价；不含私有花费、归因、受众、像素或账户数据；adType 与 category 为上游分类，不可臆造枚举值；结果与指标随时间变化；embedding 仅用于明确的下游相似度或机器学习需求。认证或算力问题按 references/onboarding.md 处理（如密钥未配置、401/402、余额或套餐提示）。