用途:按多维度筛选并查询 Etsy 店铺,覆盖销量、收藏、评论、开店时间、国家、主营类目、Raving/星标等条件,可用于 Etsy 店铺搜索、卖家筛选与店铺排行分析。当用户提到 Etsy 店铺、Etsy 店搜、Etsy seller、Etsy 店铺排行、Etsy 周销量店铺、etsy stores、Etsy店铺查询 时触发,即使未提及工具名,只要场景涉及 Etsy 店铺查询也可用。
主要能力:支持分页查询,page 从 1 起,pageSize 默认 20、最大 100;支持区间入参,begin*/end* 成对对应上游逗号范围,只填一侧时上游为「起始~」或「~结束」;支持排序,sortBy 仅 8~11(8 总销量、9 周销量、10 评论数、11 收藏数),sortDesc 1=降序、0=升序,注意勿与商品接口的 sortDesc 混用。
使用方式:可选命令行调试,python scripts/etsy_store_query.py '<JSON>',需配置 LINKFOXAGENT_API_KEY。入参/出参表见 references/api.md;出现认证或算力异常时按 references/onboarding.md 处理。
认证与计费:未配置 API Key(环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 均未设置)、响应 401 或 402、或提示算力/余额不足(如算力余额不足、计费不足、余额不足、quota exceeded、insufficient balance、套餐到期、需充值等)时,按 onboarding 文档引导解决。算力按动态规则计费:消耗算力 = 返回的店铺数 × 1.8,按本页返回条数计费;翻页即再发一次请求,按下一页返回条数重新计算。该技能按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。
限制:sortBy 仅支持 8~11,pageSize 上限 100;其余功能边界与数据字段以 references/api.md 为准,资料未提供更多细节。