用途:这是一个面向 TikTok 广告与创意素材的公开情报调研技能,通过出海匠(Chuhaijiang)与 Nexscope 获取公开市场数据。
主要能力包括五类操作:广告搜索(ads/search)、广告详情(ads/detail)、广告相关商品(ads/related-products)、创意搜索(creatives/search)、创意详情(creatives/detail),并涉及分镜分析与向量元数据。对应脚本为 chuhaijiang_ad_search.py、chuhaijiang_ad_detail.py、chuhaijiang_ad_related_products.py、chuhaijiang_creative_search.py、chuhaijiang_creative_detail.py,分别映射到相应的 Nexscope 研究路由。请求与响应的权威契约需查阅 references/api.md。
使用方式:先设置环境变量 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY,密钥以 Authorization: Bearer <key> 方式发送。无需授权市场账号,仅读取公开市场数据。调用前需针对 api.md 校验必填字段、类型、枚举、范围与各操作限制;运行单个入口脚本,例如:python scripts/chuhaijiang_ad_detail.py '<JSON parameters>' --no-cache。响应完整保存在 nexscope/<date>/<session>/data,返回简要摘要与保存路径。
限制与安全:仅限公开创意情报,不授权广告账号、不创建广告计划、不花费预算、不发布内容。该操作会消耗积分,需保留响应头 X-Cost-Token 与 X-Cost-Credit 作为计费元数据。HTTP 401 视为 Nexscope 认证失败,HTTP 402 视为积分不足。出现超时或上游故障时不要自动重试,先报告 trace ID 并核对状态。禁止暴露 API 密钥、供应商令牌、预签名 URL 查询串、内部账号记录或原始密钥。追加分页、市场或操作可能消耗更多积分,需事先获得批准。收费、价格等具体标准资料未提供,访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 可充值积分。