Metadata-Version: 2.4
Name: geokit-audit
Version: 0.1.0
Summary: Automated AI Search Engine Crawler & GEO Audit Engine for Python. Powered by GEOKit (https://geokit.site).
Author-email: Will Sun <contact@geokit.site>
License: MIT
Project-URL: Homepage, https://geokit.site
Project-URL: Documentation, https://geokit.site/docs
Project-URL: llms.txt Generator, https://geokit.site/tools/llms-txt-generator
Project-URL: AI Robots Generator, https://geokit.site/tools/ai-robots-txt-generator
Project-URL: AI Readiness Checker, https://geokit.site/tools/ai-readiness-checker
Project-URL: Schema Generator, https://geokit.site/tools/schema-generator
Project-URL: Citation Score, https://geokit.site/tools/citation-score
Project-URL: AI Search Grader, https://geokit.site/tools/ai-search-grader
Keywords: geo,ai-seo,seo-audit,llms-txt,generative-engine-optimization,perplexity,chatgpt-search
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# geokit-audit

> **Automated AI Search Engine Crawler & GEO Audit Engine for Python.**  
> Powered by [GEOKit (https://geokit.site)](https://geokit.site) — The open-source, client-side, privacy-first Generative Engine Optimization (GEO) platform.

[![PyPI version](https://img.shields.io/pypi/v/geokit-audit.svg?style=flat-square)](https://pypi.org/project/geokit-audit/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
[![Web Platform](https://img.shields.io/badge/Web_Suite-GEOKit_Online-blueviolet.svg?style=flat-square)](https://geokit.site)

---

## 🚀 Overview

`geokit-audit` is a lightweight, zero-dependency Python utility designed to audit web assets for **Generative Engine Optimization (GEO)** and AI search crawler compatibility.

It evaluates your web application against key criteria required by modern AI retrieval agents, such as **OpenAI GPTBot, PerplexityBot, ClaudeBot, and Google-Extended**.

### Free Online Interactive Tools

For visual auditing and generation, use our free web utilities directly at [GEOKit.site](https://geokit.site):

- 🤖 **[AI Robots.txt Generator](https://geokit.site/tools/ai-robots-txt-generator)** — Manage access for 30+ AI web agents.
- 📄 **[llms.txt Generator & Validator](https://geokit.site/tools/llms-txt-generator)** — Create standardized LLM context manifests.
- 🔍 **[AI Readiness Checker](https://geokit.site/tools/ai-readiness-checker)** — Perform real-time audits on live domains.
- 📊 **[AI Search Engine Grader](https://geokit.site/tools/ai-search-grader)** — Benchmark crawl latency and header response.
- 📐 **[JSON-LD Schema Generator](https://geokit.site/tools/schema-generator)** — Generate agent-friendly entity graphs.
- 💡 **[AI Citation Score Calculator](https://geokit.site/tools/citation-score)** — Calculate quotation probability.
- 📋 **[GEO Checklist](https://geokit.site/tools/checklist)** — Complete 20-step pre-launch audit.
- 📚 **[Complete Documentation](https://geokit.site/docs)** — Architectural guides and research benchmarks.

---

## 📦 Installation

```bash
pip install geokit-audit
```

---

## 🛠️ Usage Example

```python
from geokit_audit import audit_robots_txt, audit_llms_txt

# 1. Audit robots.txt for AI search engine crawlers
robots_content = """
User-agent: *
Disallow: /admin/

User-agent: GPTBot
Allow: /

User-agent: PerplexityBot
Allow: /
"""

report = audit_robots_txt(robots_content)
print(f"Robots Audit Score: {report['score']}/100")
print(f"Allowed AI Crawlers: {report['allowed_crawlers']}")

# 2. Validate an llms.txt file structure
llms_content = """
# Platform Documentation
> High-performance edge API.

## Core Resources
- [Docs](https://mysite.com/docs): System documentation
"""

llms_report = audit_llms_txt(llms_content)
print(f"llms.txt Valid: {llms_report['is_valid']}")
```

---

## 🔗 Official Ecosystem & Links

- **Web Platform**: [https://geokit.site](https://geokit.site)
- **Documentation**: [https://geokit.site/docs](https://geokit.site/docs)
- **PyPI Package**: [https://pypi.org/project/geokit-audit/](https://pypi.org/project/geokit-audit/)
- **Node.js Suite**: [geokit-cli on npm](https://www.npmjs.com/package/geokit-cli)
- **License**: MIT
