Grok X 検索

Grok X 検索 は何をしますか？

概要

このスキルは、X の投稿が主な証拠ソースとなる場合に使用します。バンドルされたスクリプトを uv run で実行することで、OpenRouter へのリクエスト形式、X フィルタ、モデル選択、出力フォーマットを一貫させ、アドホックな API 呼び出しを避けられます。

ワークフロー

1. リクエストを以下の要素に正規化します:

• トピックまたはエンティティ
• 時間枠
• オプションで含める/除外するハンドル
• 画像や動画が重要な場合
• 質問が簡潔/集中的か、深い/多面的か

2. HTTP リクエストを手書きする代わりに uv run scripts/search_x.py ... を使用します。

3. デフォルトは --model multi-agent（＝ x-ai/grok-4.20-multi-agent）です。明確な理由がある場合のみ上書きします:

• --model fast（＝ x-ai/grok-4.1-fast）: 安価な集中的検索、単一ハンドルクエリ、厳格なコスト制限がある場合
• --model auto: コストを意識した複雑性ベースのルーティング（以前のデフォルト）
• --model multi-agent を維持: 比較、トレンド合成、広い範囲、または深い作業向け
• --reasoning-effort high|xhigh と組み合わせて、4 エージェントから 16 エージェントに増強

4. ユーザーが厳しい制約を与えた場合は、プロンプトの表現よりもフィルタを優先します:

• --allow-handle または --exclude-handle でソースを制御
• --from-date と --to-date で鮮度の範囲を指定
• --include-images または --include-videos はメディアコンテンツが重要な場合のみ

5. 以下の要素を含めて結果を返します:

• 簡潔な直接回答
• 主要な X 側のシグナル
• 証拠が混在している場合の不一致や不確実性
• 実際に使用されたモデル
• 検索を実質的に制約したフィルタ

クイックスタート

スクリプトを呼び出す前に、シェルで API キーをエクスポートします:

export OPENROUTER_API_KEY="..."

毎回エクスポートせずにスキルを動作させたい場合は、以下を保存します:

mkdir -p ~/.config/grok-x-search
printf 'OPENROUTER_API_KEY=...\n' > ~/.config/grok-x-search/env
chmod 600 ~/.config/grok-x-search/env

集中的な検索:

uv run ~/.codex/skills/grok-x-search/scripts/search_x.py \
  "What are people on X saying about OpenRouter's latest Grok support?" \
  --from-date 2026-04-01

ハンドル指定検索:

uv run ~/.codex/skills/grok-x-search/scripts/search_x.py \
  "Summarize the recent messaging around Grok 4.20 multi-agent" \
  --allow-handle xAI \
  --allow-handle OpenRouterAI \
  --from-date 2026-03-31

より深い合成:

uv run ~/.codex/skills/grok-x-search/scripts/search_x.py \
  "Compare sentiment on X toward Grok 4.1 Fast versus Grok 4.20 Multi-Agent since launch, including speed, price, and quality tradeoffs" \
  --model multi-agent \
  --reasoning-effort high \
  --from-date 2026-03-31

実際に送信せずにリクエストをプレビュー:

uv run ~/.codex/skills/grok-x-search/scripts/search_x.py \
  "What are developers saying on X about Grok 4.1 Fast?" \
  --dry-run

クエリ整形ルール

ユーザーの文をそのまま検索クエリとして扱わないでください。モデルは内部検索呼び出しを生成する必要がありますが、送信するリクエストは適切に構造化する必要があります:

• エンティティ、製品、イベントを明示的に記述する
• 分析タスクを明示する: 反応、センチメント、比較、タイムライン、批判、ローンチの受け止め
• 鮮度が重要な場合は時間枠を追加する
• ユーザーリクエストにエイリアス、二言語表現、ハッシュタグを含める（リコールが向上する場合）
• エビデンス品質の処理を依頼する（例: "不一致を指摘する"、"証拠が少ない場合はその旨を伝える"）

良い例:

2026-03-31 以降の Grok 4.1 Fast と Grok 4.20 Multi-Agent に対する X 上の最近の反応を比較してください。レイテンシ、価格感度、研究品質の認識に焦点を当ててください。不一致に注意し、投稿を引用してください。

悪い例:

X で Grok を検索して。

モデルルーティング

--model multi-agent（＝ x-ai/grok-4.20-multi-agent）がデフォルトです。--reasoning-effort medium は 4 エージェント、high / xhigh は 16 エージェントで動作します。

デフォルト（multi-agent + medium）を維持するケース:

• 製品、期間、ステークホルダーグループ間の比較
• より広い時間範囲にわたるトレンド合成
• トレードオフ、競合するナラティブ、より深い調査を求めるプロンプト
• ほぼすべての非自明な X 側調査

--model fast（＝ x-ai/grok-4.1-fast）に切り替えるケース（以下のみ）:

• 1 つのトピックかつ 1 つの最近のイベント
• 狭いハンドルセット
• 明示的な「クイックチェック」/コスト重視の検索

--model auto に切り替えるケース: 以前のコスト認識ヒューリスティックルーティングが必要な場合のみ。

価格（OpenRouter、2026-04）:

• grok-4.20-multi-agent: $2 / $6 per 1M tokens, $5/K web search
• grok-4.1-fast: $0.20 / $0.50 per 1M tokens, $5/K web search

詳細な根拠やヒューリスティックを変更したい場合は、references/openrouter-grok-notes.md を参照してください。

実装上の注意

• バンドルされたスクリプトは OpenRouter Chat Completions を使用します。OpenRouter の文書化された X 固有フィルタは Web プラグインパスで公開されているためです。
• リクエストは plugins: [{"id":"web","engine":"native"}] に加えて x_search_filter を使用するため、利用可能な場合は xAI ネイティブ検索が使用されます。
• システムプロンプトはモデルを x_search に偏らせます。OpenRouter は xAI モデルで web_search も併用可能にする場合があります。
• スクリプトは uv run で実行可能であり、インストール後は直接実行できるように uv シェバングも保持しています。
• スクリプトは最初にシェルから OPENROUTER_API_KEY を読み取り、次に ~/.config/grok-x-search/env にフォールバックします。
• スクリプトは最終回答を stdout に、リクエスト診断情報を stderr に出力します。

リソース

スクリプト

• scripts/search_x.py: X に焦点を当てた Grok 検索のための OpenRouter クライアント。自動モデル選択とフィルタサポート付き。

参考資料

• references/openrouter-grok-notes.md: OpenRouter/XAI の動作、モデル価格、ルーティングの根拠に関するソースベースのメモ。