mcpField
L
linkfox-ehunt-etsy-product-query

linkfox-ehunt-etsy-product-query

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

关于 linkfox-ehunt-etsy-product-query

供使用 LinkFox「第三方数据服务」MCP 的 Etsy 市场调研者查询商品数据的技能，调用 `_ehunt_productQuery`。支持分页、筛选和排序，并可将大型响应保存到文件后提取所需字段。

主要功能

  1. 01按商品类型与类目查询
  2. 02支持分页和区间参数
  3. 03按字段及方向排序
  4. 04大型响应保存并筛选读取

适用场景

  1. 01按商品类型筛选 Etsy 商品
  2. 02分页获取商品查询结果
  3. 03将大型结果保存后提取字段

MCP 相关

通过 LinkFox「第三方数据服务」MCP 调用 `_ehunt_productQuery`，向 MCP 客户端提供 Etsy 商品查询。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-ehunt-etsy-product-query

安装后在 Claude Code 中输入/linkfox-ehunt-etsy-product-query确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
scripts/
ehunt_etsy_product_query.py
response_io.py

详细介绍

EHunt Etsy 商品查询（_ehunt_productQuery）

在具备 LinkFox「第三方数据服务」MCP 时，按工具名 _ehunt_productQuery 调用（MCP 展示名：Etsy商品查询，以当前环境下发的工具元数据为准）。鉴权与上游路由由网关处理；若响应含根级 code 字段，是否成功以实网为准。

要点

  • 分页：page 从 1 起；pageSize 默认 20、最大 100（建议 ≤50）。
  • 区间入参：与店铺接口相同思路，begin* / end* 成对。
  • 排序：sortBy 为 1~6（EHunt 上游 sort_by）。sortDesc：1=降序，2=升序（与 _ehunt_storeQuery 的 1/0 不同）。
  • 商品类型 productType：1 手工、2 复古、3 数字、4 定制、9 其他，多选用逗号。
  • 货币：currencyCode 默认 USD。
  • 类目 ID：category 为单品类 ID；可先通过类目检索类技能拿到 ID。

脚本（可选）

命令行调试：python scripts/ehunt_etsy_product_query.py '<JSON>'（需 LINKFOXAGENT_API_KEY）。详见 references/api.md 末尾。

参考

入参/出参表见 references/api.md。

处理大型响应

为避免占满 Agent 上下文，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/ehunt_etsy_product_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