Scrape all server members (even offline) · Tag & annotate · Export CSV/JSON · Beautiful dark UI

Discord's built-in member list only shows online users, hides behind slow scrolling, and offers zero annotation tools. Server Lens scrapes the full member list through Discord's Gateway API — including offline members — and gives you a beautiful interface to search, tag, annotate, and export your data.

• Token-based auth — paste your Discord user token to connect
• Full member scraping — fetches all members via Gateway (op 14 range sweep + op 8 search sweep)
• Bot filtering — automatically excludes bot accounts
• Quirk tags — add custom labels to any member (e.g. "lurker", "mod", "funny")
• Notes — write freeform notes per member, auto-saved
• Export — download member lists as CSV or JSON
• Re-scrape — refresh anytime, existing tags & notes are preserved
• Search & filter — instant search, sort by name/join date, filter by tags or roles
• Beautiful dark UI — Discord-inspired aesthetics with JetBrains Mono typography
• Privacy-first — 100% self-hosted, your token and data never leave your machine

git clone https://github.com/MuTe43/Discord-member-scraper.git
cd Discord-member-scraper
docker compose up

Open http://localhost:8000 and you're done.

git clone https://github.com/MuTe43/Discord-member-scraper.git
cd Discord-member-scraper
pip install -r requirements.txt
cd backend
python main.py

Open http://localhost:8000 in your browser.

1. Open Discord in your browser → discord.com/app
2. Open DevTools → F12
3. Go to the Network tab
4. Click anything or send a message
5. Find a request to discord.com/api
6. In the request headers, copy the Authorization value

⚠️ Warning: Your token grants full access to your account. Never share it. Server Lens runs 100% locally — your token is never sent to any third party.

┌──────────────────────────────────────────────┐
│                   Browser                    │
│  ┌──────────┐  ┌──────────┐  ┌───────────┐  │
│  │ index.html│  │ style.css│  │  app.js   │  │
│  └──────────┘  └──────────┘  └───────────┘  │
└──────────────────────┬───────────────────────┘
                       │ HTTP / SSE
┌──────────────────────┴───────────────────────┐
│              FastAPI Backend                 │
│  ┌──────────┐  ┌──────────┐  ┌───────────┐  │
│  │ main.py  │  │scraper.py│  │gateway.py │  │
│  │ (routes) │  │ (scrape) │  │ (session) │  │
│  └──────────┘  └──────────┘  └───────────┘  │
│  ┌──────────┐  ┌──────────────────────────┐  │
│  │models.py │  │     data.json (local)    │  │
│  └──────────┘  └──────────────────────────┘  │
└──────────────────────┬───────────────────────┘
                       │ WebSocket + REST
               ┌───────┴────────┐
               │ Discord API v9 │
               └────────────────┘

server-lens/
├── backend/
│   ├── main.py          # FastAPI app + routes
│   ├── gateway.py       # Discord Gateway session manager
│   ├── scraper.py       # Member scraping logic + REST helpers
│   └── models.py        # Pydantic request models
├── frontend/
│   ├── index.html       # Page structure
│   ├── style.css        # All styles (dark theme)
│   └── app.js           # Application logic
├── assets/
│   └── banner.png       # Project banner
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── CONTRIBUTING.md
└── LICENSE

• 100% local — your Discord token is stored only in your browser's sessionStorage and sent directly to Discord's API. It never touches any third-party server.
• Security headers — CSP, X-Frame-Options, and X-Content-Type-Options are enabled by default.
• Atomic writes — data is saved atomically to prevent corruption on crashes.
• Open source — audit every line of code yourself.

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Whether it's bug fixes, new features, or UI improvements — PRs are appreciated!

• SQLite storage for better performance with large servers
• Virtual scrolling for 10k+ member servers
• Discord REST API rate-limit handling
• Bulk tagging / multi-select members
• Dark/light theme toggle
• Browser extension for one-click scraping

Have an idea? Open a feature request →

• Found a bug? Open an issue
• Feature request? Let us know
• Like the project? Give it a star — it helps others find it!

MIT — use it, fork it, build on it.

If Server Lens saved you time, consider giving it a ⭐
_{Built with FastAPI + vanilla JS}