X Research Skill

x-research

X/Twitter research agent for [Claude Code](https://code.claude.com) and [OpenClaw](https://openclaw.ai). Search, filter, monitor — all from the terminal.

What it does

Wraps the X API into a fast CLI so your AI agent (or you) can search tweets, pull threads, monitor accounts, and get sourced research without writing curl commands.

• Search with engagement sorting, time filtering, noise removal
• Quick mode for cheap, targeted lookups
• Watchlists for monitoring accounts
• Cache to avoid repeat API charges
• Cost transparency — every search shows what it cost

Install

Claude Code

# From your project
mkdir -p .claude/skills
cd .claude/skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

OpenClaw

# From your workspace
mkdir -p skills
cd skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

Setup

1. X API Bearer Token — Get one from the X Developer Portal
2. Set the env var:

   export X_BEARER_TOKEN="your-token-here"

   Or save it to ~/.config/env/global.env:

   X_BEARER_TOKEN=your-token-here

3. Install Bun (for CLI tooling): https://bun.sh

Usage

Natural language (just talk to Claude)

• "What are people saying about Opus 4.6?"
• "Search X for OpenClaw skills"
• "What's CT saying about BNKR today?"
• "Check what @frankdegods posted recently"

CLI commands

cd skills/x-research

# Search (sorted by likes, auto-filters retweets)
bun run x-search.ts search "your query" --sort likes --limit 10

# Profile — recent tweets from a user
bun run x-search.ts profile username

# Thread — full conversation
bun run x-search.ts thread TWEET_ID

# Single tweet
bun run x-search.ts tweet TWEET_ID

# Watchlist
bun run x-search.ts watchlist add username "optional note"
bun run x-search.ts watchlist check

# Save research to file

...