linkfox-shopify-product-query
About linkfox-shopify-product-query
A LinkFox skill for querying Shopify products with filters for metric ranges, ads, suppliers, listing status and shipping country. It supports sorting and pagination, with usage dynamically billed by the number of returned products.
Key features
- 01Filter by metric ranges
- 02Filter ad and supplier status
- 03Include delisted products
- 04Sort and paginate results
Use cases
- 01Find products within sales or price ranges
- 02Identify products with Facebook ads
- 03Filter by supplier availability
- 04Review products by shipping country
MCP support
The README describes this as a LinkFox skill and documents an optional Python script, but does not specify an MCP interface.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/linkfox-shopify-product-queryin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/api.mdonboarding.mdscripts/onboarding.pyshopify_product_query.pyDetails
From the project 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。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。
重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。