A robust Node.js script for security researchers and penetration testers to analyze follower relationships and test block functionality on Bluesky Social. This tool allows you to block all followers of a specified user with built-in rate limiting, error handling, and detailed logging.
Watch your blocking progress in real-time with detailed statistics:
🚫 Blocked user: user.handle (did:plc:abcdefg...)
👤 Display Name: John Doe
📊 Progress: 1/150 (1%)
📊 Block Operation Statistics 📊
━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 Total Followers: 150
✅ Successful Blocks: 148
❌ Failed Blocks: 2
⏱️ Duration: 0h 2m 30s
⚡ Average Block Rate: 59 blocks/minute
✨ Success Rate: 99%
━━━━━━━━━━━━━━━━━━━━━━━━━━━
- Real-time Progress: Watch blocks happen live with usernames and DIDs
- Detailed Statistics: Track success rates, speed, and completion time
- User-friendly Output: Colorful console output with emojis and progress tracking
- Rate Limiting: Intelligent request throttling to prevent API abuse
- Error Handling: Comprehensive error catching and retry mechanisms
- Pagination Support: Handles large follower lists efficiently
- Environment Configuration: Secure credential management via dotenv
- Node.js (v14+ recommended)
- npm or yarn package manager
- Bluesky account
- Valid authorization for security testing
- Clone the repository:
git clone https://github.com/random-robbie/bluesky-block-bot.git
cd bluesky-block-bot- Install dependencies:
npm install @atproto/api dotenv pino pino-pretty chalk- Create a
.envfile in the project root:
BLUESKY_USERNAME=your.username
BLUESKY_PASSWORD=your_passwordRun the script with a target username:
node blocker.js target.usernameThe tool provides rich, colorful output with various indicators:
- 🚫 Block operations
- 👤 User information
- 📊 Progress updates
- ✅ Successful operations
- ❌ Failed operations
⚠️ Warnings and retries- 🎯 Target information
Adjust these constants in the script for custom behavior:
const RATE_LIMIT_DELAY = 1000 // Delay between requests (ms)
const MAX_RETRIES = 3 // Maximum retry attemptsThe tool uses both Pino for file logging and Chalk for beautiful console output:
- Structured log files for audit trails
- Colorful console output for real-time monitoring
- Detailed progress and statistics
- Error and warning highlighting
The script handles various error scenarios with visual indicators:
- ❌ Network connectivity issues
⚠️ API rate limiting- ❌ Authentication failures
⚠️ Invalid usernames- ❌ Failed block operations
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to your branch
- Open a Pull Request
Report bugs by opening an issue. Include:
- Detailed description
- Steps to reproduce
- Expected vs actual behavior
- Console output and logs
MIT License - See LICENSE file for details
This tool is provided for legitimate security research only. Users are responsible for:
- Obtaining proper authorization
- Complying with applicable laws
- Following responsible disclosure practices
- Adhering to Bluesky's Terms of Service
The author(s) assume no liability for misuse or damages arising from tool usage.
For support:
- Check existing issues
- Review documentation
- Open a new issue
- Contact maintainers
- AT Protocol team for API documentation
- Bluesky Social for platform access
- Community contributors
You get free $200 credit for 60 days if you sign up and add a payment method.
Made with ❤️ for the security research community