nirholas/XActions

npm install xactions
npm install -g xactions
npx xactions-mcp (MCP server via Claude Desktop config)
docker build -t xactions . && docker run -it xactions xactions profile elonmusk

Usage

• •Most public reads work with no account: xactions profile NASA, xactions tweets NASA --limit 100 --output nasa.csv
• •Log in once via xactions login / xactions connect (auth_token cookie from x.com) to unlock search, followers, DMs
• •MCP: add npx -y xactions-mcp with XACTIONS_SESSION_COOKIE env to Claude Desktop config, or generate with `npx xactions mcp-config --client claude|cursor|windsurf`
• •Live HTTP deployment at https://modelcontextprotocol.name/mcp/xactions (3 tools) via any MCP client

Key features

• ✓145 MCP tools across scraping, analysis, actions, automation, AI, monitoring, workflows, personas, Spaces, and graph categories
• ✓CLI with 50+ commands (profile, followers, tweets, search, non-followers, unfollow, monitoring); --json everywhere; tab completion
• ✓Node.js/TypeScript API: createBrowser, createPage, scrapeProfile, scrapeFollowers, scrapeTweets, searchTweets, downloadVideo, etc.
• ✓Autonomous Space Agent (xspace-agent) that joins live X Spaces, transcribes via Whisper, responds via OpenAI/Claude/Groq, speaks via TTS
• ✓Cross-platform scrapers (Bluesky, Mastodon, Threads), plugin system, workflow engine, offline sentiment analysis, account export/migration, Chrome/Firefox MV3 extension

Best for

Free X/Twitter scraping, growth automation, and account management without paying for the official X API.

Caveats

• ⚠Educational and research purposes only per disclaimer; use at your own risk; not responsible for account restrictions or bans
• ⚠Uses browser automation instead of the official API - must comply with X/Twitter Terms of Service; rate limiting cautions (go slow, avoid mass actions)
• ⚠Optional remote API (self-hosted) can enable pay-per-request micropayments via x402 protocol (e.g. $0.001/profile, $0.01/tweet search); local mode always free
• ⚠Some features (AI voice agent in Spaces, multi-account) not available on all interfaces