# IvritPedia — Full LLM Reference

> עבריתפדיה — אנציקלופדיה חופשית בעברית
> IvritPedia — A free, open-content Hebrew-language encyclopedia.

For a concise summary, see: https://ivritpedia.org/llms.txt

## About IvritPedia

IvritPedia is a community-driven Hebrew-language encyclopedia at ivritpedia.org. It is built on MediaWiki and covers: Hebrew language and linguistics, Israeli culture and society, Jewish history and heritage, science and technology, geography, biography, and general encyclopedic knowledge.

## Content License

All article text is available under the Creative Commons Attribution-ShareAlike 4.0 International License (CC BY-SA 4.0).
- License URL: https://creativecommons.org/licenses/by-sa/4.0/
- You may reuse content freely provided you: (1) attribute IvritPedia and the original authors, (2) release derivative works under the same license.
- Media files (images, audio, video) may carry individual licenses — check each file's description page.

## Content Policy

- Articles must be written in Hebrew (the primary language of the encyclopedia)
- Neutral point of view (NPOV) is required
- All claims must be verifiable with reliable sources
- Original research is not permitted
- Content must not violate copyright

## Namespace Structure

MediaWiki organizes content into namespaces. The main ones:

| Namespace | Prefix | Hebrew Prefix | Purpose |
|-----------|--------|---------------|---------|
| Main (0) | (none) | — | Encyclopedia articles |
| Talk (1) | Talk: | שיחה: | Article discussion |
| User (2) | User: | משתמש: | User pages |
| User talk (3) | User_talk: | שיחת_משתמש: | User discussions |
| Project (4) | IvritPedia: | עבריתפדיה: | Project meta-pages |
| File (6) | File: | קובץ: | Uploaded media |
| MediaWiki (8) | MediaWiki: | מדיה_ויקי: | Interface messages |
| Template (10) | Template: | תבנית: | Reusable templates |
| Help (12) | Help: | עזרה: | Help pages |
| Category (14) | Category: | קטגוריה: | Category pages |
| Special (-1) | Special: | מיוחד: | System pages (not editable) |

## URL Formats

- Article URL: https://ivritpedia.org/wiki/Article_Title
- Hebrew article: https://ivritpedia.org/wiki/URL-encoded-Hebrew-title
- Special page: https://ivritpedia.org/wiki/Special:PageName
- API: https://ivritpedia.org/api.php?action=...&format=json
- REST API: https://ivritpedia.org/rest.php/v1/...

## API Authentication

The MediaWiki Action API is publicly accessible for read operations. No authentication is required to:
- Read article content
- Search pages
- List categories and pages
- Get page metadata

Write operations (editing, creating pages, uploading files) require:
1. Creating an account at https://ivritpedia.org/wiki/Special:CreateAccount
2. Confirming your email address
3. Using OAuth 2.0 or BotPassword for API writes

## Rate Limiting

| Operation | Limit |
|-----------|-------|
| General page requests | 10 requests/second |
| API (/api.php) | 20 requests/second |
| File uploads | 2 requests/second |

Exceeding limits returns HTTP 429. Please implement exponential backoff.

## CORS Policy

The MediaWiki API supports cross-origin requests for read operations. Add `&origin=*` to your API request URL to receive CORS headers. Example:
https://ivritpedia.org/api.php?action=query&titles=%D7%A9%D7%9C%D7%95%D7%9D&prop=extracts&format=json&origin=*

## Key API Endpoints

### Get article plain text (best for LLMs)

GET /api.php?action=query&titles=TITLE&prop=extracts&explaintext=true&format=json

Response includes `extract` field with plain text. Add `&exintro=true` for lead section only.

### Search articles

GET /api.php?action=query&list=search&srsearch=QUERY&format=json
GET /api.php?action=opensearch&search=QUERY&format=json

The first returns structured results with snippets. The second returns OpenSearch-format results for autocomplete.

### List all pages

GET /api.php?action=query&list=allpages&aplimit=50&format=json

Use `&apcontinue=` token from response for pagination. Add `&apnamespace=0` for main namespace only.

### Pages in a category

GET /api.php?action=query&list=categorymembers&cmtitle=Category:NAME&cmlimit=50&format=json

### Page metadata

GET /api.php?action=query&titles=TITLE&prop=info|categories|images&format=json

### Example API response (TextExtracts)

Request: /api.php?action=query&titles=%D7%A9%D7%9C%D7%95%D7%9D&prop=extracts&explaintext=true&exintro=true&format=json

Response structure:
{
  "query": {
    "pages": {
      "12345": {
        "pageid": 12345,
        "ns": 0,
        "title": "שלום",
        "extract": "שלום הוא מילה עברית..."
      }
    }
  }
}

## Sitemap

Machine-readable sitemap index: https://ivritpedia.org/sitemap/sitemap-index-ivritpedia.xml
Regenerated on every deploy and daily at 5 AM UTC.

## Contributor Guidelines

- Editors must register with a valid email address
- New accounts require email verification before editing
- Autoconfirmed status (4 edits + 4 days): required for page moves and file uploads
- All contributions are permanently licensed under CC BY-SA 4.0

## Contact

- General inquiries: support@ivritpedia.org
- Security vulnerabilities: security@ivritpedia.org
- Security policy: https://ivritpedia.org/.well-known/security.txt