# twitter-search

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 136 installs · ★ 675 repo stars
- Author: sundial-org
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sundial-org/awesome-openclaw-skills/tree/HEAD/skills/twitter-search/SKILL.md
- Updated: 2026-03-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/twitter-search

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/twitter-search/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/twitter-search/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/twitter-search/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/twitter-search/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sundial-org/awesome-openclaw-skills skills/twitter-search
```

2. **Manually: put the files in place**
- File: `.github/skills/twitter-search/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sundial-org/awesome-openclaw-skills --path skills/twitter-search
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/twitter-search/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sundial-org/awesome-openclaw-skills --skill twitter-search -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sundial-org/awesome-openclaw-skills/tree/HEAD/skills/twitter-search/SKILL.md

## When to use it
- 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
- 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

## Similar
- [Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)](https://affpapa.org/en/nevibecode/mcp/social-media-search-api-twitter-instagram-reddit-tiktok-xpoz.md) — MCP server · ★ 13 repo stars
- [twitter](https://affpapa.org/en/nevibecode/skills/resciencelab-twitter.md) — skill · 2100 installs
- [X (Twitter)](https://affpapa.org/en/nevibecode/mcp/x-twitter.md) — MCP server · 2522 installs
- [Twitter/X Scraper — Profiles, Tweets & Search](https://affpapa.org/en/nevibecode/mcp/twitterx-scraper-profiles-tweets-search.md) — MCP server · 5492 installs
- [he4rt-twitter-engagement-tracker](https://affpapa.org/en/nevibecode/skills/he4rt-twitter-engagement-tracker.md) — skill · 876 installs
- [twitter-automation](https://affpapa.org/en/nevibecode/skills/twitter-automation.md) — skill · 1000000 installs

From the same set: [sundial-org/awesome-openclaw-skills](https://affpapa.org/en/nevibecode/by/sundial-org/awesome-openclaw-skills.md) — 37 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
