SuperAPI AI 工具集

ecommerce.etsy-product-detail

营销与增长

查看项目

更新于 10-16 06:50

技能介绍

用途:该技能用于查询 Etsy 公开商品(listing)详情,属于公开数据、只读操作,不涉及卖家后台、店铺授权、收藏写入或账户变更。

主要能力:通过 Nexscope 研究代理调用接口 POST /api/v1/tools/research/etsy/product/detail,获取指定 Etsy 公开商品的信息。请求前应先阅读 references/api.md 了解完整参数、响应与错误约定。

使用方式:必填参数为 productUrl,即包含数字商品 ID 的 HTTPS Etsy 商品链接;无可选参数。只发送文档中列明的字段,未知字段应在发起网络请求前拒绝。最小示例:{"productUrl":"https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"}。执行命令:python scripts/etsy_product_detail.py '<JSON参数>' --no-cache,每次调用只处理一个明确请求。付费失败后未经用户同意,不得探测其他商品、市场、页面或操作。

认证与费用:需设置环境变量 NEXSCOPE_API_KEY。该操作消耗 Nexscope 积分,首次实际响应前无法确定具体扣费;应保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据。HTTP 401 表示认证失败,应检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在对话或操作 JSON 中粘贴凭据;HTTP 402 表示账户积分不足,应停止流程并引导用户访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。

响应处理:使用数据前要求外层数字 code 等于 0,非零为平台失败,应展示外层 msg,但不得将其措辞理解为重试指令;HTTP 200 或内层业务 code/status 不能替代平台校验。需区分 Nexscope 传输信封与内层业务响应,出错时报告 traceId。保留完整响应文件,保留原始货币、单位、标识、日期与缺失值,不虚构换算或默认值。

限制:仅限公开数据只读查询;出错后不得静默更改实体、市场、日期、操作或页码;输出中应隐去凭据、签名 URL、Cookie 与内部账户标识。未在 references/testing.md 中有对应证据时,不得声称已完成实时、ZIP 安装或生产验证。其他细节暂未提供。