A comprehensive website auditing tool that analyzes security, SEO, performance, accessibility, broken links, and mobile optimization — all from a single URL input.
"This project was entirely designed, developed, and deployed using Antigravity, a powerful agentic AI coding assistant built by the Google DeepMind team — from initial architecture to the final GitHub push."
webaudit is a Flask-powered web application that performs a full-spectrum health check on any website. Enter a URL and get an instant, detailed report covering 7 critical dimensions — comparable to professional tools like Google Lighthouse, GTmetrix, and WebPageTest, but running entirely on your own machine.
- ✅ HTTPS encryption verification
- ✅ SSL certificate validation
- ✅ Security headers audit (HSTS, CSP, X-Frame-Options, X-XSS-Protection)
- ✅ Mixed content detection
- ✅ Exposed sensitive files scanner (
.git,.env, config files) - ✅ Cookie security flags (HttpOnly, Secure, SameSite)
- 🔎 Scans up to 100 links per page
- 🧠 Smart false-positive reduction (handles bot-detection, rate limiting)
- 🔄 Automatic HEAD → GET fallback for edge cases
- 📋 Provides HTTP status codes and failure reasons for every broken link
- ⏱️ Real-time page load time measurement
- 📦 Page size evaluation
- 📊 Resource count analysis
- 🗜️ Compression detection (gzip / brotli)
- 🗄️ Caching headers verification
- 🖼️ Image optimization checks (flags images > 500KB)
- 📝 Title tag length optimization (30–60 characters)
- 📄 Meta description validation (120–160 characters)
- 🏗️ Heading hierarchy (H1–H6 structure)
- 🔗 Canonical URL presence
- 📣 Open Graph tags for social media sharing
- 🐦 Twitter Card tags
- 🗂️ Schema.org structured data markup
- 🤖 Robots meta tag configuration
- 🌍 Language declaration (
<html lang="">) - 🖼️ Alt text for all images
- 🏷️ Form input labels and ARIA labels
- 🗺️ ARIA landmarks for screen reader navigation
- ⬆️ Skip navigation links
- 🏛️ Semantic HTML usage
- ⚖️ WCAG-aligned compliance checks
- 📐 Viewport meta tag configuration
- 🍎 Apple touch icons for iOS
- 📲 Progressive Web App (PWA) manifest detection
- 🔤 Mobile-friendly font sizes
- 🖼️ Responsive images (
srcset) detection - 👆 Touch-friendly interactive element checks
- 🔍 Client-side rendering detection
- ⚙️ JavaScript dependency identification
- 🔴 High / 🟡 Medium / 🟢 Low priority recommendations
- 🎯 Category-specific, actionable fixes
- 📚 Best practices enforcement across all dimensions
| Score | Range | Indicator |
|---|---|---|
| 🟢 Excellent | 90–100 | Outstanding |
| 🔵 Good | 70–89 | Above Average |
| 🟡 Fair | 50–69 | Needs Attention |
| 🔴 Poor | 0–49 | Critical Issues |
The dashboard features animated score circles, gradient section headers, colour-coded severity badges, hover card effects, smooth scrolling, and a fully responsive layout.
| Layer | Technology | Badge |
|---|---|---|
| 🐍 Backend | Python 3.8+, Flask |  |
| 🔬 Parsing | BeautifulSoup4, requests |  |
| 🎨 Frontend | Vanilla JavaScript, CSS3 |  |
| 🔐 Security | SSL verification, HTTP header analysis |  |
| 🧮 Analysis | Custom algorithms per category |  |
webaudit/
├── 📄 app.py # Flask application & REST endpoints
├── 🧠 analyzer.py # Core website analysis engine
├── 📋 requirements.txt # Python dependencies
├── 📖 README.md # Documentation
├── 📁 static/
│ ├── 🎨 style.css # Styling & animations
│ └── ⚡ script.js # Frontend logic & result rendering
└── 📁 templates/
└── 🌐 index.html # Dashboard HTML template
- 🐍 Python 3.8 or higher
- 📦 pip package manager
# 1. Clone the repository
git clone https://github.com/papai0709/webaudit.git
cd webaudit
# 2. (Optional) Create a virtual environment
python -m venv .venv
source .venv/bin/activate # macOS/Linux
.venv\Scripts\activate # Windows
# 3. Install dependencies
pip install -r requirements.txt
# 4. Start the server
python app.pyThen open your browser and go to: http://localhost:5002
- 🌐 Enter a URL — with or without
https://(auto-detected) - 🔍 Click "Analyse Website" — the engine runs all checks in parallel
- 📊 Review the Report — explore scores, issues, and recommendations per category
Overall Score: 83/100
🔒 Security: 85/100
✓ HTTPS enabled
✓ Valid SSL certificate
⚠ Missing Content-Security-Policy header
🎯 SEO: 78/100
✓ Title length optimal: 45 characters
✓ Open Graph tags present
⚠ Missing Schema.org structured data
♿ Accessibility: 92/100
✓ All images have alt text
✓ Language declared: en
✓ ARIA landmarks present
📱 Mobile: 88/100
✓ Responsive viewport configured
✓ Web app manifest present
⚠ No responsive images (srcset)
Each category scores from 0 to 100 based on the number of issues detected:
| Category | Penalty per issue |
|---|---|
| 🔒 Security | −15 points |
| 🎯 SEO | −10 points |
| ♿ Accessibility | −12 points |
| 📱 Mobile | −15 points |
- 📄 PDF report export
- 📈 Historical scan tracking & trend graphs
- ⚔️ Competitor side-by-side comparison
- 💡 Lighthouse API integration
- 🕐 Automated scheduled scans
- 📧 Email alerts for critical issues
- 🔌 REST API for programmatic access
- 🧩 Browser extension
- 📦 Bulk URL batch analysis
- 🔄 CI/CD pipeline integration
Contributions are welcome!
- 🐛 Report bugs via Issues
- 💡 Suggest features via Discussions
- 🔧 Submit a Pull Request
- 📝 Improve the documentation
Please fork the repository and create a feature branch before submitting a PR.
This project is open source and available for personal and commercial use.
This entire project — from architecture design and code implementation to testing, documentation, and Git publishing — was built using Antigravity, an advanced agentic AI coding assistant developed by the Google DeepMind team.
Antigravity pair-programmed every feature in this repository, demonstrating the power of AI-assisted software development.
Built with modern Python web technologies and designed to deliver professional-grade website analysis accessible to everyone — developers, designers, and site owners alike.
Special thanks to Google DeepMind and the Antigravity team for making AI-powered development a reality.
Made with ❤️ using 🤖 Antigravity — webaudit
