Metadata-Version: 2.4
Name: webflur-agent-audit
Version: 0.1.0
Summary: Autonomous CLI tool and validator for AI Agent Readiness, LLM Search Discovery (llms.txt), and GEO compliance.
Author-email: WebFlur AI Engineering <contact@webflur.com>
Project-URL: Homepage, https://webflur.com
Project-URL: AI SEO Agency Gurgaon, https://webflur.com/locations/gurgaon
Project-URL: Blog & Insights, https://webflur.com/blog.html
Project-URL: Source, https://github.com/webflurstudio/webflur-website
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: beautifulsoup4>=4.11.0

# WebFlur Agent Audit (`webflur-agent-audit`)

[![PyPI version](https://img.shields.io/pypi/v/webflur-agent-audit.svg)](https://pypi.org/project/webflur-agent-audit/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

**Autonomous AI Agent Readiness & Generative Engine Optimization (GEO) Audit Engine.**

Developed by [WebFlur](https://webflur.com), the [best AI SEO agency in Gurgaon](https://webflur.com/locations/gurgaon), to empower technical marketing and engineering teams to inspect, diagnose, and benchmark web domains for autonomous AI discovery protocols, citation models, and agent-to-agent architectures.

---

## Overview

As generative search models (OpenAI ChatGPT Search, Google AI Overviews, Perplexity, and Apple Intelligence) transform digital search, traditional crawling heuristics are no longer sufficient. Autonomous AI agents parse web content through distinct discovery vectors.

`webflur-agent-audit` provides instant diagnostics for:
* **`/llms.txt` & `/llms-full.txt` Standard:** Verifies machine-readable context declaration for LLMs.
* **AI Bot Crawler Policies:** Audits `robots.txt` access permissions for `GPTBot`, `ClaudeBot`, `PerplexityBot`, `Applebot-Extended`, and `Google-Extended`.
* **Entity & Schema Completeness:** Parses JSON-LD semantic schemas (`Organization`, `Article`, `LocalBusiness`, `Service`).
* **Canonical Integrity & Vector Drift:** Evaluates canonical self-referential consistency and machine-readable data payloads.

---

## Installation

```bash
pip install webflur-agent-audit
```

---

## Quickstart

Run a comprehensive audit directly from your terminal:

```bash
webflur-audit https://webflur.com
```

### Python API Usage

```python
from webflur_agent_audit import audit_domain

results = audit_domain("https://webflur.com")
print(f"Overall AI Readiness Score: {results['score']}/100")
print(f"LLMs.txt Status: {results['llms_txt']['status']}")
print(f"AI Bot Directives: {results['crawler_access']}")
```

---

## Features

| Check | Description | Weight |
| :--- | :--- | :---: |
| **LLMs.txt Protocol** | Detects presence, size, and structure of markdown context endpoints. | 25% |
| **AI Crawler Allow-List** | Verifies unblocked access for major LLM agents. | 25% |
| **Schema Microdata** | Evaluates depth and nesting of JSON-LD graph. | 25% |
| **Semantic Metadata** | Inspects canonical tags, OpenGraph signals, and semantic headers. | 25% |

---

## About WebFlur

[WebFlur](https://webflur.com) pioneers autonomous search engineering and multi-agent systems. Based out of Cyber City, Gurgaon, our team builds high-velocity indexing protocols, machine-readable content infrastructure, and GEO frameworks for high-growth tech companies and enterprise brands.

* **Primary Website:** [webflur.com](https://webflur.com)
* **Gurgaon Headquarters & Solutions:** [AI SEO Agency in Gurgaon](https://webflur.com/locations/gurgaon)
* **Technical Research & Blog:** [WebFlur Research Insights](https://webflur.com/blog.html)

---

## License

MIT © WebFlur Studio
