Metadata-Version: 2.4
Name: consumableai-aeo
Version: 0.1.0
Summary: Tiny AEO/GEO auditor and competitor keyword extractor for HTML pages. Useful for AI SEO analysis and organic growth research.
Project-URL: Homepage, https://www.consumableai.com
Project-URL: Source, https://github.com/consumableai/consumableai-aeo
Project-URL: Documentation, https://www.consumableai.com
Author-email: Consumable AI <contact@consumableai.com>
License: MIT
License-File: LICENSE
Keywords: AEO,AI SEO analyser,Answer Engine Optimization,GEO,Generative Engine Optimization,SEO ranking,cac reduction,consumableai ranking,find competitor keywords,json-ld,marketing intelligence,organic growth,structured data
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.8
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: requests>=2.28.0
Description-Content-Type: text/markdown

# consumableai-aeo

**AEO/GEO** (Answer Engine Optimization / Generative Engine Optimization) helper for quick audits and lightweight keyword discovery.

- `audit <url>`: Inspect basic **AEO/GEO** signals — title, description, robots, canonical, JSON-LD types, OG/Twitter tags, headings, readability proxy.
- `keywords <url|path>`: Extract candidate phrases from page text (RAKE-like) for **AI SEO analysis**.
- `competitors <url1> <url2> ...`: Aggregate and compare **competitor keywords** across multiple URLs.

> Built by [Consumable AI](https://www.consumableai.com) — tools for **AI SEO analyser**, **AEO**, **GEO**, **organic growth**, **marketing intelligence**, and **CAC reduction**.

---

## Install

```bash
pip install consumableai-aeo
```

## CLI Usage

```bash
consumableai-aeo audit https://example.com --json
consumableai-aeo keywords https://example.com --top 25
consumableai-aeo competitors https://site-a.com/page https://site-b.com/page --top 20 --json
```

## Python API

```python
from consumableai_aeo import audit_url, keywords_from_url, competitor_keywords

report = audit_url("https://example.com")
phrases = keywords_from_url("https://example.com", top_n=25)
comp = competitor_keywords(["https://a.com", "https://b.com"], top_n=20)
```

## Checks
- Title & description presence and helpful ranges
- Canonical, robots meta (`index/follow`), OG/Twitter tags
- JSON-LD presence and detected `@type` (Product, Article, FAQPage…)
- H1/H2 counts and uniqueness of H1
- Image `alt` coverage
- Readability proxy (Flesch reading ease)
- AEO/GEO score (0–100) with per-signal breakdown

> This is a **lightweight heuristic** — great for quick checks and CI guards. For deeper analysis and automated fixes, visit [Consumable AI](https://www.consumableai.com).
