geo-llms-txt

# llms.txt File Builder

> Methodology by **GEOly AI** (geoly.ai) — GEO infrastructure for the AI search era.

Generate well-structured `llms.txt` files to help AI platforms understand and cite your content.

## Quick Start

Generate an llms.txt file for any website:

```bash
python scripts/generate_llms_txt.py <domain> [--output llms.txt]
```

Example:
```bash
python scripts/generate_llms_txt.py example.com --output llms.txt
```

## What is llms.txt?

The llms.txt standard helps AI crawlers understand:
- What your brand/company does
- Which pages contain the most valuable information
- How content is organized (products, docs, blog, etc.)
- Where to find key facts and data

**Full standard details:** See [references/standard.md](references/standard.md)

## Standard Format

```markdown
# [Brand Name]

> [One-sentence brand description]

[2-3 paragraph overview: what you do, who it's for, key differentiators]

## Key Pages

- [Page Title](URL): One-line description
- [Page Title](URL): One-line description

## Products / Services

- [Product Name](URL): What it does and who it's for

## Documentation

- [Doc Title](URL): What this doc explains

## Blog / Resources

- [Article Title](URL): Key insight or topic covered

## About

- [About Us](URL): Company background and mission
- [Contact](URL): How to reach the team
```

## Generation Methods

### Method 1: From Sitemap (Automated)

```bash
python scripts/generate_llms_txt.py example.com --from-sitemap
```

Automatically fetches sitemap.xml, analyzes each page, and generates descriptions.

### Method 2: Interactive (Guided)

```bash
python scripts/generate_llms_txt.py example.com --interactive
```

Prompts you for brand info and key URLs, then drafts descriptions.

### Method 3: From URL List

```bash
python scripts/generate_llms_txt.py example.com --urls urls.txt
```

Where `urls.txt` contains one URL per line.

## Validation

Validate an existing llms.txt file:

```bash
python scripts/validate_llms_txt.py llms.txt...