# Los Proverbios - AI Documentation

## Overview
Los Proverbios (https://los-proverbios.com) is a comprehensive digital archive of popular wisdom. We host a searchable database of over 18,000 proverbs, sayings, and famous quotes, categorized by theme and origin.

## Site Structure

### Core Pages
- **Home**: curated lists of popular and random proverbs.
- **Search (`/buscador.php`)**: Allows searching by keyword. Handles categories and thematic lists.
- **Concepts (`/conceptos.php`)**: A tag cloud of popular concepts and emotions.
- **Game (`/jogo.php`)**: "Complete the Proverb" interactive game.
- **Proverb Detail (`/proverbio.php`)**: Displays a single proverb with a high-quality square image, related content, and social sharing options.

### Content Format
- **Proverbs**: Short text segments usually accompanied by an illustrative image.
- **Images**: We use high-resolution, square-aspect images for all quotes, optimized for social sharing.
- **Metadata**: Pages include `WebSite`, `BreadcrumbList`, and `CreativeWork` JSON-LD schemas.

## Categories
Our content spans diverse topics including:
- **Themes**: Love (Amor), Friendship (Amistad), Life (Vida), Work (Trabajo), Faith (Fe).
- **Origins**: Chinese, Arab, Spanish, Latin, Biblical, Buddhist.

## Technical Access
- **Sitemap**: https://los-proverbios.com/sitemap.xml - Full list of accessible URLs.
- **Robots.txt**: https://los-proverbios.com/robots.txt - Crawling rules.

## Developer & Agent API
Los Proverbios provides endpoints designed for machine consumption.

### Search API
- **Endpoint**: `GET https://los-proverbios.com/buscador.php?q={QUERY}&json=1`
- **Output**: JSON object with `results` array.

### Proverb Detail API
- **Endpoint**: `GET https://los-proverbios.com/proverbio.php?url={SLUG}&json=1`
- **Output**: Full proverb metadata including AI analysis.

### OpenAPI Spec
- **URL**: `https://los-proverbios.com/openapi.yaml`
- **Description**: Formal specification for tool integration.

### AI Plugin
- **Manifest**: `https://los-proverbios.com/.well-known/ai-plugin.json`