mcpField
L
linkfox-ehunt-shopify-product-query

linkfox-ehunt-shopify-product-query

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

关于 linkfox-ehunt-shopify-product-query

linkfox-ehunt-shopify-product-query 是一项通过 LinkFox 第三方数据服务查询 Shopify 商品数据的技能。它说明筛选、排序、分页，以及保存和查看大型响应的方法。

主要功能

  1. 01通过网关路由查询 Shopify 商品
  2. 02支持分页和区间筛选
  3. 03按广告、货源和下架状态筛选
  4. 04按销量、价格、广告等指标排序
  5. 05保存大型响应并选择性读取

适用场景

  1. 01查找符合价格或销量区间的商品
  2. 02按广告情况或货源状态筛选商品
  3. 03从大型查询结果中提取指定字段

MCP 相关

它通过 LinkFox 第三方数据服务 MCP 调用 `ehunt/shopify/productQuery` 路由。网关负责鉴权和上游路由。

安装

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

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

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

包含的文件

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

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

详细介绍

EHunt Shopify 商品查询（ehunt/shopify/productQuery）

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

要点

  • 分页：page 从 1 起；pageSize 默认 20、最大 100（建议 ≤50）。
  • 区间入参：*Min / *Max 成对出现，组成上游区间；只填一侧时上游为「起始~」或「~结束」。
  • 排序：sortBy 为整数枚举（默认 14=周销量降序，另含价格/广告数/竞争度/销售额等多种取值，详见 references/api.md）。
  • 布尔类筛选：facebookAd（1=有广告）、hasSupplier（1=有货源，0=无）、showDeleted（1=含已下架）均为整数开关。
  • 发货国家：country 传两位国家代码（如 US）。

脚本（可选）

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

参考

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

处理大型响应

为避免 Agent 上下文溢出，请将响应持久化到磁盘，并仅提取所需字段：

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