用途：在具备 LinkFox「第三方数据服务」MCP 时，通过网关路由 ehunt/shopify/storeQuery 查询并筛选 Shopify 独立站店铺（MCP 展示名：Shopify 店铺查询，确切工具名以当前环境下发的工具元数据为准）。鉴权与上游路由由网关处理；若响应含根级 code 字段，是否成功以实网为准。
主要能力：支持按店名/域名、国家、创建年限、产品数、广告数、月访问量、月订单量、社媒粉丝等维度筛选。分页 page 从 1 起，pageSize 默认 20、最大 100。区间入参 *Min / *Max 成对出现（产品数、广告数、月访问量、月订单量）。店铺年限 year：1=最近 1 年、2=1至2 年、3=2至3 年、4=3 年以上。排序 sortBy 为整数枚举（0=产品数,1=类目数,2=月访问量,3=FB 粉丝,4=Ins 粉丝,5=广告数,6=相关度,7=月订单数默认）；orderBy 为 desc（默认）/asc。国家 country 传国家代码（如 US、CN）。
使用方式：命令行调试可运行 python scripts/ehunt_shopify_store_query.py '<JSON>'（需 LINKFOXAGENT_API_KEY），详见 references/api.md 末尾；入参/出参表见 references/api.md。
大响应处理：为避免溢出上下文，可将响应持久化到磁盘后只提取所需字段：python scripts/response_io.py run --script scripts/ehunt_shopify_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。字段多、批量分页、长文本字段或结果需跨步骤复用时优先采用该模式；小型一次性响应可直接调用主脚本。注意预览是截断的 schema 与样本，字段级判断须通过 read 读取持久化文件。
限制：--out-dir 应选在 git 工作树之外（如 Unix 的 /tmp/...、Windows 的 %TEMP%/...）；持久化响应可能含 PII、定价或鉴权敏感数据，请勿提交；文件不会自动删除，任务完成后需清理。