🚫 Mass Block

Safety & Privacy

🚫 Mass Block

Block multiple accounts at once from a list or timeline. Protect your account from spam, bots, and unwanted interactions.


📋 What It Does

This script provides the following capabilities:

  1. Automated operation — Runs directly in your browser console on x.com
  2. Configurable settings — Customize behavior via the CONFIG object
  3. Real-time progress — Shows live status updates with emoji-coded logs
  4. Rate limiting — Built-in delays to respect X/Twitter's rate limits
  5. Data export — Results exported as JSON/CSV for further analysis

Use cases:

  • Block multiple accounts at once from a list or timeline. Protect your account from spam, bots, and unwanted interactions.
  • Automate repetitive safety tasks on X/Twitter
  • Save time with one-click automation — no API keys needed
  • Works in any modern browser (Chrome, Firefox, Edge, Safari)

⚠️ Important Notes

Use responsibly! All automation should respect X/Twitter's Terms of Service. Use conservative settings and include breaks between sessions.

  • This script runs in the browser DevTools console — not Node.js
  • You must be logged in to x.com for the script to work
  • Start with low limits and increase gradually
  • Include random delays between actions to appear human
  • Don't run multiple automation scripts simultaneously

🌐 Browser Console Usage

Steps:

  1. Go to x.com (any page)
  2. Open browser console (F12 → Console tab)
  3. Copy and paste the script from src/massBlock.js
  4. Press Enter to run
// Quick start — copy the full script from:
// src/massBlock.js
//
// Or install via npm and use the CLI:
// npm install -g xactions
// xactions --help

⚙️ Configuration

Setting Default Description
mode 'list', 'list'
usersToBlock [ users To Block
whitelist [], Never block these (without @)
dryRun true, SET FALSE TO EXECUTE
actionDelay 3000 action Delay
navigationDelay 3500 navigation Delay
maxConsecutiveErrors 5 max Consecutive Errors
rateLimitCooldown 60000 rate Limit Cooldown
maxVisibleBlocks 100, Cap for 'visible' mode
scrollInVisibleMode true, Scroll for more users in visible mode
exportOnComplete true export On Complete

📖 Step-by-Step Tutorial

Step 1: Navigate to the right page

Open your browser and go to x.com (any page). Make sure you're logged in to your X/Twitter account.

Step 2: Open the browser console

  • Chrome/Edge: Press F12 or Ctrl+Shift+J (Mac: Cmd+Option+J)
  • Firefox: Press F12 or Ctrl+Shift+K
  • Safari: Enable Developer menu in Preferences → Advanced, then press Cmd+Option+C

Step 3: Paste the script

Copy the entire script from src/massBlock.js and paste it into the console.

Step 4: Customize the CONFIG (optional)

Before running, you can modify the CONFIG object at the top of the script to adjust behavior:

const CONFIG = {
  // Edit these values before running
  // See Configuration table above for all options
};

Step 5: Run and monitor

Press Enter to run the script. Watch the console for real-time progress logs:

  • ✅ Green messages = success
  • 🔄 Blue messages = in progress
  • ⚠️ Yellow messages = warnings
  • ❌ Red messages = errors

Step 6: Export results

Most scripts automatically download results as JSON/CSV when complete. Check your Downloads folder.


🖥️ CLI Usage

You can also run this via the XActions CLI:

# Install XActions globally
npm install -g xactions

# Run via CLI
xactions --help

🤖 MCP Server Usage

Use with AI agents (Claude, Cursor, etc.) via the MCP server:

# Start MCP server
npm run mcp

See the MCP Setup Guide for integration with Claude Desktop, Cursor, and other AI tools.


📁 Source Files

File Description
src/massBlock.js Main script

🔗 Related Scripts

Script Description
Manage Muted Words Bulk add, remove, and manage muted words and phrases
Mass Unblock Unblock all or selected users from your block list
Mute by Keywords Mute users whose posts contain specific keywords

Author: nich (@nichxbt) — XActions on GitHub

⚡ Ready to try Mass Block?

XActions is 100% free and open-source. No API keys, no fees, no signup.

Browse All Scripts