用途:在 Temu 公开市场按图片检索外观相似的商品,返回商品、价格、销量、评价、库存、供货价、店铺和类目等字段。仅适用于 Temu 公开市场,不识别其他平台商品,也不修改卖家数据。
主要能力:提供两个脚本。geekbi_temu_goods_image_search.py 对应 POST /api/v1/tools/research/geekbi/temu/goodsImageSearch;upload_image.py 走 POST /api/v1/tools/research/oss/file/presignedPut,再执行签名 PUT,并移除 URL 查询参数。请求与响应契约以 references/api.md 为准。
使用方式:设置环境变量 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY,请求头使用 Authorization: Bearer <key>。无需授权市场账号,读取的是公开市场数据。示例:python scripts/geekbi_temu_goods_image_search.py '<JSON parameters>' --no-cache(脚本支持该参数时)。调用前需按 references/api.md 校验必填字段、类型、枚举、范围与操作限制。
响应处理:研究类 HTTP 响应须外层 code 为数值 0 才可使用 data;非 0 为平台失败,展示外层 msg,但不要将其措辞理解为重试指令。HTTP 200 本身以及嵌套业务 code/status 不能替代平台校验。解包脚本会把平台 code 与 msg 放在 _nexscope 下,其余字段为业务载荷;_nexscope.cost 是耗时而非积分。
限制与安全:该操作消耗积分,请保留响应头 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 充值。旧版本地缓存若仍有效可继续使用,其元数据标记为 _nexscope.responseContract = "legacy-cache",code 与 msg 为 null,不能据此推断平台成功。