SuperAPI AI 工具集

ecommerce-etsy-product-query

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:查询 Etsy 商品(技能名 _ehunt_productQuery),通过多维度筛选与排序获取商品结果,适合选品调研、竞品与市场分析等电商场景。

主要能力:支持关键词或 URL 查询;价格、销量、收藏、评价、上架时间等范围筛选(采用 begin*/end* 成对参数);按类目筛选;按商品类型筛选(productType:1 手工、2 复古、3 数字、4 定制、9 其他,可用逗号多选);排序 sortBy 为 1~6,sortDesc 1=降序、2=升序;货币 currencyCode 默认 USD。

使用方式:分页参数 page 从 1 开始,pageSize 默认 20、最大 100,建议不超过 50;category 为单个类目 ID,需先用类目搜索技能找到对应 ID。可选命令行调试: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,按返回结果页计费,翻页相当于新请求并再次计费。注意单次调用可能消耗较多积分,使用前应提醒用户并由其决定是否继续。

限制:category 仅支持单个类目 ID;单页最多 100 条;费用随结果数量增长;未提供信息处暂未说明。