用途:该技能用于查询 TikTok Shop 公开商品详情,属于公开市场数据的只读查询,不用于卖家后台、店铺授权、收藏写入或账号变更操作。
主要能力:调用接口 POST /api/v1/tools/research/tiktok/shop/product/detail。必填参数 productInput,为 19 位商品 ID 或受支持的 HTTPS TikTok 商品链接;可选参数 region,支持 US、GB、ID、MY、TH、VN、PH、SG、DE、FR、IT、ES。只允许发送文档中列出的字段,未知字段需在发起网络请求前拒绝。
使用方式:先阅读 references/api.md 了解完整参数、响应与错误约定;确认目标实体、市场、操作、筛选条件与预期成本;校验参数后执行 python scripts/tiktok_shop_product_detail.py '<JSON parameters>' --no-cache,每次调用只处理一个明确请求。付费失败后未经用户同意,不得探测其他商品、市场、页面或操作。需设置环境变量 NEXSCOPE_API_KEY;凭据缺失或过期可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。
结果呈现:保留完整响应文件,区分 Nexscope 传输层信封与内部业务响应;仅总结返回的事实,缺失值保留为未知,标明请求的市场与操作;保留原始货币、单位、标识符与日期,不做换算或默认填充;错误时报告 traceId,并保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为计费元数据。
限制:该操作消耗 Nexscope 积分,首次实际响应前无法确定具体费用。HTTP 401 表示认证失败,需检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭据;HTTP 402 表示积分不足,应停止流程并引导用户访问上述帮助页面。市场授权失败需更新对应平台账号或令牌,不得自动替换店铺、地区或创作者。网络故障需说明是读取还是变更操作,变更操作未核对上游状态前不得重试。输出中需隐去凭据、签名链接、Cookie 与内部账号标识。除非 references/testing.md 中有对应证据,不得声称已完成实时、ZIP 安装或生产验证。