linkfox-ehunt-temu-category-search について
LinkFoxの第三者データサービスMCP向けのTemuカテゴリ検索スキルです。ローカルデータを対象に、中国語名、英語名、カテゴリIDをキーワードで部分一致検索し、ページ分割して取得します。検索前にカテゴリ全件の同期が必要です。
主な機能
- 01名称やカテゴリIDの部分一致検索
- 02ページ分割での結果取得
- 03後続検索に使えるカテゴリIDの返却
- 04同期済みローカルデータの検索
活用シーン
- 01TemuのカテゴリとIDの検索
- 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.mdscripts/ehunt_temu_category_search.pyresponse_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 を使って保存済みファイルを読み取ってください。