← all repositories
nirholas/XActions

Automating X from the terminal, browser, and Claude—no API keys

It scrapes X directly to power a CLI, browser scripts, and a 153-tool MCP server, letting AI agents and scripts automate the platform without API fees.

518 stars HTML Coding AssistantsAgents
XActions
Velocity · 7d
+2.3
★ / day
star history

What it does The project is a JavaScript toolkit for automating X without official API keys. It bundles a CLI with 56 commands, 95 browser console scripts that run as floating panels on x.com, and an MCP server advertising 153 tools for AI agents. Operations cover profile scraping, mass unfollows, tweet searches, bulk engagement, archive migration, and real-time event streaming.

The interesting bit XActions reverse-engineers X’s own web client rather than fighting rate limits. It discovers GraphQL query IDs from x.com’s JavaScript bundles, signs requests with the same x-client-transaction-id header the browser uses, and imports cookies straight from local Chrome or Firefox profiles. Long scrapes write cursor checkpoints to SQLite so a 50,000-follower crawl that crashes on page 400 resumes where it left off, and an optional approval gate holds every automated write as a draft until a human releases it.

Key highlights

  • 153 MCP tools expose X to AI agents via stdio or HTTP, with filterable groups and optional bearer auth for remote clients.
  • Browser console scripts like searchSweep.js and engageProfile.js bulk-delete replies, like entire profiles, or generate LLM replies from floating panels inside x.com.
  • The CLI checkpoints long scrapes to SQLite, rotates accounts through a pooled proxy system, and enforces daily action caps that survive crashes and restarts.
  • xactions archive ingests X’s official data export and can migrate posts to Bluesky or Mastodon, or rewrite them into JSON, CSV, and HTML.
  • Live event streaming reads x.com’s chunked JSON pipeline for engagement counters and DM updates, backed by HMAC-signed webhooks with retry logic.

Verdict If you need to automate X without API keys—whether from a terminal, browser console, or Claude Desktop—this is a comprehensive, if unofficial, toolkit. Those who prefer their integrations above-board and billed monthly should stick with X’s paid endpoints.

Frequently asked

What is nirholas/XActions?
It scrapes X directly to power a CLI, browser scripts, and a 153-tool MCP server, letting AI agents and scripts automate the platform without API fees.
Is XActions open source?
Yes — nirholas/XActions is open source, released under the Apache-2.0 license.
What language is XActions written in?
nirholas/XActions is primarily written in HTML.
How popular is XActions?
nirholas/XActions has 518 stars on GitHub.
Where can I find XActions?
nirholas/XActions is on GitHub at https://github.com/nirholas/XActions.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.