用途:查询 Etsy 商品列表,通过多维筛选条件定位目标商品。
主要能力:支持关键词或 URL 检索;按价格、销量、收藏数、评价、上架日期、类目等条件过滤;可按 1~6 的 sortBy 排序,sortDesc 取 1 表示降序、2 表示升序;productType 支持 1 手工、2 复古、3 数字、4 定制、9 其他,多选时用逗号分隔;currencyCode 默认 USD;category 为单个类目 ID,需先用类目搜索技能获取。
使用方式:分页 page 从 1 开始,pageSize 默认 20、最大 100,建议不超过 50;范围参数采用 begin*/end* 成对写法。可选命令行调试:python scripts/etsy_product_query.py '<JSON>',需设置 NEXSCOPE_API_KEY。输入输出参数表见 references/api.md。
认证与计费:需设置 NEXSCOPE_API_KEY 环境变量;若出现 401/402 或余额不足,可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。计费为动态定价,消耗积分等于返回商品数乘以 1.8,按返回结果页计费,翻页视为新请求并再次计费。
限制:单次调用可能消耗较多积分,使用前应提示用户并由其决定是否继续。其余未在资料中说明的功能、平台或价格信息暂未提供。