Twitter/X Bulk Block List Importer

WHAT IT DOES

This userscript helps you quickly build a block list for Twitter/X by extracting accounts from any webpage. It scans any webpage for text-based lists of usernames (with @handle format), email addresses, or numeric user IDs—from blocklists, CSV files, articles, or manual entry—displays the list with checkboxes, and allows you to select multiple accounts to import into your Twitter/X block list. It shows the source context of each account, filters by username pattern, and maintains a list of already imported accounts to avoid duplicates. It exports the list of selected accounts and provides a confirmation step before taking action. The script simulates the import action by copying the selected accounts to your clipboard so you can paste them into Twitter/X's block settings.

WHERE IT RUNS

The script works on any webpage with text-based account lists—blocklist pages, CSV exports, forums, articles, or any page with usernames, emails, or IDs. It runs entirely within your browser, reading only the visible content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All account data and import history are stored locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Click "Scan for accounts" to extract usernames, emails, and IDs from the current page. The panel displays a list of accounts with checkboxes, showing the account name, type (username/email/id), and source context. Select the accounts you want to import into your block list—use "Select All" to choose all. Click "Copy to Clipboard (for Twitter/X)" to copy the selected accounts to your clipboard. Then go to Twitter/X settings > Privacy and safety > Blocked accounts, and paste the list. Click "Export Selected" to download a text file with the selected accounts. Use "Clear History" to reset the import history.

THE TECHNICAL MECHANISM

This script uses regex pattern matching to extract accounts from page content. It scans for usernames using @[A-Za-z0-9_]{1,15} pattern, email addresses using standard email regex, and numeric IDs using \b\d{8,18}\b (filtering out dates). It also scans list elements (li, .item, [class*="list-item"], [class*="blocklist"]) to find accounts in structured lists. Each account is stored with its type (username, email, or id) and source context. Accounts are deduplicated by the account identifier. The script stores the import history in GM_setValue so you don't see already-imported accounts in future scans. The export function creates a plain text file with the selected accounts. The clipboard copy uses GM_setClipboard to copy the selected accounts as a newline-separated list. All operations are client-side and do not send any data externally.

THE PANEL

The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—import history and auto-scan preference—are persisted locally using GM_setValue, so your data remains intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script extracts accounts from page text—it may not capture all accounts correctly. The script helps you prepare a block list—it does not directly block accounts on Twitter/X. You'll need to paste the copied list into Twitter/X's block settings manually. The extraction relies on the current structure of the page—if the page uses a different format, the script may need to be updated. The script does not access your Twitter/X account or API; it only reads what is visible on the page. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.