agentic-browsing-auditor

Agentic Browsing Auditor

A Python-based CLI tool and local dashboard to audit website performance for LLM agents using Google Lighthouse's experimental Agentic Browsing category (evaluates llms.txt, WebMCP, agent-centric accessibility, and layout stability).

Developed by Amal Alexander (LinkedIn).

---

Why you need Chrome + Node

The Agentic Browsing category:

• Shipped in Lighthouse 13.3 (May 2026) as part of the default config.
• Requires Chrome 150+ (or Chrome Canary).
• Requires a local node environment to shell out to lighthouse.

---

Setup & Installation

You can install the auditor package directly from PyPI:

pip install agentic-browsing-auditor

Pre-requisites

1. Install Node.js (18+): https://nodejs.org
2. Install Lighthouse globally:

   npm install -g lighthouse
   

3. Get a compatible Chrome build. Easiest path: install Chrome Canary.
4. Point the tool at that Chrome binary via the CHROME_PATH environment variable:
   • Windows (PowerShell):

     $env:CHROME_PATH = "C:\Users\<YourUsername>\AppData\Local\Google\Chrome SxS\Application\chrome.exe"
     

   • macOS:

     export CHROME_PATH="/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary"
     

   • Linux:

     export CHROME_PATH="/usr/bin/google-chrome-canary"
     

---

Usage

Once installed, you can access the auditor using the global CLI command agentic-auditor.

1. Audit a Single URL

Analyze a website and print a beautiful table of results directly inside the terminal:

agentic-auditor audit example.com

2. Bulk Audit URLs (with CSV export)

Audit multiple URLs listed in a text file (one URL per line) and export the results to a CSV file.

agentic-auditor bulk urls.txt --output results.csv

3. Launch the Local Web Dashboard

Serve the interactive visual Lighthouse-style dashboard locally:

agentic-auditor serve

Then visit http://localhost:5000 in your browser.

---

Author & Contact

Built and maintained by Amal Alexander.

• Email: amalalex95@gmail.com
• LinkedIn: amal-alexander-305780131