Octocord - Discord ID Scraper

  ____       _                          _ 
 / __ \     | |                        | |
| |  | | ___| |_ ___   ___ ___  _ __ __| |
| |  | |/ __| __/ _ \ / __/ _ \| '__/ _` |
| |__| | (__| || (_) | (_| (_) | | | (_| |
 \____/ \___|\__\___/ \___\___/|_|  \__,_|

A fast, optimized Discord ID scraper that extracts online member IDs from Discord servers using browser automation.

Features

• 🔄 Endless Mode: Runs continuously until all members are scraped
• ⚡ Optimized Performance: Headless browser with image blocking for maximum speed
• 🛑 Manual Control: Stop anytime by typing "e" in terminal
• 🔍 Duplicate Prevention: Advanced checking ensures no duplicate IDs
• 📁 Organized Output: All results saved to dedicated outputs folder
• 🎯 ID-Only Focus: Extracts only Discord user IDs for efficiency

Project Structure

Octocord/
├── id-only-scraper.js   # Main scraper application
├── config.js            # Configuration management
├── package.json         # Dependencies and scripts
├── .env.example         # Environment variables template
├── outputs/             # All scraper results
├── archive/             # Old/unused files
└── README.md           # This file

Setup Instructions

1. Prerequisites

• Node.js (v16 or higher)
• A Discord Bot Token
• Discord Developer Application

2. Discord User Token Setup

⚠️ WARNING: This scraper uses Discord user tokens, which violates Discord's Terms of Service. Use at your own risk.

1. Open Discord in your browser
2. Open Developer Tools (F12)
3. Go to Application/Storage → Local Storage → discord.com
4. Find the "token" key and copy its value (remove quotes)
5. Get the Server ID and Channel ID from Discord URLs

3. Installation

1. Clone this repository:

   git clone https://github.com/elioflex/Octocord.git
   cd Octocord

2. Install dependencies:

   npm install

3. Create environment file:

   cp .env.example .env

4. Edit .env file and add your configuration:

   BOT_TOKEN=your_discord_user_token_here
   DEFAULT_SERVER_ID=your_server_id_here
   DEFAULT_CHANNEL_ID=your_channel_id_here

Usage

Running the Scraper

npm run ids-only

Interactive Commands

While the scraper is running, you can use these commands:

• e - Stop the scraping process
• status - Show current progress
• help - Show available commands

Configuration

Edit .env file to customize behavior:

# Discord user token (required)
BOT_TOKEN=your_discord_user_token_here

# Server ID to scrape (required)
DEFAULT_SERVER_ID=your_server_id_here

# Channel ID for navigation (required)
DEFAULT_CHANNEL_ID=your_channel_id_here

Output Format

The scraper generates clean text files with one Discord ID per line:

1003301614637031434
1004335757600768141
1010736152304689202
1015175989426409502
...

Output Files

• Saved to outputs/ folder
• Filename format: discord_ids_enhanced_YYYY-MM-DDTHH-MM-SS-sssZ.txt
• Contains only unique Discord user IDs
• Sorted numerically for consistency

Important Notes

⚠️ Discord Terms of Service: This tool uses user tokens which violates Discord's ToS. Use at your own risk.

⚠️ Privacy: Be respectful of user privacy when scraping member data.

⚠️ Performance: Optimized with headless browser and image blocking for maximum speed.

⚠️ Reliability: Includes duplicate prevention and endless mode for comprehensive scraping.

Troubleshooting

Common Issues

1. "Authentication failed": Check your user token in the .env file
2. "Members list not opening": Ensure you have access to the server and channel
3. "No IDs found": Make sure there are online members in the server
4. "Browser launch failed": Install Chromium dependencies if on Linux

Performance Tips

• The scraper runs in headless mode for optimal performance
• Images are blocked to reduce bandwidth and increase speed
• Use "e" command to stop when you have enough IDs

License

MIT License - feel free to modify and use as needed.