XActions documentation

Tutorial 01 — Your first scrape By the end of this you will have pulled real data off X from a terminal and from a Node.js program, and you will understand the one distinction that explains most… 3 min read Tutorial 02 — Claude that can use X MCP (Model Context Protocol) is how AI assistants call external tools. 4 min read Tutorial 03 — Clean up your following list The job XActions is best known for: find the accounts you follow that do not follow you back, and unfollow the ones you actually want gone. 3 min read Tutorial 04 — Build a brand monitor Build a service that watches X for mentions of a term, scores each one for sentiment, and posts an alert when something negative appears. 3 min read 05: Read any account like an analyst Everything in this tutorial runs on the guest tier. You never log in. 4 min read 06: Everything is JSON XActions prints a formatted report because that is what you want when you are looking at it. Add --json and it prints data instead, and stdout carries nothing else. 3 min read

XActions v3.5.0 — Complete Feature Inventory Generated by deep codebase analysis. For tutorial creation. 21 min read XActions Growth Strategy: 76 → 100,000 Stars For context, repos with 100k+ stars: freeCodeCamp, vue, react, tensorflow, bootstrap. 5 min read A2A API Reference — XActions Complete HTTP API reference for the XActions A2A server. 2 min read A2A Protocol — XActions Google's Agent-to-Agent (A2A) protocol implementation for XActions, enabling inter-agent communication, task delegation, and multi-agent orchestration. 1 min read Thought Leader Agent — Advanced Features Content Calendar, Multi-Account support, Engagement Network, and dashboard monitoring. 4 min read Thought Leader Agent — API Reference REST API for monitoring, controlling, and configuring the autonomous agent. 3 min read Thought Leader Agent — Architecture Deep dive into every module, how they compose together, and design decisions. 6 min read Thought Leader Agent — Configuration Reference Every configuration option for the agent, with defaults and examples. 6 min read Thought Leader Agent — Getting Started 24/7 autonomous X/Twitter growth agent powered by LLMs. No API fees. Open source. 4 min read Thought Leader Agent System 24/7 LLM-powered autonomous agent for X/Twitter thought leadership growth. Runs headless with Puppeteer, generates content with LLMs, and behaves like a real human. 7 min read Thought Leader Agent Autonomous AI agent that grows your X/Twitter account 24/7 — LLM-powered content creation, human-like engagement, circadian scheduling, anti-detection, and multi-… 7 min read XActions AI API Documentation Free & open-source API for AI agents. Use locally with Puppeteer (free, no limits) or self-host the remote API with optional x402 micropayments. 5 min read Algorithm Builder — 24/7 Niche Growth Automation Train your X algorithm around specific topics by mimicking natural human behavior — with optional LLM-powered comments. 4 min read Analytics & Sentiment Analysis Built-in sentiment analysis, reputation monitoring, audience insights, price correlation, and automated reporting — all without external APIs. 3 min read Sentiment Analysis & Reputation Monitoring Real-time sentiment analysis, reputation monitoring, alerting, and reporting for X/Twitter — no API fees. 4 min read XActions — API Reference Complete function reference for the xactions npm package. 3 min read Architecture XActions v3.5.0 — System architecture, project structure, and design decisions. 3 min read Ask XActions Ask how to do anything with XActions in plain language and get a sourced answer. Live at xactions.app/ask. Free, no account, no API key. 5 min read Audience Overlap Analysis Find shared followers between accounts, rank audience similarity, and discover niche communities. Competes with SparkToro and Audiense. 2 min read XActions Automation Framework Guide A complete browser automation toolkit for X (Twitter) growth and engagement. 25 min read Browser Extension Chrome/Edge extension for XActions. Run automation directly from the browser toolbar — no DevTools console needed. 2 min read Browser Scripts The zero-install surface. Copy a script, paste it into your browser's DevTools console on x.com, and it runs against the page you already have open, using the ses… 10 min read Bulk Operations CSV/JSON/TXT import for batch follow, unfollow, block, mute, DM, and scrape — with safety caps, retries, and resume. Competes with Phantombuster and Circleboom. 3 min read XActions CLI Reference The Complete X/Twitter Automation Toolkit 32 min read Configuration XActions is configured in four places, and which ones you need depends entirely on which surface you use. 4 min read Content Calendar Visual drag-and-drop content calendar for planning, scheduling, and managing posts. Competes with Hypefury, Buffer, and Hootsuite. 1 min read Control Panel — Browser Automation UI A floating, draggable control panel for running XActions automations directly on x.com — no terminal needed. 3 min read The Complete Guide to Cryptocurrency APIs in 2026 A cryptocurrency API (Application Programming Interface) is a bridge between your application and live blockchain or market data. 6 min read Dashboard XActions includes a web dashboard with 30+ pages for managing automations, analytics, and tools — all with a dark theme matching X/Twitter's UI. 4 min read Database Schema and the browser console scripts all run with no database at all. 3 min read Deployment Guide Deploy XActions anywhere — Cloudflare, Railway, Fly.io, Render, Docker, or self-host. All free tiers supported. 6 min read X/Twitter DOM Selector Reference Last verified: February 2026. Twitter frequently changes their DOM — always verify selectors before use. 18 min read Engage a whole profile: like, repost, and reply to every post Sweep an account's entire timeline in one go, from the browser console or the terminal, with replies written by you or by an LLM from a one-line brief. 7 min read Engagement Booster — Smart Tweet Engagement Systematically engage with tweets from target accounts using smart scoring, speed presets, drip scheduling, and undo rollback — no API fees. 3 min read Evergreen Content Recycler Identify top-performing tweets and automatically re-post them on a schedule with content variation. Competes with Hypefury and Publer. 2 min read Examples Copy-paste snippets for the four ways to use XActions. For complete programs you can run and edit, see examples/ — eight of them, each verified against the live API. 1 min read XActions Extension — Internal API Reference Technical documentation of the extension's message protocol, storage schema, service worker API, and event lifecycle. 5 min read XActions Extension — User Guide Complete guide to installing and using the XActions browser extension for X/Twitter automation. 14 min read Follower CRM Tag, score, segment, and manage followers as contacts — a full customer relationship manager for X/Twitter. Competes with Audiense and Hypefury. 3 min read Getting Started with XActions XActions is the complete X/Twitter automation toolkit. Browser scripts, CLI, Node.js library, MCP server for AI agents, and a web dashboard — all without Twitter… 4 min read Social Graph System Build, analyze, and visualize social network graphs from X/Twitter follower relationships. 3 min read Social Graph — Network Analysis & Visualization Map your X/Twitter social network, analyze influence, find clusters, and get actionable follow/engage recommendations — no API fees. 3 min read History Store & Auto-Snapshots Time-series account metrics — track followers, engagement, and growth over days, weeks, or months. Competes with Circleboom and SocialBlade. 3 min read XActions MCP Server Setup Guide Use AI agents (Claude, Cursor, Windsurf, GPT) to automate X/Twitter — for free. 10 min read Monitoring Guide Track followers, unfollowers, and account activity on X (Twitter). 3 min read Notifications Multi-channel notification hub for XActions alerts. Send notifications via Email, Slack, Discord, and Telegram when events occur — follower changes, workflow comp… 2 min read Plugin System Extend XActions with community plugins — add scrapers, MCP tools, automation actions, and API routes via npm packages. 3 min read Account Portability — Export, Migrate & Diff Export your full X/Twitter account, migrate to Bluesky/Mastodon, and track changes over time — no API fees. 4 min read Tweet-Price Correlation Analyze how crypto founder tweets correlate with token price movements. Interactive candlestick charts with tweet markers, impact statistics, and CSV export. 2 min read XActions REST API Reference Complete reference for the XActions Express.js API server. 175+ endpoints for Twitter automation, scraping, analytics, AI agents, and more. 4 min read Rss Monitor Rss Monitor — XActions documentation 1 min read ⏰ Scheduler & Webhook Triggers Cron-based task scheduling with job history, retries, templates, and external webhook triggers. Competes with Hypefury, Buffer, and Zapier. 2 min read Task Scheduling Cron-based local task scheduler for automating XActions operations on a recurring basis. Replaces cloud scheduling services like Phantombuster or Apify schedules. 1 min read Scrapers Multi-platform, multi-framework scraping system. Supports Twitter/X, Bluesky, Threads, and Mastodon with pluggable browser backends. 5 min read Scraping Infrastructure Enterprise-grade scraping toolkit: proxy rotation, stealth browser, pagination engine, retry policies, and dataset storage — replaces Phantombuster, Apify, and si… 7 min read Scraping Infrastructure Low-level scraping modules for anti-detection browsing, smart pagination with resume, and proxy rotation. 2 min read Skills Reference do one job with XActions. Each is a markdown file with YAML frontmatter, written for a model to read rather than a human: it names the scripts to run, the page to… 7 min read Social Graph Map and analyze X/Twitter social networks. Build graphs from seed accounts, detect clusters, find mutual connections, identify influencers, and get actionable fol… 2 min read Autonomous Space Agent Let AI agents join, listen, and speak in X/Twitter Spaces — powered by voice AI. 5 min read Stealth Scraping & Proxy Rotation Anti-detection browser automation with proxy rotation and fingerprint randomization. Competes with Apify anti-bot evasion. 2 min read Real-Time Streaming Subscribe to live tweet, follower, and mention events via polling + Socket.IO. No API keys needed. 3 min read Real-time Streams — Live Twitter Monitoring Monitor tweets, followers, and mentions in real-time with persistent polling, deduplication, and live Socket.IO events. 2 min read Team Management Create teams, invite members, assign roles with granular permissions, and track activity across shared XActions workspaces. 1 min read Troubleshooting Symptoms in the left column, causes and fixes below. If your problem is not here, open an issue with the command you ran and its full output. 6 min read Usage Usage — XActions documentation 1 min read Video Downloader XActions v3.5.0 — Download videos from X/Twitter tweets. 3 min read Video Generation Generate promotional and content videos from X/Twitter data using Remotion. 1 min read Video Engine — Programmatic Video Generation Generate animated tweet cards, thread previews, analytics dashboards, and promo videos using Remotion. 2 min read Workflow Engine Declarative JSON pipelines with triggers, conditions, and chained actions. Automate multi-step Twitter operations without code. 3 min read X Developer API in 2026: The Complete Guide for Crypto Builders X (formerly Twitter) remains the nerve center of crypto discourse. 6 min read XActions Complete Function Reference Every function with real, working examples. 4 min read

