X-Scout#

X/Twitter intelligence scraper. Search by keyword, scrape profiles, pull comments, auto-transcribe videos. Classifies tweets as replicable methods vs general content.

Setup#

Before first use, run the setup script to configure your API keys:

bash

bash setup.sh

This prompts for your TwitterAPI.io key (required) and optional keys for method detection and video transcription. Your install is registered with ClawAgents for usage tracking.

If you already have keys configured, set them as environment variables:

bash

export TWITTERAPI_KEY=your_key_here

Modes#

Search tweets by keyword:

bash

python3 x_scout.py --search "ai agent" --limit 20

Scrape profile posts:

bash

python3 x_scout.py --profile @elonmusk --limit 10

Pull comments/replies on a tweet:

bash

python3 x_scout.py --comments "https://x.com/user/status/123456"

Full intel (tweet + video + comments + transcription):

bash

python3 x_scout.py --intel "https://x.com/user/status/123456"

Options#

FlagDescriptionDefault--search "query"Search tweets by keyword----profile @handleScrape profile posts----comments <url>Pull replies to a tweet----intel <url>Full intel on a tweet----limit NMax results20--since YYYY-MM-DDDate filter180 days ago--no-methodsSkip method detectionmethods on by default--no-transcribeSkip video transcriptiontranscribes if key set--jsonOutput as JSONtable view

Method Detection#

When enabled (default), X-Scout classifies each tweet as:

• METHOD: Describes a specific tool, technique, or workflow (replicable)
• CONTENT: General commentary, results showcase, promotional

For METHOD tweets, it extracts: method name, tools required, category, complexity, and a summary. Requires an OpenRouter API key.

Auto-Transcription#

Any tweet with an embedded video is automatically:

1. Downloaded via yt-dlp
2. Transcribed via Deepgram
3. Transcript included in output and method classification

Requires a Deepgram API key (set during setup).

Output#

Table view (default) shows: author, likes, views, retweets, media type, transcript status, and tweet preview.

JSON view ( --json) outputs full structured data for piping to other tools.

Required Keys#

KeyRequired?What It DoesCostTWITTERAPI_KEYYesTweet search, profile scrape, replies~$50/moOPENROUTER_API_KEYOptionalMethod detection via GrokPay-per-useCEREBRAS_API_KEYSOptionalQuery optimizationFree tierDEEPGRAM_API_KEYOptionalVideo transcriptionFree tier