用途:通过出海匠与 Nexscope 研究公开的 TikTok 商业直播数据,属于公开市场情报工具,不控制直播,也不接入卖家运营后台。
主要能力:提供三类操作。chuhaijiang_live_search.py 对应 POST /api/v1/tools/research/chuhaijiang/lives/search,用于直播搜索;chuhaijiang_live_detail.py 对应 POST /api/v1/tools/research/chuhaijiang/lives/detail,用于直播详情;chuhaijiang_live_related_products.py 对应 POST /api/v1/tools/research/chuhaijiang/lives/related-products,用于相关商品下钻。指标包括 GMV、GPM、OPM、观众与销售数据。
使用方式:设置环境变量 NEXSCOPE_PROXY_BASE 和 NEXSCOPE_API_KEY,请求时以 Authorization: Bearer <key> 发送 Nexscope 密钥。无需市场平台账号授权。请求与响应契约以 references/api.md 为准,运行前需校验必填字段、类型、枚举、范围及操作特定限制。每次只运行选定的入口脚本,例如 python scripts/chuhaijiang_live_detail.py '<JSON parameters>' --no-cache(脚本支持该参数时)。完整响应保存至 nexscope/<date>/<session>/data,并返回简要摘要与保存路径。
限制与安全:HTTP 401 表示 Nexscope 认证失败,HTTP 402 表示 Nexscope 额度不足;该操作消耗积分,需保留响应头 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据。出现超时或上游失败时不要自动重试,先报告 trace ID 并核对状态。禁止暴露 API 密钥、供应商令牌、预签名 URL 查询串或内部账户记录。授权失败或网络结果不明确时,不得替换其他账户、市场、地区、创作者、商品或操作。更多页面、市场或操作可能消耗更多积分,付费调用前需获得确认。