Gemini CLI + X (Twitter)

What is Gemini CLI?

Google's open-source terminal agent for Gemini models. Supports MCP servers and custom tools — plug Scavio in for live web, shopping, and video data.

Searching X (Twitter) with Gemini CLI

This integration lets your Gemini CLI agent search X (Twitter) in real time via the Scavio API. The agent gets back structured JSON with post text, author handles, created_at timestamps, favorites, retweets, replies, quotes -- ready for reasoning and decision-making.

Setup

npm install -g @google/gemini-cli

Code Example

Here is a complete Gemini CLI agent that searches X (Twitter) using Scavio:

# Generic HTTP integration for Gemini CLI
# Point your framework's HTTP request tool at:
#
#   POST https://api.scavio.dev/api/v1/x/search
#   Authorization: Bearer sk_live_your_key
#   Content-Type: application/json
#   {"search":"your search query","search_type":"Latest"}
#
# Rows come back under data.timeline.
#
# X takes search (not query). search_type is one of Top, Latest, People, Photos, Videos.

Full Working Example

A production-ready example with error handling:

# Generic HTTP integration for Gemini CLI
# Point your framework's HTTP request tool at:
#
#   POST https://api.scavio.dev/api/v1/x/search
#   Authorization: Bearer sk_live_your_key
#   Content-Type: application/json
#   {"search":"your search query","search_type":"Latest"}
#
# Rows come back under data.timeline.
#
# X takes search (not query). search_type is one of Top, Latest, People, Photos, Videos.

Pricing

Scavio offers a free tier with 50 credits on signup (1 credit per search). No credit card required. This is enough to build and test your Gemini CLI integration. Paid plans start at $30/month for higher volumes.