Skip to main content

Discord Scraper

This guide will help you configure your Masa Node as a Discord scraper.

Prerequisites​

danger

The Discord scraper requires a bot with appropriate permissions in the target server. This configuration is intended for Discord server administrators or owners only.

Configuration Process​

  1. Set environment variables

    Enable Discord scraping and add your bot token in your .env file:

    DISCORD_SCRAPER=true
    DISCORD_BOT_TOKEN=your_bot_token_here

  2. Restart your node

    Restart the Masa node to apply the changes.

  3. Verify configuration

    Check the logs for confirmation:

    Is DiscordScraper: true

  4. Test the Discord scraper

    Curl the node to confirm it returns Discord data:

    curl -X 'GET' \
      'http://localhost:8080/api/v1/data/discord/guilds/all' \
      -H 'accept: application/json'

    You should receive a response with Discord guild data.

Security Considerations​

  • Keep your Discord bot token secure and do not share it.
  • Regularly rotate your bot token for enhanced security.
  • Ensure your bot has only the necessary permissions in Discord servers.

Warning: Bot Permissions​

danger

Ensure your Discord bot has the correct permissions in the target server. Without proper permissions, the scraper may fail to retrieve data or function incorrectly. Only configure this scraper if you have administrative rights or owner permissions in the target Discord server.

Troubleshooting​

If you encounter issues:

  • Verify your Discord bot token is correct and not expired.
  • Check that your bot has the necessary permissions in the target server.
  • Review node logs for any error messages related to Discord scraping.
  • Ensure your bot is properly connected to the Discord gateway.

For more detailed setup options and advanced configurations, refer to: