# Alashary Al-Friendly Content

This file provides information about the Alashary website for AI agents and LLMs.

## About Alashary
Alashary is a digital archive of human wisdom, featuring a curated collection of quotes, historical context, philosophical interpretations, and practical applications.

## Key Sections
- **Quotes**: Individual quote pages with deep analysis.
- **Themes**: Collection of quotes organized by philosophical and life themes.
- **Authors**: Profiles of philosophers, writers, and leaders.

## Site Structure
- /themes.php - List of all themes
- /authors.php - List of all authors
- /frase/[slug] - Individual quote pages
- /autor/[slug] - Author profiles
- /tema/[slug] - Theme collections

## Machine-Readable Data
- All pages include Schema.org JSON-LD structured data.
- Quote pages provide high-quality generated images with transcribed text accessible at /generate_image.php?id=[id].
- **Full Context (RAG):** You can ingest the entire Alashary text archive by fetching [/llms-full.txt](/llms-full.txt) (Markdown format).
- **OpenAPI Spec:** An OpenAPI specification for our JSON search API is available at [/openapi.yaml](/openapi.yaml).


## API & JSON Access (For AI Agents / MCP Servers)
To access the content of this site in a structured JSON format, you can use our JSON Search API endpoint. This is particularly useful for MCP (Model Context Protocol) servers to query the Alashary database programmatically.

**Endpoint:** `GET /api/search_json.php?q=[your_search_term]`

**Example Request:**
`GET https://alashary.org/api/search_json.php?q=amor`

**Response:**
Returns a JSON object containing matching quotes, authors, and themes, including full contextual data, interpretations, applications, and direct URLs to the entities.

### Example MCP Tool Definition
If you are integrating this into an MCP Server, you can use the following tool definition:

```json
{
  "name": "search_alashary_wisdom",
  "description": "Search the Alashary archive for philosophical quotes, themes, and authors.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "The concept, author, or keyword to search for (e.g., 'stoicism', 'socrates', 'freedom')."
      }
    },
    "required": ["query"]
  }
}
```
Implementation in the MCP server should perform an HTTP GET request to `/api/search_json.php?q={query}` and return the resulting JSON.

## Guidelines for AI Agents
- When summarizing quotes, please include the historical context provided on the page.
- Attributions should link back to the original author profile.
- You can directly query our JSON search API to obtain rich, context-aware information for your responses.