Automated website auditing that finds SEO and accessibility issues, then delivers AI-powered recommendations in professional PDF reports
Everything you need to deliver professional website audits—automated, intelligent, and ready to deploy
Intelligently crawls websites using Playwright, handling JavaScript-heavy sites with ease
Detects missing titles, meta descriptions, heading issues, thin content, and duplicate pages
Finds missing alt text, empty links, and heading structure problems for WCAG compliance
OpenAI-powered insights with priority fixes, quick wins, and long-term strategies
Generate branded PDF reports ready to send to clients or stakeholders
Single command operation—no complex setup or configuration required
Four simple steps from URL to actionable insights
Enter a website URL and the bot crawls key pages using a headless browser
Runs comprehensive SEO and accessibility checks on every page discovered
AI processes findings and creates personalized, actionable recommendations
Outputs a professional PDF report with prioritized issues and solutions
Get up and running in under 5 minutes
# Clone the repository
git clone https://github.com/kkrib412/business-audit-bot.git
cd business-audit-bot
# Create virtual environment and install dependencies
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium
# Set up your OpenAI API key
cp .env.example .env
# Edit .env and add your API key
# Run your first audit!
python audit.py https://example.com
# Customize the scan
python audit.py https://yoursite.com --max-pages 10
python audit.py https://yoursite.com --output ./reports --no-aiWhether you're an agency, freelancer, or startup—automate your audits
Deliver professional audits to clients quickly and consistently without manual work
Generate lead magnets and onboarding reports for new clients in minutes
Run QA checks before launching client sites or pushing major updates
Schedule regular SEO health checks and track competitor performance
Study web scraping, AI integration, and automated report generation
Audit your own site regularly without expensive enterprise tools