Bluesky Bulk Block List Importer

WHAT IT DOES

Bluesky Bulk Block List Importer solves a common moderation challenge: blocking multiple accounts on Bluesky is tedious when done one at a time. While Bluesky allows individual account blocking, there is no native way to import a block list of many accounts simultaneously. This tool lets you enter a list of usernames or DID addresses (comma-separated or line-separated) and uses Bluesky's API to block each account in bulk. For each username, the tool resolves the Decentralized Identifier (DID) and sends a block request to Bluesky's moderation service. The import progress is displayed in a scrollable checklist showing each handle, DID, and status (blocked, skipped, or error). A preview shows the accounts before blocking, and progress tracking shows each account as it's processed. Multiple confirmation dialogs prevent accidental imports, and you can export a report of all imported blocks as CSV or JSON.

WHERE IT RUNS

This extension panel runs directly inside your browser as an overlay on any Bluesky page (bsky.app). It works independently of any specific page content and requires no additional API keys beyond your existing authenticated session — the tool extracts your session token from the page. All operations are performed locally through Bluesky's public API.

HOW TO USE

After installing the BotGentz extension and activating Bluesky Bulk Block List Importer, navigate to any Bluesky page (you must be logged in). Click the extension icon in your browser toolbar to open the panel. Enter the usernames you want to block in the text area — you can separate them by commas or new lines. For example: "@example, @another-user, user3.bsky.social" or each on its own line. The preview section shows how many accounts you've entered. Toggle "Skip accounts already blocked" if you want to avoid duplicate blocks. Click "Import Block List" to begin the blocking process. Two confirmation dialogs appear to prevent accidental imports. The tool resolves each handle to a DID, then sends a block request to Bluesky's API. Results appear with color-coded status indicators: green for blocked, red for errors. Click "Export Report" to copy the complete block list report to your clipboard in CSV or JSON format. Click "Clear" to reset the panel.

TECHNICAL OPERATION — Bluesky API Handle Resolution and Blocking

This tool uses Bluesky's public API to perform handle resolution and account blocking. It first extracts the user's session from the page (accessJwt and DID) using regex on script tags, then stores it locally. For each username entered, the tool calls the `/xrpc/com.atproto.identity.resolveHandle` endpoint to resolve the handle to a DID. If resolution succeeds, the tool sends a POST request to `/xrpc/app.bsky.graph.block` with the DID and a timestamp. The tool supports skipping accounts that are already blocked (configurable). A 500ms delay between requests prevents rate limiting and API congestion. Results are stored locally and can be exported as CSV with proper field quoting for Excel compatibility, or as structured JSON. The tool includes multiple confirmation dialogs to prevent accidental bulk blocking operations.

THE PANEL

The extension panel is fully draggable and remembers its position per site session. It snaps to the nearest edge of the browser viewport when dragged within 50 pixels of any side. You can collapse the panel to a compact title bar using the minimize button, preserving your selection state. The panel resizes vertically by dragging the bottom edge. Press the Escape key to close the panel instantly. The preview updates in real-time as you enter usernames, and the results section updates as blocks complete.

PLEASE NOTE

This tool requires the free BotGentz extension to function. The script uses Bluesky's API and requires your session to be authenticated. It does not store, transmit, or log any account data, DID information, or user activity beyond the block list. All API requests are made locally from your browser session. The tool relies on extracting your session token from the page, which may expire if your session times out. Handle resolution may fail for invalid or non-existent usernames. Blocking is permanent but can be undone manually through Bluesky's interface. The tool uses a 500ms delay between requests to prevent rate limiting. Export formats include CSV and JSON for maximum compatibility with analysis tools. Multiple confirmation dialogs protect against accidental bulk blocking — please read them carefully before confirming.