twitter-search — Claude Code skill: what it does, how to install
twitter-search searches tweets via twitterapi.io, retrieves up to 1000 posts, and compiles structured analytics. Useful for tracking trends, monitoring competitors, and audience research.
no license 136 installs ★ 675 updated 2026-03-07
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a claude-codeWhat twitter-search does
This skill connects agent workflows to Twitter search using https://twitterapi.io. Queries execute through the ./scripts/run_search.sh wrapper or directly via scripts/twitter_search.py. It accepts advanced search syntax including user filters (from:), engagement thresholds (min_retweets:), language restrictions, and verified account flags. Up to 1000 tweets can be gathered per query, sorted by relevance (Top) or chronological order (Latest).
Without an API key from https://twitterapi.io, the search scripts will not function. You provide this key via the TWITTER_API_KEY environment variable or with the --api-key parameter on execution.
Data returns as raw JSON or a formatted Markdown report. The generated report summarizes total likes and retweets, profiles prominent accounts by audience size, and embeds direct links to original posts.
What it helps with
- gather tweets using granular filters and engagement thresholds
- track user sentiment and reach around product announcements
- identify high-engagement accounts discussing a niche topic
- produce Markdown summaries with direct links to analyzed tweets
Example prompts for the agent
- Search for English tweets about artificial intelligence with at least 50 retweets and summarize the metrics
- Collect recent posts from target competitors using twitter-search and outline the main themes
- Fetch up to 200 tweets for Bitcoin since 2024-01-01 in json format
How to install twitter-search
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a claude-code2Manually: put the files in place
~/.claude/skills/twitter-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/twitter-search/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a codex2Manually: put the files in place
.agents/skills/twitter-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a cursor2Manually: put the files in place
.cursor/skills/twitter-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sundial-org/awesome-openclaw-skills skills/twitter-search2Manually: put the files in place
.github/skills/twitter-search/SKILL.md1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/sundial-org/awesome-openclaw-skills --path skills/twitter-searchManually: put the files in place
.devin/skills/twitter-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about twitter-search
How to install twitter-search in Claude Code?
Run npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a claude-code in your terminal.
What does twitter-search do?
It queries tweets matching keyword criteria, handles pagination up to 1000 results, and organizes the findings into an engagement report.
What credentials are required before running queries?
You need an active key from https://twitterapi.io. Export it as TWITTER_API_KEY in your shell configuration file.