用途:面向 TikTok Shop 公开市场情报研究,覆盖商品搜索与详情、相似商品图片搜索、商品榜单、关联达人/直播/视频/评论等。仅处理公开市场数据,不涉及卖家后台的商品管理、订单、履约、广告账户或内容发布。
主要能力(脚本对应 Nexscope 路由): chuhaijiang_product_detail.py → POST /api/v1/tools/research/chuhaijiang/products/detail chuhaijiang_product_image_search.py → POST /api/v1/tools/research/chuhaijiang/products/image-search chuhaijiang_product_rank_most_promoted.py → POST /api/v1/tools/research/chuhaijiang/products/rankings/most-promoted chuhaijiang_product_rank_new_arrivals.py → POST /api/v1/tools/research/chuhaijiang/products/rankings/new-arrivals chuhaijiang_product_rank_top_selling.py → POST /api/v1/tools/research/chuhaijiang/products/rankings/top-selling chuhaijiang_product_related_creators.py → POST /api/v1/tools/research/chuhaijiang/products/related-creators chuhaijiang_product_related_lives.py → POST /api/v1/tools/research/chuhaijiang/products/related-lives chuhaijiang_product_related_videos.py → POST /api/v1/tools/research/chuhaijiang/products/related-videos chuhaijiang_product_reviews.py → POST /api/v1/tools/research/chuhaijiang/products/reviews chuhaijiang_product_search.py → POST /api/v1/tools/research/chuhaijiang/products/search upload_image.py → POST /api/skill-asset/presign → 预签名 PUT → POST /api/skill-asset/confirm
认证:设置 NEXSCOPE_PROXY_BASE 和 NEXSCOPE_API_KEY,请求头使用 Authorization: Bearer <key>。无需市场账号授权。凭据与上游令牌由后端持有,不应接收、打印或持久化。HTTP 401 为 Nexscope 认证失败,402 为额度不足。该操作消耗积分,需保留响应头中的 X-Cost-Token 与 X-Cost-Credit。
使用方式:先确认具体操作、市场/账号上下文、筛选、日期、分页与输出要求;请求前按 references/api.md 校验必填字段、类型、枚举、范围及各项限制;说明可能消耗更多积分并在付费调用前取得确认;仅运行所选脚本,例如 python scripts/chuhaijiang_product_detail.py '<JSON参数>' --no-cache(当脚本支持该标志时)。将完整响应保存至 nexscope/<date>/<session>/data,返回简要摘要与保存路径。超时或上游失败时不要自动重试,先报告 trace ID 并核对状态。
输出与限制:区分 Nexscope 传输信封与嵌套业务响应;仅报告返回事实,缺失值记为未知,保留提供方指标定义;不得暴露密钥、令牌、预签名 URL 查询串或内部记录;除非用户明确要求,不提交反馈或进行无关外部改动。具体字段取值、限额、积分价格与支持的市场暂未提供。