linkfox-ehunt-shopify-product-query

EHunt Shopify 商品検索（ehunt/shopify/productQuery）

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

要点

• ページネーション：page は 1 から始まります。pageSize のデフォルトは 20、最大は 100 です（≤50 を推奨）。
• 範囲パラメーター：*Min / *Max はペアで指定し、上流の範囲を構成します。片側だけを指定すると、上流では「開始~」または「~終了」になります。
• 並べ替え：sortBy は整数の列挙値です（デフォルトは 14=週次販売数の降順。価格／広告数／競争度／売上高などの値もあります。詳細は references/api.md を参照してください）。
• ブール値フィルター：facebookAd（1=広告あり）、hasSupplier（1=仕入先あり、0=なし）、showDeleted（1=販売終了商品を含む）は、いずれも整数のスイッチです。
• 発送国：country には 2 文字の国コード（例：US）を指定します。

スクリプト（任意）

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

参考

入力／出力パラメーターの表は references/api.md を参照してください。

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/ehunt_shopify_product_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 で読み込んでください。