Hermes エージェント入門 : X (Twitter) 検索

Posted on by Masashi Okumura

x_search ツールを使用すると、エージェントは X（Twitter）の投稿、プロフィール、スレッドを直接検索できます。これは Responses API 上の xAI の組み込み x_search ツールによって支えられています – Grok 自体がサーバー側で検索を実行し、元の投稿への引用を含む合成された結果を返します。

Hermes エージェント☤ 入門 : 機能 – メディア & Web : X (Twitter) 検索

作成 : Masashi Okumura (@classcat.com)
作成日時 : 09/15/2026
バージョン : Hermes Agent v0.21.3 (v2026.9.14)

* 本記事は hermes-agent.nousresearch.com/docs の以下のページを参考にしています :

* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。

 

 

Hermes エージェント☤ 入門 : 機能 – メディア & Web : X (Twitter) 検索

x_search ツールを使用すると、エージェントは X（Twitter）の投稿、プロフィール、スレッドを直接検索できます。これは、https://api.x.ai/v1/responses の Responses API 上の xAI の組み込み x_search ツールによって支えられています – Grok 自体がサーバー側で検索を実行し、元の投稿への引用を含む合成された結果を返します。

X 上 の直近の議論、反応、主張を具体的に取得したい場合は、web_search の代わりにこちらを使用してください。一般的なウェブページについては、引き続き web_search / web_extract を使用してください。

 

x_search vs xurl

Hermes は 2 つの異なる X サーフェイスを提供できます :

サーフェイス 用途 非推奨用途
x_search 公開 X の読み取り専用検索: 直近の議論、反応、主張、プロフィール、スレッド、出典付きの合成回答の取得。 投稿、返信、いいね、DM、メディアアップロード、削除、または認証済み X アカウントの状態変更の確認。
xurl スキル 正確な API 操作または認証を伴う X API 作業: 投稿、返信、閲覧、いいね、DM、タイムライン、メンション、メディアアップロード、特定アカウント情報の取得、無加工な v2 エンドポイントの利用。 x_search が利用可能で、認証済みアカウントのコンテキストを必要としない広範な Grok 合成による公開 X リサーチ。

複数のワークフローが混在する場合は、x_search を使用して候補となる公開投稿を検出し、対象の投稿/ユーザー/アクションが明確になった後に、`xurl read` または別の正確な xurl コマンドに切り替えてください。状態を変更する X アクションは、xurl の出力または X API の応答によって確認する必要があります; x_search の応答は、書き込みが行われた証拠にはなりません。

 

認証

x_searchは、xAI 認証情報パスのいずれかが利用可能な場合に登録します :

認証情報 ソース セットアップ
SuperGrok / X Premium+ OAuth accounts.x.ai でブラウザログイン、自動的に更新されます `hermes auth add xai-oauth` – xAI Grok OAuth (SuperGrok / X Premium+) 参照
XAI_API_KEY (推奨) 有料の xAI API キー ~/.hermes/.env で設定

どちらも同じエンドポイントに同じペイロードを送信します – 唯一の違いはベアラー・トークンです。両方が設定されている場合、明示的に設定された XAI_API_KEY が優先されます – サブスクリプション OAuth ベアラーは /v1/responses を認証しますが、API キーが実際の投稿を返す一方で、x_search に対しては引用のない劣化した (degraded) Grok 説明モードで応答します。これは、キーが設定されている場合、x_search が従量制 API 課金の対象となることを意味することに注意してください; XAI_API_KEY を削除すると、サブスクリプションのクォータにフォールバックします（ただし、劣化した応答になります）。

ツールの check_fn は、モデルのツールリストが再構築されるたびに xAI 認証情報リゾルバを実行します。True が返された場合、ベアラートークンが取得可能で AND 空ではなく AND（有効期限が切れていた場合は）正常に更新されたことを意味します。(更新に失敗した) 失効トークンは、スキーマからツールを非表示にします; つまり、モデルはそれを認識できません。

 

ツールの有効化

xAI 認証情報（OAuth トークンまたは XAI_API_KEY）が存在する場合、自動的に有効化されます。有効化したくない場合は、`hermes tools` → Search → x_search から明示的に無効化してください。

hermes tools
# → 🐦 X (Twitter) Search   (press space to toggle on)

選択ツールでは、以下の2つの選択肢が表示されます :

  1. xAI Grok OAuth (SuperGrok / Premium+) — ログインしていない場合は、ブラウザで accounts.x.ai が開きます。

  2. xAI API キー — XAI_API_KEY の入力を求められます。

どちらの選択肢でもアクセス制御要件 (gating) を満たします。既にお持ちの認証情報を選択していただいて構いません; どちらの認証情報でもツールは同じように動作します。両方の認証情報が設定されている場合は、呼び出し時に OAuth が優先されます。

 

設定

# ~/.hermes/config.yaml
x_search:
  # xAI model used for the Responses call.
  # grok-4.5 is the recommended default; any Grok model
  # with x_search tool access works.
  model: grok-4.5

  # Optional reasoning effort: low, medium, high, or xhigh. When omitted,
  # the selected model's default applies. xhigh is supported only by
  # models that document it, such as grok-4.20-multi-agent.
  # reasoning_effort: low

  # Request timeout in seconds. x_search can take 60–120s for
  # complex queries — the default is generous. Minimum: 30.
  timeout_seconds: 180

  # Number of automatic retries on 5xx / ReadTimeout / ConnectionError.
  # Each retry backs off (1.5x attempt seconds, capped at 5s).
  retries: 2

reasoning_effort は、xAI Responses API に `reasoning: {effort: …}` として送信されます。設定可能な推論をサポートしていないモデルの場合は、この値を unset (未設定) のままにしてください。無効な値の場合、API リクエストが送信される前にエラーが発生します。

 

以上