用途：在具备 LinkFox「第三方数据服务」MCP 的环境下，按工具名 _ehunt_storeQuery 调用（MCP 展示名：Etsy店铺查询，以当前环境下发的工具元数据为准），用于按多维度筛选 Etsy 店铺，例如销量、收藏、评论、开店时间、国家、主营类目、Raving/星标等，适用于 Etsy 店搜、Etsy seller、Etsy 店铺排行等场景。鉴权与上游路由由网关处理。
主要能力与用法：分页参数 page 从 1 起，pageSize 默认 20、最大 100。区间入参 begin* / end* 成对对应上游逗号范围，只填一侧时上游为「起始~」或「~结束」。排序 sortBy 仅支持 8~11（8 总销量、9 周销量、10 评论数、11 收藏数）；sortDesc 中 1=降序、0=升序，勿与商品接口的 sortDesc 混用。若响应含根级 code 字段，是否成功以实网为准。
调试与参考：可用命令行脚本调试 python scripts/ehunt_etsy_store_query.py '<JSON>'（需 LINKFOXAGENT_API_KEY）；入参/出参表见 references/api.md。
大数据量响应处理：为避免占满智能体上下文，可将响应持久化到磁盘后按需提取字段，命令为 python scripts/response_io.py run --script scripts/ehunt_etsy_store_query.py --out-dir <DIR> '<params>' 与 python scripts/response_io.py read <file> --fields "<paths>"（或 --path "<JMESPath>"）。run 会写入完整响应并仅输出 schema 预览与文件路径；read 支持 --limit/--offset 切片及 --format json|jsonl|csv|table。建议将 --out-dir 设在任何 git 工作树之外（如 Unix 的 /tmp/...、Windows 的 %TEMP%/...）。持久化响应可能含 PII、价格或鉴权敏感数据，请勿提交；文件不会自动删除，任务完成后应清理。字段多、批量/分页结果、长文本字段或需跨步骤复用的响应优先用该模式；小型单次响应可直接调用主脚本。注意预览只是截断的 schema 与样例，字段级判断须从持久化文件读取。具体返回字段、配额与限制资料暂未提供。