mcpField
L
linkfox-ehunt-etsy-store-query

linkfox-ehunt-etsy-store-query

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

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

LinkFox のサードパーティデータサービス MCP 経由で Etsy のショップ情報を検索するスキルです。ページ分割、範囲指定、販売数・レビュー数・お気に入り数による並べ替えに対応します。

主な機能

  1. 01ページ分割によるショップ検索
  2. 02開始・終了範囲による絞り込み
  3. 03販売数、レビュー数、お気に入り数での並べ替え
  4. 04昇順・降順の指定

活用シーン

  1. 01条件に合う Etsy ショップの絞り込み
  2. 02ショップの総販売数と週間販売数の比較
  3. 03レビュー数やお気に入り数によるショップ順位付け

MCP 対応

LinkFox のサードパーティデータサービス MCP から `_ehunt_storeQuery` を呼び出して Etsy ショップを検索します。

インストール

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

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

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

同梱ファイル

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

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

詳細

EHunt Etsy ショップ検索（_ehunt_storeQuery）

LinkFox「サードパーティデータサービス」MCP が利用できる場合は、ツール名 _ehunt_storeQuery で呼び出します（MCP の表示名：Etsyショップ検索。現在の環境で提供されるツールメタデータを基準としてください）。認証と上流へのルーティングはゲートウェイが処理します。ルートレベルの code フィールドがレスポンスに含まれる場合、成功かどうかは実環境で確認してください。

ポイント

  • ページネーション：page は 1 から始まります。pageSize のデフォルトは 20、最大は 100 です。
  • 範囲指定の入力：begin* と end* は、上流のカンマ区切り範囲に対応します。片方だけを指定した場合、上流では「開始~」または「~終了」となります。
  • 並べ替え：sortBy は 8～11 のみです（8：総販売数、9：週間販売数、10：レビュー数、11：お気に入り数）。sortDesc は 1＝降順、0＝昇順 です（商品インターフェースの sortDesc と混同しないでください）。

スクリプト（任意）

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

参考資料

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

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/ehunt_etsy_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 レコードあたりのフィールド数が多い場合、または不要なフィールドがある場合
  • バッチ／ページネーションされた結果（1 回の呼び出しで複数の項目を取得する場合）
  • 長文フィールド（説明、レビュー、HTML、時系列データ）
  • すぐに消費するのではなく、後続のステップで出力を再利用する場合

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

⚠️ プレビューは、スキーマとサンプルを省略して表示したものであり、データ全体ではありません。フィールド単位で判断する場合は、read を使って保存済みファイルを読み込んでください。

コメント

Markdown 対応