From xactions
CLI for scraping X/Twitter profiles, followers, tweets, searches, threads via Puppeteer stealth. Generates MCP configs for Claude Desktop, Cursor, VSCode. Outputs JSON/CSV for pipelines.
npx claudepluginhub nirholas/xactionsThis skill uses the workspace's default tool permissions.
Entry point: `src/cli/index.js`. Config stored at `~/.xactions/config.json`.
Provides 68+ MCP tools for AI agents to automate X/Twitter: scrape profiles/followers/tweets, post/like/retweet/reply, analyze sentiment/reputation, manage DMs/workflows. Uses Puppeteer; no API keys needed.
Automates X (Twitter) interactions—post tweets, like, reply, retweet, quote—via Playwright browser automation in ClaudeClaw. Useful for setup, testing, troubleshooting Twitter functionality.
Extracts and monitors X (Twitter) data via Xquik: tweet/user search, followers, replies/quotes, trends, communities, Spaces, follow checks, account webhooks. 22 MCP tools + REST API.
Share bugs, ideas, or general feedback.
Entry point: src/cli/index.js. Config stored at ~/.xactions/config.json.
npm install -g xactions
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.
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>]
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.
| 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.
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';
# 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
| 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 |