用途:查询 Etsy 公开商品(listing)详情,仅面向公开市场数据的只读场景,不涉及卖家后台、店铺授权或账户写入操作。
主要能力与请求契约:接口为 POST /api/v1/tools/research/etsy/product/detail。必填字段 productUrl,须为含数字 listing ID 的 HTTPS Etsy 链接;无可选字段,仅可发送文档化字段,未知字段应在发起网络请求前拒绝。示例:{"productUrl":"https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"}。
使用方式:构造请求前先阅读 references/api.md;执行时运行 python scripts/etsy_product_detail.py '<JSON 参数>' --no-cache 一次。付费失败后未经用户同意,不要试探其他商品、市场、页面或操作。调用需设置 NEXSCOPE_API_KEY 环境变量。
结果呈现:先给出所请求的实体、市场与操作及最具决策价值的返回字段;保留原始货币、单位、标识符、日期,缺失值标为未知,不得自行换算或补默认值。保留完整响应文件,区分传输外层与业务响应,出错时报告 traceId,并报告响应头中的 X-Cost-Token 与 X-Cost-Credit。
错误与额度:HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE;HTTP 402 表示额度不足,应停止流程并引导用户访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。平台授权失败需续期对应账户或令牌,不得自动替换店铺、区域或创建者。网络失败需说明该操作是读取还是变更,未对账上游状态前不得重试变更操作。费用按 Nexscope credits 计,首次实际响应前确切收费未知。
限制:每次调用只处理一个明确请求,出错后不得静默更改实体、市场、日期、操作或分页;对外输出与保存的请求示例需抹去凭证、签名 URL、Cookie 与内部账户标识。完整参数、响应与错误契约见 references/api.md,执行实时请求或声明验证级别前参见 references/testing.md。