关于 linkfox-shopify-product-query
LinkFox 技能用于查询 Shopify 商品,可按指标区间、广告、货源、上架状态和发货国家筛选。支持排序与分页,费用按返回商品数量动态计算。
主要功能
- 01按指标区间筛选商品
- 02筛选广告和货源状态
- 03包含已下架商品
- 04排序并分页浏览结果
适用场景
- 01按销量或价格范围查找商品
- 02识别有 Facebook 广告的商品
- 03按货源情况筛选商品
- 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.mdonboarding.mdscripts/onboarding.pyshopify_product_query.py详细介绍
来自项目 READMEShopify 商品查询
要点
- 分页:
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