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.1.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.1-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

Details for the file agentic_browsing_auditor-1.0.1.tar.gz.

File metadata

  • Download URL: agentic_browsing_auditor-1.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 f2c38379f1fecc74da5eb456ee9ee47230bc14a276fdd153b35c517191eaadcc
MD5 53002b0ccc26783b1b58fa474c2ef27f
BLAKE2b-256 83348df2a96695199e76c714afc42f0dcbef141853a8f3e779d5c8d9c4874d0c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agentic_browsing_auditor-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 664d73608e989e5bb63b95b54f4d814e94cd4eb5031ef23eeb3a952d5e270c45
MD5 5b0c22a5d30ae431cb99de2e61f44b41
BLAKE2b-256 4cf3db9ee0fe6c97da2419b1329ed85766a624948aee4d0cf2c5d0c09a3932fb

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