用途:查询 Etsy 店铺并按多个维度筛选,适合做店铺调研、竞品筛选和批量数据获取。
主要能力:支持按销量、收藏数、评价数、开店时间、国家、主营类目以及 Raving/Star 评级进行过滤查询。
分页规则:page 从 1 开始;pageSize 默认 20,最大 100。
范围参数:begin*/end* 成对使用,对应上游以逗号分隔的区间;只填一侧时,上游按“start~”或“~end”处理。
排序:sortBy 仅支持 8~11(8 总销量、9 周销量、10 评价数、11 收藏数);sortDesc 1 为降序、0 为升序,注意不要与商品的查询接口 sortDesc 混淆。
使用方式:可选用命令行调试,运行 python scripts/etsy_store_query.py '<JSON>'(需要 NEXSCOPE_API_KEY)。输入输出参数表见 references/api.md。
认证:设置 NEXSCOPE_API_KEY 环境变量;凭证缺失或过期时,访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值额度。
计费:动态计价,消耗额度 = 返回店铺数 × 1.8,按返回结果页计费;获取下一页相当于新请求,会按新页结果数再次计费。该技能成本动态变化,单次调用可能消耗较多额度,使用前应向用户提示并由用户决定是否继续。
限制:只支持上述 range、sortBy 数值与分页范围;其余参数含义暂未提供。