mcpField
L
linkfox-ehunt-temu-product-query

linkfox-ehunt-temu-product-query

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

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

EHunt の productQuery ルートを通じて Temu の商品データを検索する LinkFox スキルです。フィルタリング、並べ替え、ページネーションに対応し、大きな応答を保存して必要な項目だけ読み取れます。

主な機能

  1. 01価格、販売数、評価、カテゴリ、状態による商品絞り込み
  2. 02ページネーションと並べ替え設定
  3. 03大きな応答の保存と指定項目の読み取り

活用シーン

  1. 01価格や販売数の範囲で商品を検索
  2. 02評価、カテゴリ、販売数による商品比較
  3. 03ページ分割された結果から必要な項目を確認

MCP 対応

LinkFox の「第三方数据服务」MCP を使い、`ehunt/temu/productQuery` ゲートウェイルートを呼び出します。正確なツール名は、現在の環境から提供されるメタデータによって異なります。

インストール

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

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

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

同梱ファイル

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

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

詳細

EHunt Temu 商品クエリ（ehunt/temu/productQuery）

LinkFox の「サードパーティデータサービス」MCP が利用可能な環境では、対応するゲートウェイルート ehunt/temu/productQuery を呼び出します（MCP の表示名：Temu 商品クエリ。正確なツール名は、現在の環境で提供されるツールメタデータに従ってください）。認証と上流ルーティングはゲートウェイが処理します。レスポンスにルートレベルの code フィールドが含まれる場合、成功かどうかは実環境で確認してください。

要点

  • ページネーション：page は 1 から始まります。pageSize のデフォルトは 20、最大は 100 です（50 以下を推奨）。
  • 範囲パラメーター：*Begin と *End はペアで指定し（価格、評価、レビュー数、合計／週／日の販売数、出品時刻）、上流の範囲を構成します。
  • カテゴリー：categoryHome はフロントエンドカテゴリー ID、categoryBackend はバックエンドカテゴリー ID です。先に Temu のカテゴリー検索を使用して ID を取得できます。
  • フルフィルメント方式：isLocal（0＝フルマネージド、1＝セミマネージド）。セミマネージドの場合は、region で地域を指定できます（複数指定する場合はカンマで区切ります）。
  • 販売状態：soldOut（0＝販売中、1＝販売終了）。
  • タグ：tags／customTags は複数指定する場合、カンマで区切ります。
  • 並べ替え：sortBy は「フィールド-方向」の文字列です。例：order_week-0（週販売数の降順、デフォルト）、price-0、order_total-0、rating-0。

スクリプト（任意）

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

参考

パラメーターとレスポンスの表は references/api.md を参照してください。

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/ehunt_temu_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 対応