{"id":28331200,"url":"https://github.com/kamusis/d4-build-search","last_synced_at":"2026-05-17T02:42:57.444Z","repository":{"id":293445351,"uuid":"983474760","full_name":"kamusis/d4-build-search","owner":"kamusis","description":"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.","archived":false,"fork":false,"pushed_at":"2025-09-28T06:14:18.000Z","size":62,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-28T06:20:35.323Z","etag":null,"topics":["diablo4","python","python3","selenium"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kamusis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-14T12:41:56.000Z","updated_at":"2025-09-28T06:11:46.000Z","dependencies_parsed_at":"2025-05-15T23:31:00.921Z","dependency_job_id":null,"html_url":"https://github.com/kamusis/d4-build-search","commit_stats":null,"previous_names":["kamusis/d4-build-search"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kamusis/d4-build-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamusis%2Fd4-build-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamusis%2Fd4-build-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamusis%2Fd4-build-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamusis%2Fd4-build-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kamusis","download_url":"https://codeload.github.com/kamusis/d4-build-search/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamusis%2Fd4-build-search/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280937584,"owners_count":26416784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-25T02:00:06.499Z","response_time":81,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["diablo4","python","python3","selenium"],"created_at":"2025-05-26T18:28:55.684Z","updated_at":"2025-10-25T10:11:39.771Z","avatar_url":"https://github.com/kamusis.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Diablo 4 Build Search Tool\n\nA 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.\n\n## Features\n\n- Scrape build data from https://maxroll.gg/d4/build-guides\n- Search builds by specific unique equipment, class, or tags\n- **Multilingual support**: Search using English, Simplified Chinese (简体中文), or Traditional Chinese (繁體中文) equipment names\n- Web interface with search, build details, and equipment tier list\n- Real-time progress tracking during data refresh\n\n## Setup\n\n1. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n2. Run the web application:\n   ```bash\n   python app.py\n   ```\n\n3. Open your browser and navigate to `http://localhost:8000`\n\n## Command-Line Usage\n\nYou can also use the scraper directly from the command line:\n\n```bash\n# Scrape builds and save to JSON file\npython scraper.py --get-all-builds\n\n# Search for builds using specific equipment (supports English and Chinese names)\npython scraper.py --search \"Harlequin Crest\"\npython scraper.py --search \"谐角之冠\"\npython scraper.py --search \"諧角之冠\"\n\n# Filter search results by class\npython scraper.py --search \"雷神之戒\" --class Druid\npython scraper.py --search \"破碎冬镜\" --class Sorcerer\n\n# Filter search results by tags\npython scraper.py --search \"Harlequin Crest\" --tags endgame\n\n# Combine multiple filters\npython scraper.py --search \"Harlequin Crest\" --class Sorcerer --tags endgame\n```\n\n## Web UI Guide\n\n### Home Page / Search\n- Enter equipment names, class, or tags to search for builds\n- Results are grouped by character class\n- Click on build titles to view detailed information\n\n### Build Details\n- View complete information about a specific build\n- See all equipment items used in the build\n- Find links to the original build guide\n\n### Equipment Tier List\n- View equipment ranked by popularity in builds\n- Equipment is categorized into tiers (S, A, B, C, D)\n- Click on equipment names to see which builds use them\n\n### Data Refresh\n- Click \"Refresh Data\" from any page to update the build database\n- A confirmation dialog will warn about the processing time\n- The refresh page shows real-time progress and logs\n\n## Data Files\n\n### all_items.json\nContains multilingual names for all Diablo 4 unique items:\n- English names\n- Simplified Chinese (简体中文)\n- Traditional Chinese (繁體中文)\n\nThe data is scraped from https://diablo4.cc and includes 160+ unique items sorted alphabetically.\n\n### Updating Item Names\n\nTo refresh the unique item names database:\n\n```bash\npython scripts/scrape_uniques.py\n```\n\nThis will:\n1. Fetch all unique items from diablo4.cc\n2. Retrieve names in English, Simplified Chinese, and Traditional Chinese\n3. Save results to `scraped_items.json`\n4. You can then copy the data to `all_items.json`\n\n## How it Works\n\nThe 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamusis%2Fd4-build-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkamusis%2Fd4-build-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamusis%2Fd4-build-search/lists"}