用途:按多维度筛选 Etsy 商品(listing),可用于 Etsy 选品、找爆款、按关键词或 URL 定位商品等场景。
主要能力与参数: 分页:page 从 1 起;pageSize 默认 20、最大 100(建议 ≤50)。 区间入参:begin* / end* 成对使用。 排序:sortBy 为 1~6(上游 sort_by)。sortDesc:1=降序,2=升序(与 _ehunt_storeQuery 的 1/0 不同)。 商品类型 productType:1 手工、2 复古、3 数字、4 定制、9 其他,多选用逗号。 货币:currencyCode 默认 USD。 类目:category 为单品类 ID,可先通过类目检索类技能拿到 id。
使用方式:命令行调试可运行 python scripts/etsy_product_query.py '<JSON>'(需 LINKFOXAGENT_API_KEY),详见 references/api.md。入参/出参表见 references/api.md。
认证与算力:未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY,或响应 401/402、提示算力余额不足/计费不足/套餐到期等,按 references/onboarding.md 引导处理。计费按动态规则:消耗算力 = 返回的商品数 × 1.8,按本页返回条数计费,翻页等于再发一次请求并重新计算。该服务按倍数动态计算,可能一次性消耗大量算力,需提醒用户并由用户决定是否继续。
限制:官方未提供更多功能、收费价格与平台细节,暂未提供。