BugHunter
Documentation

How BugHunter works

A clear, step-by-step guide to scanning your first website, reading reports, and keeping bug counts trending down.

What it does

BugHunter is an automated website bug tracker. Give it a URL and it will crawl the site, scan every page it finds, and produce a prioritized report of SEO, accessibility, performance, security, and general health issues. All checks are non-intrusive — read-only HTTP probes and header inspection, no exploit attempts, no rate-limit abuse.

Step-by-step

  1. 1. Create an account

    Sign up with your email and password (or Google). Your projects and scans are private to your account and protected by row-level security.

  2. 2. Add a project

    From the Dashboard, click 'New project' and paste the seed URL of the site you want to audit (e.g. https://example.com). You can add as many projects as you need.

  3. 3. Run your first scan

    Open the project and click 'Run scan'. BugHunter crawls the site starting from the seed URL, follows internal links, and audits every page it discovers — fully automated.

  4. 4. Review findings

    Each scan produces a report grouped by severity (critical, high, medium, low, info) and category (SEO, accessibility, performance, security, health). Click any issue to see the page, the offending code, and the recommended fix.

  5. 5. Compare runs

    Every scan is diffed against the previous one for the same project. You instantly see what bugs were introduced, what was resolved, and what remains unchanged.

  6. 6. Schedule re-scans

    Enable a daily or weekly schedule on each project so reports stay fresh automatically. You can still trigger a manual re-scan at any time.

  7. 7. Export & share

    Use 'Export CSV' on any scan report to download the full list of issues with page URLs, severity, and detection details — ready to share with your team or import into a ticketing tool.

What gets checked

SEO

  • Missing or duplicate titles
  • Meta description quality
  • Heading hierarchy
  • Open Graph & Twitter tags
  • Canonical & robots

Accessibility

  • Missing alt text
  • Document language
  • Viewport meta
  • Color contrast hints
  • ARIA misuse

Performance

  • Slow page responses
  • Large payloads
  • Render-blocking patterns
  • Status code anomalies

Security

  • HSTS / CSP / X-Frame-Options
  • Mixed content
  • Insecure cookies
  • Server disclosure
  • Sensitive paths exposed

Reading a report

Severity — issues are ranked critical → high → medium → low → info. Start at the top.

Category — filter by SEO, accessibility, performance, security, or health to focus on one type of fix.

Page URL — each finding is linked to the exact page where it was detected, so you can reproduce it in one click.

Diff panel — at the top of every scan you'll see what changed vs. the previous run. Green = resolved, red = newly introduced.

Responsible use

Only scan websites you own or have explicit written permission to test. BugHunter performs read-only checks, but unauthorized scanning may still violate the target's terms of service or local laws. See the Legal & Disclaimers page for the full policy.

Ready to hunt your first bug?

Get started →