Metadata-Version: 2.4
Name: agentic-browsing-auditor
Version: 1.0.1
Summary: Lighthouse Agentic Browsing Audit CLI and local Web Dashboard
Author-email: Amal Alexander <amalalex95@gmail.com>
Project-URL: Homepage, https://github.com/amal-alexander/agentic-browsing-auditor
Project-URL: LinkedIn, https://www.linkedin.com/in/amal-alexander-305780131/
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: Flask>=3.0.0
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=13.0.0

# Agentic Browsing Auditor

[![PyPI Version](https://img.shields.io/pypi/v/agentic-browsing-auditor.svg)](https://pypi.org/project/agentic-browsing-auditor/)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Amal%20Alexander-blue)](https://www.linkedin.com/in/amal-alexander-305780131/)

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](https://www.linkedin.com/in/amal-alexander-305780131/)).

---

## 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:

```bash
pip install agentic-browsing-auditor
```

### Pre-requisites

1. **Install Node.js** (18+): https://nodejs.org
2. **Install Lighthouse** globally:
   ```bash
   npm install -g lighthouse
   ```
3. **Get a compatible Chrome build.** Easiest path: install [Chrome Canary](https://www.google.com/chrome/canary/).
4. **Point the tool at that Chrome binary** via the `CHROME_PATH` environment variable:
   - **Windows (PowerShell)**:
     ```powershell
     $env:CHROME_PATH = "C:\Users\<YourUsername>\AppData\Local\Google\Chrome SxS\Application\chrome.exe"
     ```
   - **macOS**:
     ```bash
     export CHROME_PATH="/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary"
     ```
   - **Linux**:
     ```bash
     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:
```bash
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.
```bash
agentic-auditor bulk urls.txt --output results.csv
```

### 3. Launch the Local Web Dashboard
Serve the interactive visual Lighthouse-style dashboard locally:
```bash
agentic-auditor serve
```
Then visit http://localhost:5000 in your browser.

---

## Author & Contact

Built and maintained by **Amal Alexander**.
- **Email**: [amalalex95@gmail.com](mailto:amalalex95@gmail.com)
- **LinkedIn**: [amal-alexander-305780131](https://www.linkedin.com/in/amal-alexander-305780131/)
