用途
Linkfox Etsy 类目检索（linkfox-etsy-category-search）用于查询 Etsy 平台的类目数据。它支持检索类目名称、类目 id 与 parentIds，返回的类目 id 可用于商品或店铺筛选时的类目 id 参数。
触发场景包括：用户提到 Etsy 类目、Etsy category id、Etsy 类目树、Etsy 品类查询、syncEtsyCategory、查询类目等。即使用户未提及工具名，只要是在本地已同步的 Etsy 类目数据范围内进行查询，也可触发。
主要能力
- 关键字检索：通过 keyword 进行子串匹配，匹配范围包括类目名称、类目 id、parentIds（keyword 为必填项）。
- 分页返回：page 从 1 开始；pageSize 默认 50，最大 200。
- 返回的 id 可作为 Etsy 商品搜索或店铺侧 category 等入参的类目标识（以具体工具的 schema 为准）。
使用方式
- 命令行调试（可选）：运行
python scripts/etsy_category_search.py '<JSON>'，需要配置 LINKFOXAGENT_API_KEY。详细说明见 references/api.md 末尾。 - 入参/出参表见 references/api.md。
- 认证与算力问题处理：当出现未配置 API Key（环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY）、响应 401 或 402 状态码、或响应提示算力/余额不足（消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义内容）时，采用 references/onboarding.md 引导解决问题。
- 算力消耗规则：不消耗算力。
适用场景
需要在 Etsy 平台上按类目进行商品搜索或店铺筛选时，先通过该技能获取对应的类目 id，再将其作为 category 参数传入相应工具。
限制
资料未提供支持的类目层级范围、数据更新频率、类目总量、支持的平台区域等细节。使用前需确保 API Key 已正确配置，否则会遇到认证或余额相关异常。