linkfox-ehunt-etsy-category-search

EHunt Etsy カテゴリ検索（_ehunt_etsyCategorySearch）

LinkFox「第三者データサービス」の MCP を利用できる場合、ツール名 _ehunt_etsyCategorySearch で呼び出します（MCP 表示名：Etsyカテゴリ検索。現在の環境から提供されるツールメタデータを基準としてください）。データは MCP ライブラリ内のローカル検索から取得されます。

前提条件

ライブラリ内に、_ehunt_syncEtsyCategory で書き込まれた全カテゴリデータ（MCP 表示名：Etsyカテゴリ同期）が必要です。データがない場合や結果が空の場合は、先に同期を完了してから検索してください。

要点

• 必須：keyword（カテゴリ名、カテゴリ ID、parentIds に対する部分一致）。
• ページネーション：page は 1 から開始します。pageSize のデフォルト値は 50、最大値は 200 です。
• 返される id は、_ehunt_productQuery／ショップ側の category などの入力パラメーターでカテゴリ ID として使用できます（各ツールのスキーマと一致していれば問題ありません）。

スクリプト（任意）

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

参考

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

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/ehunt_etsy_category_search.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 を使って保存ファイルから読み込んでください。