用途：在具备 LinkFox「第三方数据服务」MCP 时调用 _ehunt_etsyCategorySearch（展示名「Etsy品类查询」，以当前环境下发工具元数据为准），从 MCP 库本地检索 EHunt 的 Etsy 类目，获取类目名称、类目 id 与 parentIds，用于商品或店铺筛选所需的类目 id。
前置条件：库内须已有 _ehunt_syncEtsyCategory（展示名「Etsy品类同步」）写入的全量类目；若无数据或结果为空，需先完成同步再检索。
主要能力与参数：必填 keyword，按子串匹配类目名称、类目 id、parentIds；分页 page 从 1 起，pageSize 默认 50、最大 200。返回的 id 可作为 _ehunt_productQuery 或店铺侧 category 等入参的类目标识，具体以相应工具 schema 为准。
使用方式：命令行调试可执行 python scripts/ehunt_etsy_category_search.py '<JSON>'，需 LINKFOXAGENT_API_KEY，详见 references/api.md 末尾；入参出参表见 references/api.md。响应较大时，建议持久化到磁盘再抽取所需字段，例如 python scripts/response_io.py run --script scripts/ehunt_etsy_category_search.py --out-dir <DIR> '<params>'，再用 python scripts/response_io.py read <file> --fields "<paths>" 或 --path "<JMESPath>" 读取；read 支持 --limit/--offset 与 --format json|jsonl|csv|table。
适用场景：字段多、含不需要字段、批量分页、长文本字段或结果需跨步骤复用的响应；小规模一次性响应可直接调用主脚本。
限制与注意事项：run 仅输出 schema 预览与文件路径，预览为截断的 schema 与样本，字段级判断须从持久化文件用 read 读取。输出目录应选在 git 工作树之外（如 Unix 的 /tmp/...、Windows 的 %TEMP%/...），文件不会自动删除，任务完成需自行清理；持久化响应可能含 PII、价格或鉴权敏感数据，不要提交到仓库。