How-To Series · 4: Eyes, Ears, Voice

X Search

Search X posts, profiles, and threads from inside the agent, with citations.

After this videoYour agent can pull current discussion straight from X and cite the posts it used

X Search exposes the x_search tool, backed by xAI's built-in x_search on the Responses API. Grok runs the search server-side and returns a synthesized answer with citations. Authenticate with SuperGrok OAuth (preferred) or XAI_API_KEY, then the tool auto-enables. Configure model, timeout, and retries in config.yaml. Use it for current discussion on X instead of web_search, and watch the degraded flag, which marks an unsourced answer when a narrowing filter returned no posts.

About these resources. This episode explains how to set up and use X Search in Hermes. The Sources block names the Hermes docs page that backs every claim.

Sources · What this video distills

1 docs page · every command below traces to one of them

Primary guide

X (Twitter) Search

Commands shown · Copy and paste

each shows the source doc it came from

Add SuperGrok / X Premium+ OAuth credentialsfrom source ↗

hermes auth add xai-oauth

Toggle the X (Twitter) Search toolfrom source ↗

hermes tools

Configure model, timeout, and retriesfrom source ↗

x_search:
  model: grok-4.20-reasoning
  timeout_seconds: 180
  retries: 2

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

The SuperGrok / Premium+ OAuth setup guide.

Web Search & Extract

General (non-X) web search and page extraction.

Next in the series · Episodes that build on this

Deliverable Mode