Skip to main content

Lighthouse Agentic Browsing Audit CLI and local Web Dashboard

Project description

Agentic Browsing Auditor

PyPI Version LinkedIn

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentic_browsing_auditor-1.0.0.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentic_browsing_auditor-1.0.0-py3-none-any.whl (14.8 kB view details)

Uploaded Python 3

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

Hashes for agentic_browsing_auditor-1.0.0.tar.gz
Algorithm Hash digest
SHA256 4907789c57f8e5a961e45f6d022c1ba7c6d95a75af27e6ae1e612cb3d972fecb
MD5 e936f3ab01d8dd6446453f0a97afa23a
BLAKE2b-256 c037ab37b151c7ab282c164a4a3c0e229ff04b42b86730ceffa0956f54d79605

See more details on using hashes here.

File details

Details for the file agentic_browsing_auditor-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agentic_browsing_auditor-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ebc7cea06d5eb70bdbc658c0b040798cc299f8f5ded0214cb0d754ae640cc327
MD5 c2004808d7a9506b96ca7bdae4d1a6ae
BLAKE2b-256 7fd3c75e4daf048808a90dd8a502c80ab2989265aeee21680dda9e6d3288c18f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page