nirholas XActions CLI
Entry point: src/cli/index.js. Config stored at ~/.xactions/config.json.
Installation
npm install -g xactions
Authentication
xactions login # Interactive prompt for auth_token cookie
xactions logout # Removes saved cookie
xactions info # Show current auth status and config
Get your auth_token: DevTools (F12) -> Application -> Cookies -> x.com -> copy auth_token value.
Scraping Commands
xactions profile <username>
xactions followers <username> [-l <limit>] [-o json|csv]
xactions following <username> [-l <limit>] [-o json|csv]
xactions non-followers <username>
xactions tweets <username> [-l <limit>] [-o json|csv]
xactions search "<query>" [-l <limit>] [-o json|csv]
xactions hashtag <tag> [-l <limit>] [-o json|csv]
xactions thread <url>
xactions media <username> [-l <limit>]
MCP Server Commands
xactions mcp-config # Generate config for Claude Desktop
xactions mcp-config --client cursor # Generate for Cursor
xactions mcp-config --client windsurf # Generate for Windsurf
xactions mcp-config --client vscode # Generate for VS Code
xactions mcp-config --write # Write config directly to file
The mcp-config command auto-detects your OS and generates the correct config file path.
Output Flags
| Flag | Description |
|---|---|
-l, --limit <n> |
Maximum items to scrape |
-o, --output <format> |
json or csv — saves to {username}_{command}.{ext} |
Default output is pretty-printed to terminal with colored formatting.
Programmatic API
The CLI wraps the same scraper API available as a library:
import { createBrowser, createPage, loginWithCookie,
scrapeProfile, scrapeFollowers, scrapeFollowing, scrapeTweets,
searchTweets, scrapeHashtag, scrapeThread, scrapeMedia,
exportToJSON, exportToCSV } from 'xactions';
Examples
# Scrape a profile
xactions profile elonmusk
# Export followers as CSV
xactions followers nichxbt -l 200 -o csv
# Search tweets and save as JSON
xactions search "AI agents" -l 50 -o json
# Unroll a thread
xactions thread https://x.com/nichxbt/status/1234567890
# Generate Claude Desktop MCP config
xactions mcp-config --write
Troubleshooting
| Problem | Solution |
|---|---|
| "Not authenticated" | Run xactions login first |
| Browser won't launch | Install Chromium: npx puppeteer browsers install chrome |
| Scraping returns empty | Account may be private or auth_token expired |
| Command not found | Reinstall: npm install -g xactions |
| MCP config path wrong | Use --client flag to specify your IDE |
Related Skills
- twitter-scraping — Detailed scraper API documentation
- xactions-mcp-server — MCP server setup and tools