XActions Actions Library Reference (`actions.js`) The complete X/Twitter actions library — 2,100+ lines, 12 namespaces, 100+ functions covering every available user action. 6 min read Advanced Automation Techniques Chaining scripts, persistent workflows, debugging strategies, and power-user patterns. 4 min read XActions Core Module Reference (`core.js`) The foundation of every XActions browser automation. Always paste this first. 5 min read Getting Started with Browser Automation A step-by-step tutorial to run your first XActions automation in the browser console. 3 min read XActions Automation Scripts — Complete Reference Every automation script in src/automation/, explained with config options, usage, and examples. 7 min read

Skill: A2A Multi-Agent Orchestration Turn XActions into an A2A-compatible agent that can discover, communicate with, and delegate tasks to other AI agents using Google's Agent-to-Agent protocol. 2 min read Account Backup & Data Export Browser console scripts for exporting your X/Twitter account data without an API key. 1 min read Account Tools (Miscellaneous) Browser console scripts for account utility tasks on X/Twitter. 1 min read Algorithm Cultivation & Thought Leadership Train your X/Twitter algorithm for a specific niche. Three approaches: 3 min read Analytics & Insights Browser console scripts for analyzing X/Twitter performance — no API key needed. All analysis runs in DevTools console. 3 min read Articles & Longform Browser console scripts for creating and managing X/Twitter Articles (Premium+ feature). 2 min read Billing Management Stripe-powered subscription and billing management for XActions. 1 min read Blocking & Muting Management Browser console scripts for blocking, unblocking, muting, and managing unwanted accounts on X/Twitter. 2 min read Bookmarks Management Browser console scripts for managing, organizing, exporting, and clearing X/Twitter bookmarks. 2 min read Business & Ads Tools Browser console scripts and automation for X/Twitter business intelligence and promotion. 1 min read Community Health Monitoring MCP-powered workflow for auditing follower quality, engagement health, and network efficiency. Produces a scored health report. 2 min read Community Management Browser console scripts for managing X/Twitter Communities — leaving, joining, and interacting. 3 min read Community Notes Browser console script for interacting with X's Community Notes fact-checking system. 1 min read Competitor Intelligence MCP-powered workflow plus browser scripts for analyzing competitor X/Twitter accounts. 1 min read Content Cleanup with XActions Browser console scripts for mass-cleaning your X/Twitter account history. 1 min read Content Posting Browser console scripts for automating content creation and publishing on X/Twitter. 2 min read Content Repurposing Browser scripts and MCP workflows for identifying top content and generating repurposed variations. 2 min read Creator Monetization Browser console scripts for managing and analyzing X/Twitter creator monetization features. 2 min read CRM Management API-powered CRM system for managing relationships with your X followers and contacts. 1 min read Delegate Access Management Browser console script for managing who can post on behalf of your X account. 1 min read Direct Messages Browser console scripts for sending, managing, and exporting X/Twitter DMs. 1 min read Discovery & Explore Browser console scripts and MCP tools for exploring trends, searching content, and discovering accounts on X/Twitter. 2 min read Engagement & Interaction Browser automation for X/Twitter engagement — liking, replying, bookmarking, hiding replies, and bulk unlike. 3 min read Follower Monitoring Browser console scripts for tracking follower changes on X/Twitter. All scripts use localStorage for persistent snapshot comparison. 2 min read Graph Analysis API-powered network graph analysis for X/Twitter follower relationships. 1 min read Grok AI Integration Browser console scripts for automating interactions with X's built-in Grok AI assistant. 2 min read Growth Automation Browser console scripts for X/Twitter. Always paste src/automation/core.js first -- it provides shared config, selectors, utilities, and rate limiting. 3 min read Lead Generation MCP-powered workflow for finding and qualifying B2B leads from X/Twitter conversations and profiles. 1 min read Lists Management Browser console script for creating and managing X/Twitter lists. 2 min read Media Studio Browser console scripts for X's Media Studio (studio.x.com). 1 min read Notifications Management Browser console script for managing and filtering X/Twitter notifications. 1 min read Post Editing & Undo Browser console script for editing existing posts or undoing a recently posted tweet. 1 min read Premium & Subscriptions Browser console script for checking and managing X/Twitter Premium subscription information. 2 min read Profile Management Browser console scripts for updating X/Twitter profile information. 2 min read Saved Searches Browser console scripts for managing saved searches on X/Twitter. 1 min read Settings & Privacy Browser console scripts for managing X/Twitter account settings and privacy controls. 2 min read Spaces & Live Audio Browser console scripts for interacting with X/Twitter Spaces. 2 min read Teams Management API-powered team management for collaborative XActions usage. 1 min read Timeline Viewing & Scraping Browser console scripts for viewing, switching, and collecting posts from your X timeline. 1 min read Topic Management Browser console script for managing X Topics — the interest categories that personalize your timeline. 1 min read Twitter Scraping All scrapers require an auth_token cookie from x.com (DevTools -> Application -> Cookies -> copy auth_token value). 2 min read Unfollow Management Browser console scripts for managing who you follow on X/Twitter. All scripts run in DevTools console. 2 min read Video Downloading Download videos and GIFs from X/Twitter posts — no API key needed. 1 min read Viral Thread Generation MCP-powered workflow for researching trends, analyzing successful threads, and generating high-engagement thread content. 2 min read Webhooks API-powered webhook system for receiving real-time event notifications from XActions. 1 min read X Pro (TweetDeck) Management Browser console scripts for navigating and configuring X Pro (formerly TweetDeck). 1 min read x402 Payments XActions supports the x402 payment protocol — an HTTP-native micropayment standard for pay-per-use API access with cryptocurrency. 1 min read XActions CLI Entry point: src/cli/index.js. Config stored at ~/.xactions/config.json. 1 min read XActions MCP Server The definitive free Twitter/X MCP server. 150 tools for AI agents. 1 min read

