用途：基于 Crawlora 构建有来源的 TikTok Top Ads 对比，说明哪些创意方向得到观察内容与公开表现信号支持。注意 Top Ads 是高表现竞价广告的抽样集合，并非某广告主的全部投放。
配置与请求：将 CRAWLORA_API_KEY 设为 crawlora.net 提供的密钥。运行本技能目录下的 scripts/crawlora.sh（或用绝对路径），脚本会向 https://api.crawlora.net/api/v1 发送 x-api-key 并输出 JSON。密钥应保留在环境变量中。十个 Top Ads 端点及其准确参数见 reference/endpoints.md。
工作流：从简报中确定品牌/产品关键词、市场、目标、回溯周期与样本量。通过 /tiktok/top-ads/filters 发现当前的行业、目标、语言和国家 ID；地理不清时用 /locations 与 /location-info。检索 /tiktok/top-ads/list 时，竞品间需保持市场、周期、目标一致；period 为 7、30 或 180，limit 最多 100；order_by 支持 for_you、impression、ctr、play_2s_rate、play_6s_rate、cvr、like，须说明排序方式，因为它会改变样本。按 Top Ads material ID 去重，对限定短名单调用 /tiktok/top-ads/detail，使用返回的 material ID 而非 TikTok 视频 ID。推荐与焦点广告可扩大发现，但应标为补充，不可静默混入匹配对比。涉及广告投放期表现时用 /tiktok/top-ads/analysis，指标为 retain_ctr、retain_cvr、click_cnt、convert_cnt、play_retain_cnt，period_type 为 7、30 或 180；比较图表或百分位前须统一指标与周期。环境支持视频/图片查看时检查实际创意；仅能访问元数据时，结论限于标题/文案与返回字段，不得仅凭元数据声称看过钩子或听过音频。总结反复出现的讯息、形式、优惠与行动号召模式并附示例链接；创意测试建议应作为假设，公开图表不能证明转化表现的原因。
脚本示例：scripts/crawlora.sh /tiktok/top-ads/filters；scripts/crawlora.sh /tiktok/top-ads/list
keyword=skincare country_code=US period=30 limit=10 order_by=ctr
输出与解释：返回含 material_id、可用广告主/标题、来源链接、国家、目标、回溯、时长、观察到的讯息/形式、返回表现字段与获取时间的对比。按报告保留指标标签与单位；百分位不是原始 CTR、花费估算或 ROI。关键词结果可能提及某品牌但并非其广告，应尽量核实广告主身份并标记不确定匹配。无匹配表示所查 Top Ads 样本中没有，而非竞品不活跃；应描述筛选条件与覆盖范围，不要宣称涵盖所有广告。保留返回的带签名媒体 URL（可能过期）以及 material ID 和来源页链接以便复现。响应可能含嵌套上游 code/msg/data，须先检查 Crawlora 封装和上游 code 再视为结果；在 pagination.has_more=false 或约定样本上限处停止。遇 429 退避，瞬时 5xx 重试一次；遇 401/403 停止并报告来源限制；仅部分详情/图表加载时保留部分对比并明确标记缺失观察。