mcpField
L
linkfox-shopify-store-query

linkfox-shopify-store-query

github.com/linkfox-aiMarketing & growth113226 installsUpdated 2w ago
Repository

About linkfox-shopify-store-query

This skill queries Shopify store data with filters, pagination, and sorting. It is for users researching store size, traffic, orders, and social followers; result counts affect compute usage, so further pages require confirmation.

Key features

  1. 01Filter by products, ads, traffic, and orders
  2. 02Filter by country code and store age
  3. 03Paginate results, up to 100 per page
  4. 04Sort by store metrics

Use cases

  1. 01Find Shopify stores matching size or traffic criteria
  2. 02Rank stores by monthly orders or social followers
  3. 03Search results page by page while controlling result counts

Install

Copy the command and run it in a terminal.

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

After installing, type/linkfox-shopify-store-queryin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

Shopify 店铺查询

要点

  • 分页: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/shopify_store_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。按本页返回条数计费;翻到下一页,本质上是再发一次请求,再按下一页返回条数重新计算。

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

Comments

Markdown supported