Tutorial: Setting Up XActions MCP Server with Claude You are helping me set up the XActions MCP server so I can control my X/Twitter account directly from this Claude chat. 3 min read Tutorial: Unfollow Non-Followers & Follower Cleanup with Claude You are my X/Twitter account manager. I want to clean up my following list using XActions. 4 min read Tutorial: Growth Automation Suite — Grow Your X Account on Autopilot You are my X/Twitter growth strategist and automation expert. I want to grow my account strategically using XActions. 4 min read Tutorial: Tweet Scraping, Profile Analysis & Research with Claude You are my X/Twitter research analyst. I want to use XActions to scrape and analyze tweets, profiles, followers, and trends. 5 min read Tutorial: Content Posting, Threads, Polls & Scheduling with Claude You are my X/Twitter content manager and ghostwriter. I want to use XActions to compose, schedule, and publish content — including tweets, threads, polls, and eve… 5 min read Tutorial: Engagement Analytics, Best Time to Post & Competitor Intelligence You are my X/Twitter analytics expert. I want to use XActions to measure my performance, find the best times to post, analyze competitors, and make data-driven de… 5 min read Tutorial: Auto-Liker & Auto-Commenter — Engagement Automation with Claude You are my X/Twitter engagement automation specialist. I want to use XActions to automatically like and comment on relevant content to boost my visibility and bui… 5 min read Tutorial: Mass Block, Unblock, Mute & Spam Protection with Claude You are my X/Twitter safety and moderation expert. I want to use XActions to block bots, mute noisy accounts, manage muted words, report spam, and keep my timelin… 5 min read Tutorial: DM Management, Export & Automation with Claude You are my X/Twitter DM management specialist. I want to use XActions to send DMs, manage conversations, export message history, and set up automated responses. 4 min read Tutorial: Community Management, Lists & Spaces with Claude You are my X/Twitter community management expert. I want to use XActions to manage my X communities, organize my following with lists, and discover Twitter Spaces. 4 min read Tutorial: Profile Management, Backup & Account Settings with Claude You are my X/Twitter profile optimization specialist. I want to use XActions to update my profile, back up my account data, manage settings, and optimize my prese… 5 min read Tutorial: Bookmark Management, Export & Organization with Claude You are my X/Twitter bookmark specialist. I want to use XActions to manage my bookmarks — export them, organize them, clear old ones, and build a personal knowled… 3 min read Tutorial: Content Cleanup — Unlike All, Clear Reposts, Delete Tweets with Claude You are my X/Twitter content cleanup specialist. I want to use XActions to clean up my account — unlike all posts, clear all reposts, delete old tweets, and start… 4 min read Tutorial: Brand Monitoring, Business Tools & Customer Service with Claude You are my X/Twitter business strategist. I want to use XActions to monitor my brand, analyze sentiment, compare competitors, manage customer service, and use X a… 5 min read Tutorial: XActions CLI Mastery — Command Line Power User Guide You are my CLI tool expert. I want to master the XActions command-line interface for maximum productivity. 2 min read Tutorial: The Complete XActions Browser Automation Framework You are my browser automation expert. I want to master the XActions automation framework — the core.js module, the actions.js library, and every automation script. 6 min read Tutorial: Video Downloading, Thread Unrolling & Media Export with Claude You are my X/Twitter media specialist. I want to use XActions to download videos, unroll threads into readable content, export media, and build a content archive. 4 min read Tutorial: Grok AI Integration & Sentiment Analysis with Claude You are my AI-powered X/Twitter intelligence analyst. I want to use XActions' Grok AI integration and sentiment analysis tools to analyze content, monitor brand r… 4 min read Tutorial: Customer Service Bot with Claude You are my X/Twitter customer service automation expert. I want to use XActions' customer service bot to automate responses to mentions, handle inquiries, and pro… 3 min read Tutorial: Session Logging, Quota Tracking & Safety with Claude You are my X/Twitter automation safety expert. I want to use XActions' session logging and quota management tools to track all my automation activity, stay within… 4 min read Tutorial: Workflow Automation & Account Portability with Claude You are my X/Twitter workflow architect. I want to use XActions' workflow engine to create automated pipelines, and use account portability tools to export/migrat… 3 min read Tutorial: Advanced Multi-Feature Combos & Power User Playbook You are my X/Twitter power user coach. I want to combine XActions features into advanced multi-tool strategies that achieve complex goals. 2 min read Tutorial: Autonomous AI Voice Agent in X Spaces with Claude You are my X/Twitter Spaces voice agent expert. I want to use XActions to deploy AI agents that can autonomously join live X Spaces, listen to conversations, and… 6 min read

