关于 linkfox-ehunt-etsy-store-query
用于查询 Etsy 店铺数据的技能,通过 LinkFox 第三方数据服务 MCP 调用店铺查询工具。支持分页、区间筛选和按销量、评论或收藏数排序。
主要功能
- 01分页查询店铺
- 02支持起止范围筛选
- 03按销量、评论或收藏数排序
- 04支持升序和降序
适用场景
- 01筛选符合条件的 Etsy 店铺
- 02比较店铺总销量与周销量
- 03按评论数或收藏数排列店铺
MCP 相关
通过 LinkFox 第三方数据服务 MCP 调用 `_ehunt_storeQuery` 查询 Etsy 店铺。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ linkfox-ai/ linkfox-skills --skill linkfox-ehunt-etsy-store-query安装后在 Claude Code 中输入/linkfox-ehunt-etsy-store-query确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/api.mdscripts/ehunt_etsy_store_query.pyresponse_io.py详细介绍
EHunt Etsy 店铺查询(_ehunt_storeQuery)
在具备 LinkFox「第三方数据服务」MCP 时,按工具名 _ehunt_storeQuery 调用(MCP 展示名:Etsy 店铺查询,以当前环境下发的工具元数据为准)。鉴权与上游路由由网关处理;若响应含根级 code 字段,是否成功以实网为准。
要点
- 分页:
page从 1 起;pageSize默认为 20,最大为 100。 - 区间入参:
begin*/end*成对对应上游逗号范围;只填一侧时,上游为「起始~」或「~结束」。 - 排序:
sortBy仅支持 8~11(8 总销量、9 周销量、10 评论数、11 收藏数)。sortDesc:1=降序,0=升序(勿与商品接口的sortDesc混用)。
脚本(可选)
命令行调试:python scripts/ehunt_etsy_store_query.py '<JSON>'(需 LINKFOXAGENT_API_KEY)。详见 references/api.md 末尾。
参考
入参/出参表见 references/api.md。
处理大型响应
为避免撑满 Agent 上下文,请将响应保存到磁盘,并仅提取所需字段:
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>" # or --path "<JMESPath>"
将
--out-dir设在任何 git 工作树之外(例如,Unix 上的/tmp/...,Windows 上的%TEMP%/...)。保存的响应可能包含个人身份信息、价格或敏感认证数据——请勿提交。文件不会自动删除;任务完成后请清理。
run 会将完整响应写入文件,并仅输出架构预览和文件路径。read 可筛选特定字段,并支持使用 --limit/--offset 切片,以及使用 --format json|jsonl|csv|table 指定输出格式。
适合采用此模式的情形——请根据响应特征自行判断,例如:
- 每条记录字段很多,或包含不需要的字段
- 批量/分页结果(单次调用返回多个项目)
- 长文本字段(描述、评论、HTML、时间序列)
- 输出会在后续步骤中重复使用,而非立即消费
对于小型、仅使用一次的响应,直接调用主脚本即可。
⚠️ 预览内容是经过截断的架构与样例,并非完整数据。任何字段级决策都必须通过 read 从已保存的文件中读取。