mcpField
L
linkfox-ehunt-shopify-store-query

linkfox-ehunt-shopify-store-query

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

关于 linkfox-ehunt-shopify-store-query

linkfox-ehunt-shopify-store-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/storeQuery` 路由。网关负责鉴权和上游路由。

安装

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

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

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

包含的文件

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

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

详细介绍

EHunt Shopify 店铺查询（ehunt/shopify/storeQuery）

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

要点

  • 分页：page 从 1 起；pageSize 默认 20，最大 100。
  • 区间入参：*Min / *Max 成对出现（产品数、广告数、月访问量、月订单量），组成上游区间。
  • 店铺年限 year：1=最近 1 年、2=12 年、3=23 年、4=3 年以上。
  • 排序：sortBy 为整数枚举（0=产品数，1=类目数，2=月访问量，3=FB 粉丝，4=Ins 粉丝，5=广告数，6=相关度，7=月订单数，默认）；orderBy 为 desc（默认）/asc。
  • 国家：country 传入国家代码（如 US、CN）。

脚本（可选）

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

参考

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

处理大型响应

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

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