用途:查询 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,只发送文档化的业务字段,未知字段在联网前拒绝。
使用方式:先确认请求的公开实体、市场、操作、过滤条件与预期成本;按 API 参考校验参数;执行一次 python scripts/tiktok_shop_product_detail.py '<JSON parameters>' --no-cache,例如 {"productInput":"1729937400435937604","region":"US"}。付费失败后未经用户同意不得再探测其他商品、市场、页面或操作。需设置环境变量 NEXSCOPE_API_KEY;凭据缺失或过期可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。
结果处理:研究响应需外层数值 code 等于 0 才可使用数据;非零为平台失败,展示外层 msg,不将其措辞理解为重试指令。HTTP 200 与嵌套业务 code/status 不能替代平台校验。保留完整响应文件,区分 Nexscope 传输封装与内部业务响应,错误时报告 traceId。仅总结返回事实,缺失值保留为 unknown。保留 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据,首次实时响应前具体费用未知;_nexscope.cost 为耗时而非积分。HTTP 401 为 Nexscope 认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在对话或操作 JSON 中粘贴凭据;HTTP 402 为积分不足,停止流程并引导至上述帮助页。每次调用一个明确请求,错误后不得擅自更改实体、市场、日期、操作或页码。输出需遮盖凭据、签名 URL、Cookie 与内部账户标识,并报告 X-Cost-Token、换算后的 Nexscope 积分与 trace ID。
限制:仅限公开数据读取;不得声称实时、ZIP 安装或生产验证,除非 references/testing.md 中存在对应证据。执行实时请求或声称验证级别前需阅读 references/testing.md。资料未提供具体价格、积分单价与响应字段清单。