xactions-cli

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