关于 linkfox-ehunt-etsy-category-search
用于从 LinkFox 第三方数据服务的本地 MCP 库中检索 Etsy 类目的技能。需要先同步完整类目数据，结果中的类目 ID 可供商品或店铺查询使用。
主要功能
- 01按名称、ID 或父级 ID 匹配
- 02支持分页查询
- 03返回可用于后续查询的类目 ID
适用场景
- 01查找 Etsy 类目及其 ID
- 02为商品查询准备类目标识
- 03在同步后检索本地类目库
MCP 相关
通过 LinkFox 第三方数据服务 MCP 调用 `_ehunt_etsyCategorySearch`，检索此前由 `_ehunt_syncEtsyCategory` 写入的类目数据。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/linkfox-ehunt-etsy-category-search确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/api.mdscripts/ehunt_etsy_category_search.pyresponse_io.py详细介绍
EHunt Etsy 类目检索（_ehunt_etsyCategorySearch）
在具备 LinkFox「第三方数据服务」MCP 时，按工具名 _ehunt_etsyCategorySearch 调用（MCP 展示名：Etsy品类查询，以当前环境下发的工具元数据为准）。数据来自 MCP 库本地检索。
前置条件
库内须已有 _ehunt_syncEtsyCategory 写入的全量类目（MCP 展示名：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。
处理大型响应
为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：
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>" # or --path "<JMESPath>"
请将
--out-dir指定到任何 Git 工作树之外的位置（例如，Unix 系统上的/tmp/...、Windows 系统上的%TEMP%/...）。保存的响应可能包含个人身份信息、定价或敏感认证数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。
run 会将完整响应写入文件，并仅输出 schema 预览和文件路径。read 可提取特定字段，并通过 --limit/--offset 切片，通过 --format json|jsonl|csv|table 指定输出格式。
适合采用此模式的情况——请根据响应特征自行判断，例如：
- 每条记录的字段较多，或包含不需要的字段
- 批量/分页结果（一次调用返回多个条目）
- 长文本字段（描述、评价、HTML、时间序列）
- 响应会在后续步骤中重复使用，而不是立即处理
对于较小且只使用一次的响应，直接调用主脚本即可。
⚠️ 预览内容是经过截断的 schema 和样例，并非完整数据。任何字段级判断都必须通过 read 从已保存的文件中读取。