mcpField
L
linkfox-ehunt-shopify-store-query

linkfox-ehunt-shopify-store-query

github.com/linkfox-aiマーケティング・グロース11389 回インストール2 週間前に更新
リポジトリ

linkfox-ehunt-shopify-store-query について

linkfox-ehunt-shopify-store-queryは、LinkFoxのサードパーティデータサービスを通じてShopifyストア情報を検索するスキルです。店舗調査向けに、ページネーション、絞り込み、並べ替え、大きなレスポンスの扱い方を説明します。

主な機能

  1. 01ゲートウェイルート経由でShopifyストアを検索
  2. 02ページネーションと範囲指定フィルター
  3. 03店舗年数と国による絞り込み
  4. 04店舗指標と順序による並べ替え
  5. 05大きなレスポンスを保存して選択的に読み込み

活用シーン

  1. 01商品数やトラフィック範囲に合う店舗の検索
  2. 02訪問数や注文数による店舗結果の並べ替え
  3. 03大きな結果から指定フィールドを確認

MCP 対応

LinkFoxのサードパーティデータサービスMCPを通じて、`ehunt/shopify/storeQuery`ルートを呼び出します。認証と上流ルーティングはゲートウェイが処理します。

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/linkfox-ehunt-shopify-store-queryを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
api.md
scripts/
ehunt_shopify_store_query.py
response_io.py

詳細

EHunt Shopify ストア検索（ehunt/shopify/storeQuery）

LinkFox の「第三者データサービス」MCP が利用できる場合、対応するゲートウェイルート ehunt/shopify/storeQuery を呼び出します（MCP の表示名：Shopify ストア検索。正確なツール名は、現在の環境から提供されるツールメタデータに従ってください）。認証と上流ルートはゲートウェイが処理します。レスポンスにルートレベルの code フィールドが含まれる場合、成功かどうかは実環境で確認してください。

要点

  • ページネーション：page は 1 から始まります。pageSize のデフォルトは 20、最大値は 100 です。
  • 範囲パラメーター：*Min / *Max をペアで指定し（商品数、広告数、月間訪問数、月間注文数）、上流の範囲を構成します。
  • ストアの年数 year：1＝直近 1 年、2＝1～2 年、3＝2～3 年、4＝3 年以上。
  • 並べ替え：sortBy は整数の列挙値です（0＝商品数、1＝カテゴリ数、2＝月間訪問数、3＝FB フォロワー数、4＝Ins フォロワー数、5＝広告数、6＝関連度、7＝月間注文数（デフォルト））。orderBy は desc（デフォルト）／asc です。
  • 国：country には国コード（例：US、CN）を指定します。

スクリプト（任意）

コマンドラインでのデバッグ：python scripts/ehunt_shopify_store_query.py '<JSON>'（LINKFOXAGENT_API_KEY が必要です）。詳しくは references/api.md の末尾を参照してください。

参考資料

パラメーターとレスポンスの表は references/api.md を参照してください。

大きなレスポンスの処理

エージェントのコンテキストがあふれないよう、レスポンスをディスクに保存し、必要なフィールドだけを抽出してください。

python scripts/response_io.py run --script scripts/ehunt_shopify_store_query.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は Git 作業ツリーの外（Unix では /tmp/...、Windows では %TEMP%/... など）に指定してください。保存したレスポンスには、個人情報、価格情報、または認証に関わる機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、作業が終わったら削除してください。

run は完全なレスポンスをファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は特定のフィールドを抽出します。--limit/--offset で範囲を指定し、--format json|jsonl|csv|table で出力形式を指定できます。

この方法を優先する場合 — レスポンスの特性に応じて判断してください。例：

  • レコードごとのフィールド数が多い、または不要なフィールドがある
  • バッチ／ページネーションされた結果（1 回の呼び出しで複数の項目が返る）
  • 長文フィールド（説明、レビュー、HTML、時系列データ）
  • すぐに使用せず、後続の手順で再利用する出力

小規模で一度だけ使用するレスポンスであれば、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューはスキーマとサンプルを一部切り詰めて表示したもので、完全なデータではありません。フィールド単位で判断する場合は、必ず保存したファイルを read で読み込んでください。

コメント

Markdown 対応