$git clone https://github.com/nirholas/XActions<pre align="center"> ██╗ ██╗ █████╗ ██████╗████████╗██╗ ██████╗ ███╗ ██╗███████╗ ╚██╗██╔╝██╔══██╗██╔════╝╚══██╔══╝██║██╔═══██╗████╗ ██║██╔════╝ ╚███╔╝ ███████║██║ ██║ ██║██║ ██║██╔██╗ ██║███████╗ ██╔██╗ ██╔══██║██║ ██║ ██║██║ ██║██║╚██╗██║╚════██║ ██╔
| 1 | <div align="center"> |
| 2 | |
| 3 | <pre align="center"> |
| 4 | ██╗ ██╗ █████╗ ██████╗████████╗██╗ ██████╗ ███╗ ██╗███████╗ |
| 5 | ╚██╗██╔╝██╔══██╗██╔════╝╚══██╔══╝██║██╔═══██╗████╗ ██║██╔════╝ |
| 6 | ╚███╔╝ ███████║██║ ██║ ██║██║ ██║██╔██╗ ██║███████╗ |
| 7 | ██╔██╗ ██╔══██║██║ ██║ ██║██║ ██║██║╚██╗██║╚════██║ |
| 8 | ██╔╝ ██╗██║ ██║╚██████╗ ██║ ██║╚██████╔╝██║ ╚████║███████║ |
| 9 | ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚══════╝ |
| 10 | </pre> |
| 11 | |
| 12 | <p> |
| 13 | <img src=".github/xactions-ascii.svg" alt="XActions — The Complete X/Twitter Automation Toolkit" width="720"> |
| 14 | </p> |
| 15 | |
| 16 | <h3>The complete X/Twitter automation toolkit</h3> |
| 17 | |
| 18 | <p> |
| 19 | Scrapers · MCP Server for AI Agents · CLI · Browser Scripts · Browser Extension<br> |
| 20 | <strong>No API keys. No monthly fees. 100% open source.</strong> |
| 21 | </p> |
| 22 | |
| 23 | <p> |
| 24 | <a href="https://www.npmjs.com/package/xactions"><img src="https://img.shields.io/npm/v/xactions.svg?style=flat-square&color=cb3837&label=npm" alt="npm version"></a> |
| 25 | <a href="https://www.npmjs.com/package/xactions"><img src="https://img.shields.io/npm/dm/xactions.svg?style=flat-square&color=cb3837&label=downloads" alt="npm downloads"></a> |
| 26 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache_2.0-green?style=flat-square" alt="Apache 2.0 License"></a> |
| 27 | <a href="https://github.com/nirholas/xactions"><img src="https://img.shields.io/github/stars/nirholas/xactions?style=flat-square&color=f5c542&label=stars" alt="Stars"></a> |
| 28 | </p> |
| 29 | |
| 30 | <p> |
| 31 | <a href="docs/mcp-setup.md"><img src="https://img.shields.io/badge/MCP_Tools-140%2B-8B5CF6?style=flat-square&logo=data:image/svg+xml;base64,PHN2Zz48L3N2Zz4=" alt="140+ MCP Tools"></a> |
| 32 | <a href="https://smithery.ai/server/xactions"><img src="https://smithery.ai/badge/xactions" alt="Smithery"></a> |
| 33 | <a href="https://registry.modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP_Registry-deployed-6366f1?style=flat-square&logo=data:image/svg+xml;base64,PHN2Zz48L3N2Zz4=" alt="MCP Registry"></a> |
| 34 | <a href="Dockerfile"><img src="https://img.shields.io/badge/Docker-ready-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker"></a> |
| 35 | <a href="types/index.d.ts"><img src="https://img.shields.io/badge/TypeScript-types_included-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript"></a> |
| 36 | </p> |
| 37 | |
| 38 | <p> |
| 39 | <a href="https://x.com/nichxbt"><img src="https://img.shields.io/badge/follow-@nichxbt-000000?style=flat-square&logo=x&logoColor=white" alt="Follow @nichxbt"></a> |
| 40 | <a href="https://x.ai"><img src="https://img.shields.io/badge/built_with-Grok_🤖-1DA1F2?style=flat-square" alt="Built with Grok"></a> |
| 41 | </p> |
| 42 | |
| 43 | https://xactions.app |
| 44 | |
| 45 | <br> |
| 46 | |
| 47 | [**Website**](https://xactions.app) · [**npm**](https://www.npmjs.com/package/xactions) · [**Docs**](docs/getting-started.md) · [**MCP Server**](docs/mcp-setup.md) · [**Docker**](Dockerfile) · [**API Ref**](docs/api-reference.md) |
| 48 | |
| 49 | </div> |
| 50 | |
| 51 | --- |
| 52 | |
| 53 | <div align="center"> |
| 54 | |
| 55 | ### ⚡ See it in action |
| 56 | |
| 57 | <picture> |
| 58 | <source media="(prefers-color-scheme: dark)" srcset="public/demo.svg"> |
| 59 | <source media="(prefers-color-scheme: light)" srcset="public/demo.svg"> |
| 60 | <img alt="XActions CLI demo — profile lookup, tweet search, non-follower detection" src="public/demo.svg" width="720"> |
| 61 | </picture> |
| 62 | |
| 63 | <video src="https://raw.githubusercontent.com/nirholas/XActions/main/public/demo.mp4" controls width="720"></video> |
| 64 | |
| 65 | </div> |
| 66 | |
| 67 | --- |
| 68 | |
| 69 | ## 🏆 How XActions Compares |
| 70 | |
| 71 | > Why build with XActions instead of the alternatives? |
| 72 | |
| 73 | | Feature | **XActions** | twikit | twitter-mcp | agent-twitter-client | twit | twitter-scraper | |
| 74 | |---------|:---:|:---:|:---:|:---:|:---:|:---:| |
| 75 | | **No API Key Required** | ✅ | ✅ | ❌ Needs keys | ✅ | ❌ Needs keys | ✅ | |
| 76 | | **MCP Server (AI agents)** | ✅ **140+ tools** | ❌ | ✅ 2 tools | ❌ | ❌ | ❌ | |
| 77 | | **Browser Console Scripts** | ✅ 50+ | ❌ | ❌ | ❌ | ❌ | ❌ | |
| 78 | | **AI Voice Agent in Spaces** | ✅ Join, listen, speak | ❌ | ❌ | ❌ | ❌ | |