mcpField
L
linkfox-shopify-product-query

linkfox-shopify-product-query

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

关于 linkfox-shopify-product-query

LinkFox 技能用于查询 Shopify 商品,可按指标区间、广告、货源、上架状态和发货国家筛选。支持排序与分页,费用按返回商品数量动态计算。

主要功能

  1. 01按指标区间筛选商品
  2. 02筛选广告和货源状态
  3. 03包含已下架商品
  4. 04排序并分页浏览结果

适用场景

  1. 01按销量或价格范围查找商品
  2. 02识别有 Facebook 广告的商品
  3. 03按货源情况筛选商品
  4. 04按发货国家查看商品

MCP 相关

README 将其描述为 LinkFox 技能,并提供可选 Python 脚本,但未说明 MCP 接口。

安装

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

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

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

包含的文件

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

references/
api.md
onboarding.md
scripts/
onboarding.py
shopify_product_query.py

详细介绍

来自项目 README

Shopify 商品查询

要点

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

脚本(可选)

命令行调试:python scripts/shopify_product_query.py '<JSON>'(需 LINKFOXAGENT_API_KEY)。详见 references/api.md 末尾。

解决认证和算力问题

发生以下异常情况时,采用 references/onboarding.md 引导解决问题:

异常情况
  • 未配置API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY。
  • 响应401或402状态码
  • 响应提示算力或余额不足:消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。

参考

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

算力消耗规则

按动态规则计费:消耗算力 = 返回的商品数 × 1.8。按本页返回条数计费;翻到下一页,本质上是再发一次请求,再按下一页返回条数重新计算。

重要:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。

评论

支持 Markdown