mcpField
L
linkfox-ehunt-temu-category-search

linkfox-ehunt-temu-category-search

github.com/linkfox-aiデータ・データベース11390 回インストール2 週間前に更新
リポジトリ

linkfox-ehunt-temu-category-search について

LinkFoxの第三者データサービスMCP向けのTemuカテゴリ検索スキルです。ローカルデータを対象に、中国語名、英語名、カテゴリIDをキーワードで部分一致検索し、ページ分割して取得します。検索前にカテゴリ全件の同期が必要です。

主な機能

  1. 01名称やカテゴリIDの部分一致検索
  2. 02ページ分割での結果取得
  3. 03後続検索に使えるカテゴリIDの返却
  4. 04同期済みローカルデータの検索

活用シーン

  1. 01TemuのカテゴリとIDの検索
  2. 02商品・店舗検索用カテゴリパラメーターの準備

MCP 対応

LinkFoxの第三者データサービスMCP経由で`ehunt/temu/temuCategorySearch`ルートを呼び出します。カテゴリ同期ツールが登録したローカルデータを検索します。

インストール

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

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-ehunt-temu-category-search

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

同梱ファイル

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

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

詳細

EHunt Temu カテゴリー検索(ehunt/temu/temuCategorySearch)

LinkFox の「サードパーティーデータサービス」MCP を利用できる場合、ゲートウェイルート ehunt/temu/temuCategorySearch を呼び出します(MCP の表示名:Temu カテゴリー検索。正確なツール名は、現在の環境で提供されるツールメタデータに従ってください)。データは ローカルデータベース検索から取得されます。

前提条件

データベースに ehunt/temu/syncTemuCategory(MCP の表示名:Temu カテゴリー同期)によって書き込まれたすべてのカテゴリーが存在している必要があります。データがない場合や結果が空の場合は、先に同期を完了してから検索してください。

ポイント

  • 必須:keyword(カテゴリーの中国語名、英語名、カテゴリー ID に対する部分一致検索)。
  • ページネーション:page は 1 から開始します。pageSize のデフォルトは 50、最大は 200 です。
  • 返される id / categoryId は、Temu 商品検索の categoryHome/categoryBackend や、ショップ検索の category などの入力値として、カテゴリー識別子に使用できます(各ツールのスキーマに合わせてください)。

スクリプト(任意)

コマンドラインでのデバッグ:python scripts/ehunt_temu_category_search.py '<JSON>'(LINKFOXAGENT_API_KEY が必要です)。詳しくは references/api.md の末尾をご覧ください。

参考情報

入力・出力の表は references/api.md をご覧ください。

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/ehunt_temu_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、時系列データ)
  • すぐに使わず、後続の手順でも出力を再利用する場合

小規模で 1 回しか使わないレスポンスであれば、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューはスキーマとサンプルの一部であり、完全なデータではありません。フィールド単位の判断を行う場合は、read を使って保存済みファイルを読み取ってください。

コメント