# X Research

General-purpose X/Twitter research agent.

- Repository: https://github.com/rohunvora/x-research-skill (1243 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-02-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rohunvora/x-research-skill --skill x-research -g -a claude-code -y`
Codex: `npx skills add rohunvora/x-research-skill --skill x-research -g -a codex -y`
Cursor: `npx skills add rohunvora/x-research-skill --skill x-research -g -a cursor -y`
Gemini CLI: `npx skills add rohunvora/x-research-skill --skill x-research -g -a gemini-cli -y`

## Description

General-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert opinions. Works like a web research agent but uses X as the source. Use when: (1) user says "x research", "search x for", "search twitter for", "what are people saying about", "what's twitter saying", "check x for", "x search", "/x-research", (2) user is working on something where recent X discourse would provide useful context (new library releases, API changes, product launches, cultural events, industry drama), (3) user wants to find what devs/experts/community thinks about a topic. NOT for: posting tweets or account management. Note: currently uses recent search (last 7 days). Full-archive search is available on the same pay-per-use X API plan but not yet implemented in this skill.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# X Research

General-purpose agentic research over X/Twitter. Decompose any research question into targeted searches, iteratively refine, follow threads, deep-dive linked content, and synthesize into a sourced briefing.

For X API details (endpoints, operators, response format): read `references/x-api.md`.

## CLI Tool

All commands run from this skill directory:

```bash
cd ~/clawd/skills/x-research
source ~/.config/env/global.env
```

### Search

```bash
bun run x-search.ts search "<query>" [options]
```

**Options:**
- `--sort likes|impressions|retweets|recent`, sort order (default: likes)
- `--since 1h|3h|12h|1d|7d`, time filter (default: last 7 days). Also accepts minutes (`30m`) or ISO timestamps.
- `--min-likes N`, filter by minimum likes
- `--min-impressions N`, filter by minimum impressions
- `--pages N`, pages to fetch, 1-5 (default: 1, 100 tweets/page)
- `--limit N`, max results to display (default: 15)
- `--quick`, quick mode: 1 page, max 10 results, auto noise filter (`-is:retweet -is:reply`), 1hr cache, cost summary
- `--from <username>`, shorthand for `from:username` in query
- `--quality`, filter low-engagement tweets (≥10 likes, post-hoc)
- `--no-replies`, exclude replies
- `--save`, save results to `~/clawd/drafts/x-research-{slug}-{date}.md`
- `--json`, raw JSON output
- `--markdown`, markdown output for research docs

Auto-adds `-is:retweet` unless query already includes it. All searches display estimated API cost.

**Examples:**
```bash
bun run x-search.ts search "BNKR" --sort likes --limit 10
bun run x-search.ts search "from:frankdegods" --sort recent
bun run x-search.ts search "(opus 4.6 OR claude) trading" --pages 2 --save
bun run x-search.ts search "$BNKR (revenue OR fees)" --min-likes 5
bun run x-search.ts search "BNKR" --quick
bun run x-search.ts search "BNKR" --from voidcider --quick
bun run x-search.ts search "AI agents" --quality --quick
```

### Profile

The rest: https://github.com/rohunvora/x-research-skill/blob/HEAD//SKILL.md