Agent Troubleshooting Guide Common issues agents encounter when working on XActions and how to resolve them. 3 min read Browser Script Patterns XActions browser scripts run in DevTools console on x.com. They are NOT Node.js scripts. 1 min read Adding New Features 1. Create the script in src/ following browser-script-patterns.md 2. Add documentation in docs/examples/your-feature.md 3. 1 min read X/Twitter DOM Selectors Reference Verified January 2026. X/Twitter frequently changes DOM. Test selectors before relying on them. 3 min read

HTTP-Based Scraper — Architecture & Implementation Plan Track: 01 — HTTP-Based Scraper 15 min read

Algorithmic Feed Cultivation: A Technical Research Paper on Automated Thought Leadership via Platform Signal Training Authors: nichxbt & contributors 18 min read 24/7 LLM-Powered Thought Leadership Agent — Architecture & Implementation Guide How to run automated algorithm cultivation and content creation continuously with AI intelligence. 3 min read

Robust DOM Extraction: A Case Study in Browser Automation Resilience XActions automates X/Twitter through browser-level DOM interaction — no paid API required. 8 min read

Algorithm Internals & Architecture ┌─────────────────────────────────────────────────┐ │ CLI: xactions persona run │ ├─────────────────────────────────────────────────┤ │ Persona Engine (personaEng… 1 min read Browser Scripts Reference Three browser console scripts for algorithm cultivation, with different trade-offs. 2 min read Persona Engine Reference The Persona Engine defines a complete identity for algorithm building. 1 min read Analytics Script Configs Scrolls your profile and analyzes engagement metrics across your recent posts. 2 min read Blocking & Muting Script Details Scans your followers list and blocks accounts matching bot heuristics. 1 min read Content Posting Script Configs Compose and post a connected thread of tweets. 1 min read Supporting Automation Scripts All require src/automation/core.js pasted first. 1 min read Scraper Details Full setup for programmatic scraping: 2 min read Unfollow Management — Script Details Detailed algorithms, controls, and configurations for each unfollow script. 2 min read

XActions Browser Extension Run XActions automations on X/Twitter directly from your browser toolbar. No console access needed. 3 min read n8n-nodes-xactions XActions community node for n8n — automate X/Twitter, Bluesky, Mastodon & Threads from n8n workflows. No API fees. 3 min read XActions Excel Plugin Export scraped X/Twitter data to styled Excel (.xlsx) files with auto-filters, frozen headers, and multi-sheet workbooks. 2 min read XActions Google Sheets Plugin Export scraped X/Twitter data directly to Google Sheets — no copy-paste, no CSV import. 2 min read xactions-plugin-example Example XActions plugin — use as a template for building your own. 1 min read Examples Runnable Node.js programs built on the XActions library. Every one of these runs against the live X, Bluesky, and Mastodon APIs, prints real data, and was verifie… 3 min read Chrome DevTools Console Scripts This folder contains ready-to-use scripts that you can copy-paste directly into Chrome DevTools Console to perform various automation tasks. 3 min read

Contributing to XActions Thank you for your interest in contributing to XActions — the complete X/Twitter automation platform! 2 min read Changelog All notable changes to this project will be documented in this file. 24 min read XActions Roadmap Building the ultimate X/Twitter automation toolkit 2 min read Security Policy XActions: ⚡ The Complete X/Twitter Automation Toolkit — Scrapers, MCP server for AI agents (Claude/GPT), CLI, browser scripts. No API fees. Open source. 1 min read Contributor Covenant Code of Conduct We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, vi… 1 min read Quick start ██╗ ██╗ █████╗ ██████╗████████╗██╗ ██████╗ ███╗ ██╗███████╗ ╚██╗██╔╝██╔══██╗██╔════╝╚══██╔══╝██║██╔═══██╗████╗ ██║██╔════╝ ╚███╔╝ ███████║██║ ██║ ██║██║ ██║██╔██╗… 19 min read

XActions v3.1.0 — Launch Content Ready-to-post content for X, Reddit, Hacker News, and Product Hunt. 5 min read