mcpField
L
linkfox-ehunt-etsy-store-query

linkfox-ehunt-etsy-store-query

github.com/linkfox-ai营销与增长113130 次安装2 周前更新
代码仓库

关于 linkfox-ehunt-etsy-store-query

用于查询 Etsy 店铺数据的技能,通过 LinkFox 第三方数据服务 MCP 调用店铺查询工具。支持分页、区间筛选和按销量、评论或收藏数排序。

主要功能

  1. 01分页查询店铺
  2. 02支持起止范围筛选
  3. 03按销量、评论或收藏数排序
  4. 04支持升序和降序

适用场景

  1. 01筛选符合条件的 Etsy 店铺
  2. 02比较店铺总销量与周销量
  3. 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.md
scripts/
ehunt_etsy_store_query.py
response_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 从已保存的文件中读取。

评论

支持 Markdown