A tool to search Diablo 4 builds based on specific unique equipment (including Mythic uniques). It provides both a command-line interface and a web UI for searching builds and viewing equipment tier lists.
- Scrape build data from https://maxroll.gg/d4/build-guides
- Search builds by specific unique equipment, class, or tags
- Web interface with search, build details, and equipment tier list
- Real-time progress tracking during data refresh
-
Install dependencies:
pip install -r requirements.txt
-
Run the web application:
python app.py
-
Open your browser and navigate to
http://localhost:8000
You can also use the scraper directly from the command line:
# Scrape builds and save to JSON file
python scraper.py --scrape
# Search for builds using specific equipment
python scraper.py --search "Harlequin Crest"
# Search for builds by class
python scraper.py --search --class Barbarian
# Search for builds with specific tags
python scraper.py --search --tags endgame,hardcore
# Combine search parameters
python scraper.py --search "Harlequin Crest" --class Sorcerer --tags endgame
- Enter equipment names, class, or tags to search for builds
- Results are grouped by character class
- Click on build titles to view detailed information
- View complete information about a specific build
- See all equipment items used in the build
- Find links to the original build guide
- View equipment ranked by popularity in builds
- Equipment is categorized into tiers (S, A, B, C, D)
- Click on equipment names to see which builds use them
- Click "Refresh Data" from any page to update the build database
- A confirmation dialog will warn about the processing time
- The refresh page shows real-time progress and logs
The application scrapes build data from MaxRoll.gg and allows you to search for builds that use specific unique equipment. This helps players find viable builds utilizing particular unique or mythic items they've found. The tier list feature helps identify the most popular and effective equipment across all builds.