mcpField
L
linkfox-ehunt-etsy-product-query

linkfox-ehunt-etsy-product-query

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

linkfox-ehunt-etsy-product-query について

LinkFoxの「第三者データサービス」MCPを使うEtsy市場調査向けのスキルで、`_ehunt_productQuery`から商品データを検索します。ページネーション、絞り込み、並べ替えに対応し、大きな応答はファイルに保存して必要な項目を読み出せます。

主な機能

  1. 01商品タイプとカテゴリーで絞り込み
  2. 02ページネーションと範囲指定
  3. 03項目と順序を指定した並べ替え
  4. 04大きな応答の保存と選択読み出し

活用シーン

  1. 01商品タイプでEtsy商品を絞り込む
  2. 02ページを分けて商品検索結果を取得
  3. 03大きな結果を保存して項目を抽出

MCP 対応

LinkFoxの「第三者データサービス」MCP経由で`_ehunt_productQuery`を呼び出し、MCPクライアントにEtsy商品検索を提供します。

インストール

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

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

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

同梱ファイル

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

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

詳細

EHunt Etsy 商品検索（_ehunt_productQuery）

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

要点

  • ページネーション：page は 1 から始まります。pageSize のデフォルトは 20、最大は 100 です（≤50 を推奨）。
  • 範囲パラメーター：ショップのインターフェースと同様に、begin* / end* をペアで指定します。
  • 並べ替え：sortBy は 1~6 です（EHunt 上流の sort_by）。sortDesc：1=降順、2=昇順（_ehunt_storeQuery の 1/0 とは異なります）。
  • 商品タイプ productType：1 手作り、2 ヴィンテージ、3 デジタル、4 カスタム、9 その他。複数指定する場合はカンマで区切ります。
  • 通貨：currencyCode のデフォルトは USD です。
  • カテゴリ ID：category は単一カテゴリの ID です。カテゴリ検索系のスキルで ID を取得してから指定できます。

スクリプト（任意）

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

参考

パラメーター／レスポンスの表は references/api.md をご覧ください。

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/ehunt_etsy_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 を使って保存済みファイルを確認してください。

コメント

Markdown 対応