7 stable releases
1.0.7 | May 15, 2025 |
---|---|
1.0.6 | Apr 8, 2025 |
1.0.4 | Mar 18, 2025 |
#904 in Command line utilities
150 downloads per month
30KB
603 lines
DiscordRustScraper
Description
DiscordRustScraper is a powerful Discord data scraper built in Rust, designed to extract and format channel data for further analysis. It efficiently pulls message history from specified channels and outputs it in a clean JSON format for easy processing. Optional features include creating backups of messages and storing data in a SQL database for improved performance and organization.
Table of Contents
Disclaimer
DiscordRustScraper is an open-source tool for ethical use, provided "as is." Users must comply with Discord's terms and laws. Not affiliated with Discord.
Commands & Usage
Scrape
- Usage :
cargo run -- scrape --bot_token <BOT_TOKEN> --channel_ids [CHANNEL_IDS]
- Example :
cargo run -- scrape --bot_token "your_bot_token" --channel_ids 659069446438125570 806378740917469234
convert-to-json
-
Usage:
cargo run -- convert-to-json <INPUT_FILE>
-
Example:
cargo run -- convert-to-json on-topic.jsonl
-
--personal
is now removed due to Discord's Terms of Service. Using user account tokens for automation is against Discord policy and may lead to account bans.
sql (optional)
The SQL argument provides an optional feature that enables the use of a SQL database to store messages instead of the default storage method, by passing through a connection string. This is a more efficient way of storing data compared to JSONs.
- Usage :
cargo run -- scrape --bot_token <BOT_TOKEN> --channel_ids [CHANNEL_IDS] --sql <CONNECTION_STRING>
- Example :
cargo run -- scrape --bot_token "your_bot_token" --channel_ids 659069446438125570 806378740917469234 --sql mysql://username:password@127.0.0.1:3306/database
Schema
You'll have to create the database yourself so i've attached the schema below.
CREATE TABLE messages (
channel_id BIGINT UNSIGNED NOT NULL,
author_id BIGINT UNSIGNED NOT NULL,
message_id BIGINT UNSIGNED NOT NULL,
message TEXT NOT NULL,
has_media BOOLEAN NOT NULL,
PRIMARY KEY (message_id)
);
Inspired by DiscordChatExporter.
Dependencies
~31–46MB
~823K SLoC