Use your existing X Premium Plus or Super Grok subscription for real-time X search via Hermes at zero additional API cost. Includes the VPS headless OAuth workaround that took Nemanja 1 hour to figure out, plus six use cases.

Watch on YouTube

Requirements

Only available on X Premium Plus or Super Grok subscriptions. Not available on Premium or Basic plans. Check pricing for your region.

Local Machine Setup

1. Run hermes model in terminal
2. Select X AI / Grok
3. Browser opens for OAuth - click Allow
4. Enable X search: hermes tools -> search CLI -> spacebar to enable

VPS Setup (Headless OAuth Workaround)

VPS instances are headless: no browser available. Standard OAuth fails. This workaround took Nemanja 1 hour to figure out.

Steps:

1. Run hermes model on VPS - generates an authorization URL
2. Copy that URL to your local machine browser where you are logged in to X
3. Click Allow on X - the connection does NOT auto-establish on the VPS
4. Copy the redirect URL from your browser
5. Ask Hermes: "I'm trying to log into X AI. Extract the code and state from this URL: [paste redirect URL]"
6. Hermes extracts the params and completes auth

After auth, enable search in hermes tools as above. Then run hermes and test: "Find me some news about AI and Hermes Agent today."

Six Production Use Cases

1. Daily News Summary Replace 10-15 minutes of manual Twitter scrolling. Much faster and more token-efficient than Playwright/browser-based X access.

2. Account Monitoring Follow specific accounts (AI researchers, tool developers) and surface daily highlights.

3. Article and Thread Summary "Summarize this X article using X search." Can crawl through post threads and replies.

4. Brand Mention Monitoring "Search X for mentions of [company]." Returns sentiment and volume. Set as a scheduled weekly summary. Nemanja uses this for PressWiz.

5. Customer Pain Point Mining Search X for what customers say about a problem. Extract exact language for landing page copy, content angles, video titles, ad hooks.

6. Content Research Find multiple opinions on a topic, surface five different angles for content creation.

Cost

Zero additional cost if already paying for X Premium Plus or Super Grok. This subscription's API access is used directly - not Hermes API credits.

Why This Beats Playwright

• Token-efficient: no browser overhead
• Faster response time
• Zero incremental cost against existing subscription
• Real-time data, not cached