Agent skill · data analytics · sundial-org
twitter-search
Advanced Twitter search and social media data analysis. Fetches tweets by keywords using Twitter API, processes up to 1000 results, and generates professional data analysis reports with insights and actionable recommendations. Use when user requests Twitter/X social media search, social media trend analysis, tweet data mining, social listening, influencer identification, topic sentiment analysis from tweets, or any task involving gathering and analyzing Twitter data for insights.
Why this skill is useful
Provides advanced Twitter API commands and data analysis workflows that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. Requires twitter account access. About 5k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Twitter Search and Analysis Overview Search Twitter for keywords using advanced search syntax, fetch up to 1000 relevant tweets, and analyze the data to produce professional reports with insights, statistics, and actionable recommendations. Prerequisites API Key Required: Users must configure their Twitter API key from https://twitterapi.io The API key can be provided in three ways: 1. Environment variable (recommended): Set TWITTERAPIKEY in your ~/.bashrc or ~/.zshrc 2. As an argument: Use --api-key YOURKEY with the wrapper script 3. Passed directly: As first argument to the Python script Quick Start Using the Wrapper Script (Recommended) The wrapper script automatically handles environment variable loading and dependency checks: Direct Python Script Usage Advanced Queries Output Format Options --max-results N: Maximum tweets to fetch (default: 1000) --query-type Latest Top: Sort order (default: Top for relevance) --format json summary: Output format (default: summary) Workflow 1. Understand User Requirements Clarify the analysis goal: What topic/keyword to search? Date range preference? Specific users to include/exclude? Language preference? Type of insights needed (trends, sentiment, influencers)? 2. Build the Search Query Use Twitter Advanced Search syntax: Syntax Example Description -------- --------- ------------- keyword AI Single keyword "phrase" "machine learning" Exact phrase OR AI OR ChatGPT Either term from:user from:elonmusk From specific user to:user to:elonmusk Reply to user since:DATE since:2024-01-01 After date until:DATE until:2024-12-31 Before date lang:xx lang:en Language code #hashtag #AI Hashtag filter:links filter:links Tweets with links minretweets:N minretweets:100 Minimum retweets 3. Fetch Data Execute the search script: Important: Default is 1000 tweets maximum. The script automatically: Paginates through all available results Stops at 1000 tweets (API limit consideration) Handles errors gracefully 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/twitter-search