ReddRadar
Agent skill
xactions-cli
Command-line interface for scraping X/Twitter data, managing MCP server config, and running automation. Scrapes profiles, followers, tweets, search results, and more from terminal. Outputs text, JSON, or CSV. Uses Puppeteer stealth. Use when running Twitter operations from command line or automated pipelines.
Install this agent skill to your Project
npx add-skill https://github.com/nirholas/XActions/tree/main/skills/xactions-cli
Metadata
Additional technical details for this skill
- author
- nichxbt
- version
- 4.0
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
nirholas/XActions
articles-longform
Compose, preview, publish, and manage long-form Articles on X/Twitter. Premium+ feature. Includes article creation, formatting, media insertion, and performance tracking. Use when users want to write, publish, manage, or analyze X Articles.
nirholas/XActions
x-pro-management
Navigate to X Pro (TweetDeck), set up monitoring columns, and manage multi-column view. Use when users want to use X Pro / TweetDeck features or set up a multi-column dashboard.
nirholas/XActions
business-ads
Manages X/Twitter business intelligence including brand monitoring, audience insights, competitor analysis, tweet A/B testing, auto-plug replies for promotion, and content performance optimization. Use when users want brand monitoring, audience analysis, competitor comparison, or promotion optimization on X.
nirholas/XActions
engagement-interaction
Automates X/Twitter engagement actions — like, unlike, reply, bookmark, hide replies, and auto-like by keyword. Also bulk-unlikes all posts. Use when users want to automate likes, send replies, manage bookmarks on tweets, hide replies, or clear their entire likes history.
nirholas/XActions
unfollow-management
Mass unfollow on X/Twitter via browser console scripts. Unfollows everyone, only non-followers, non-followers with username logging, smart time-based unfollow with whitelists, and follow/following ratio management. Use when cleaning up a following list, removing non-followers, bulk unfollowing accounts, or optimizing your follow ratio.
nirholas/XActions
follower-monitoring
Monitors X/Twitter follower changes using browser console scripts. Detects who unfollowed, tracks new followers with welcome messages, monitors any public account, runs continuous monitoring with alerts, tracks follower growth over time, and analyzes follower demographics. Use when tracking follower changes, detecting unfollowers, or monitoring Twitter accounts.
Didn't find tool you were looking for?