X Viral Topic

Use this skill to find X posts that significantly outperform the author's follower base.

Quick Start

Run the bundled script from this skill directory:

python3 scripts/search_x_viral_topic.py --topic "AI agent" --days 7 --max-followers 50000 --min-engagement 100 --limit 50 --format markdown

Required environment:

export TWITTERAPI_IO_KEY="..."

TWITTER_API_KEY is also accepted for compatibility with existing ai-trend-search workflows.