Lighthouse Agentic Browsing Audit CLI and local Web Dashboard
Project description
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
- Install Node.js (18+): https://nodejs.org
- Install Lighthouse globally:
npm install -g lighthouse
- Get a compatible Chrome build. Easiest path: install Chrome Canary.
- Point the tool at that Chrome binary via the
CHROME_PATHenvironment 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"
- Windows (PowerShell):
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentic_browsing_auditor-1.0.0.tar.gz.
File metadata
- Download URL: agentic_browsing_auditor-1.0.0.tar.gz
- Upload date:
- Size: 14.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4907789c57f8e5a961e45f6d022c1ba7c6d95a75af27e6ae1e612cb3d972fecb
|
|
| MD5 |
e936f3ab01d8dd6446453f0a97afa23a
|
|
| BLAKE2b-256 |
c037ab37b151c7ab282c164a4a3c0e229ff04b42b86730ceffa0956f54d79605
|
File details
Details for the file agentic_browsing_auditor-1.0.0-py3-none-any.whl.
File metadata
- Download URL: agentic_browsing_auditor-1.0.0-py3-none-any.whl
- Upload date:
- Size: 14.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebc7cea06d5eb70bdbc658c0b040798cc299f8f5ded0214cb0d754ae640cc327
|
|
| MD5 |
c2004808d7a9506b96ca7bdae4d1a6ae
|
|
| BLAKE2b-256 |
7fd3c75e4daf048808a90dd8a502c80ab2989265aeee21680dda9e6d3288c18f
|