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. 02Facebook広告のある商品を特定
  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。按本页返回条数计费;翻到下一页,本质上是再发一次请求,再按下一页返回条数重新计算。

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

コメント