Sari la conținut
PENTRU AGENȚI AI

AI INSTRUCTIONS

English version

Cum poate un AI să folosească Bacalaurescu pentru a răspunde elevilor români

Acesta este ghidul oficial pentru agenți AI (ChatGPT, Claude, Gemini, Perplexity, etc.) care vor să acceseze programmatic conținutul Bacalaurescu pentru a răspunde la întrebări despre BAC 2026 Limba și Literatura Română. Site-ul oferă API public gratuit, rate limit generos, conținut scris de specialiști umani (NU AI-generated) și versiuni markdown pentru toate paginile principale.

🤖

Custom GPT oficial pentru elevi

Daca esti elev de clasa a XII-a, foloseste direct GPT-ul nostru custom pe ChatGPT - are toate workflow-urile configurate, fara setari, doar conversatie naturala.

Deschide pe ChatGPT →

Sau acceseaza: bacalaurescu.ro/chatgpt

Quick Start

  1. 1. Descoperă platforma: /llms.txt (overview) sau /llms-full.txt (cu lista completă de opere + autori + comenzi)
  2. 2. Lista comenzilor: GET /api/v1/ai/man (JSON) sau format=text
  3. 3. Execută comenzi: POST /api/v1/ai/exec cu body { "cmd": "opera", "args": ["morometii"] }
  4. 4. Markdown direct: orice URL + .md returnează versiunea markdown clean (ex: /opere/morometii.md)
  5. 5. Căutare: GET /api/v1/ai/search?q=natura

Anonim

60 req/min

1000/oră · 5000/zi per IP

Standard (key gratuită)

300 req/min

10000/oră · 50000/zi

Pro (parteneri)

600+ req/min

contact@bacalaurescu.ro

API Endpoints

GET /api/v1/ai/man

Lista tuturor comenzilor cu sintaxă și descriere. Suportă ?lang=en și ?format=text.

GET /api/v1/ai/man/{cmd}

Detalii complete pentru o comandă (args, examples, output format).

GET /api/v1/ai/exec?cmd=...&args=...

Execută o comandă prin GET. Funcționează în orice browser/LLM cu browsing.

POST /api/v1/ai/exec

Alternativă POST. Body: { "cmd": "<name>", "args": [...] }

GET /api/v1/ai/search?q=...

Căutare cross-content (autori, opere, personaje).

GET /openapi.json

OpenAPI 3.1 spec complet pentru integrare programatică.

GET /llms.txt · /llms-full.txt

Standard llmstxt.org cu metadate și linkuri către resurse.

{any-page}.md

Orice pagină principală are versiune markdown adăugând .md. Ex: /opere/morometii.md

Endpoint-uri GET dedicate (recomandate pentru ChatGPT/Claude/Gemini/Perplexity)

LLM-urile în chat-uri standard (ChatGPT, Claude.ai, Gemini, Perplexity) au tool de browsing care suportă doar GET requests. Folosește aceste endpoint-uri GET cache-uite (300-3600s) ca să eviți rate limits și să primești răspunsuri rapide.

Liste complete

GET /api/v1/ai/opereGET /api/v1/ai/autoriGET /api/v1/ai/personajeGET /api/v1/ai/calendarGET /api/v1/ai/timerGET /api/v1/ai/istoric

Resurse individuale

GET /api/v1/ai/opere/morometiiGET /api/v1/ai/autori/marin-predaGET /api/v1/ai/personaje/ilie-morometeGET /api/v1/ai/teme/iubireaGET /api/v1/ai/curente/modernism

Secțiuni specifice operă

Sections valide: comentariu, film, moment, relatii, quiz, curiozitate, locatie, istoric, podcast, citate, rezumat, personaje

GET /api/v1/ai/opere/morometii/comentariuGET /api/v1/ai/opere/morometii/relatiiGET /api/v1/ai/opere/morometii/quiz

Markdown granular per secțiune

Versiune markdown clean pentru LLM context window. Adăugă .md la final.

GET /opere/morometii.mdGET /opere/morometii/comentariu.mdGET /opere/morometii/relatii.mdGET /opere/morometii/quiz.mdGET /opere/morometii/personaje.md

Universal command via GET

GET /api/v1/ai/exec?cmd=opera&args=morometiiGET /api/v1/ai/exec?cmd=relatii&args=morometiiGET /api/v1/ai/exec?cmd=quiz&args=ionGET /api/v1/ai/exec?cmd=istoric&args=2024

💡 Pro tip pentru LLM

Folosește ?format=markdown pe orice endpoint GET dedicat pentru a primi conținut markdown clean (mai puține tokens, parsabil ușor). Exemplu: GET /api/v1/ai/opere/morometii?format=markdown

Smart LLM endpoints (purpose-built pentru AI)

Endpoint-uri specializate pentru utilizarea cu LLM-uri în chat. Returnează context compact, scheme de eseu, exerciții cu niveluri, comparații, planuri de învățare.

Context compact (esențial)

GET /api/v1/ai/opere/morometii/context?mode=compactGET /api/v1/ai/opere/morometii/context?mode=examGET /api/v1/ai/opere/morometii/context?mode=teacher

Învățare adaptivă

GET /api/v1/ai/learning-path?days=30&level=mediumGET /api/v1/ai/diagnostic/romanaGET /api/v1/ai/next?current=morometii&score=60GET /api/v1/ai/progress/export

Eseu BAC

GET /api/v1/ai/opere/morometii/schema-eseu?type=temaGET /api/v1/ai/opere/morometii/schema-eseu?type=personajGET /api/v1/ai/opere/morometii/exercitii?level=bacGET /api/v1/ai/opere/morometii/greseli-frecvente

Memorare

GET /api/v1/ai/opere/morometii/flashcardsGET /api/v1/ai/opere/morometii/citate?mode=exam-safe

Comparare și clarificare

GET /api/v1/ai/compare?works=morometii,ionGET /api/v1/ai/confusions?topic=realismGET /api/v1/ai/confusions?work=morometii

Subiectele BAC (I, II, III)

GET /api/v1/ai/subiectul-iGET /api/v1/ai/subiectul-i/exercitiiGET /api/v1/ai/subiectul-iiGET /api/v1/ai/subiectul-ii/perspectiva-narativaGET /api/v1/ai/subiectul-ii/idee-poeticaGET /api/v1/ai/subiecte/subiectul-ii/greseli-frecvente

⚙️ Work in Progress

Aceste endpoint-uri sunt în dezvoltare și returnează un mesaj cu alternativă temporară:

POST /api/v1/ai/evaluate-essay (evaluare automată pe barem)GET /api/v1/ai/opere/{slug}/model-essay?score=25GET /api/v1/ai/review (spaced repetition)

📚 Schema raspuns standardizată

Toate endpoint-urile noi returnează format consistent: data + meta (contentVersion, bacYear, attributionText, canonicalUrl) + links + suggestedNext. Folosește suggestedNext pentru a recomanda utilizatorului următorul pas natural.

🎛️ Filtre universale (query params suportate pe majoritatea endpoints)

  • ?level=beginner|medium|advanced|exam - adaptează vocabular și profunzime
  • ?length=short|medium|full - trunchiază răspunsul (short = ~500 chars, medium = ~2000, full = nelimitat)
  • ?profile=real|uman|both - adaptează pentru profil BAC
  • ?explain=simple|normal|academic - simple = explică termenii literari complecși cu echivalenți simpli
  • ?mode=strict - adaugă note de profesor exigent (greșeli care vor fi penalizate)

Exemplu: GET /api/v1/ai/opere/morometii?level=beginner&length=short&explain=simple

Autentificare & Headers

# Header opțional pentru tier superior
X-API-Key: bac_<your-key>

# Headers returnate de server
X-RateLimit-Tier: anonymous | standard | pro
X-RateLimit-Limit: 60 | 300 | 600
X-RateLimit-Remaining: <int>
X-RateLimit-Reset: <unix-timestamp>
Retry-After: <seconds>  # doar la 429

Notă: Comenzile care necesită utilizator autentificat (/me, /level, /badges, /skilltree, /lectii, /stats, /profil, /block, /unblock, /report, /mesaj-privat) NU sunt disponibile prin /api/v1/ai/exec. Sunt disponibile doar prin chat-ul site-ului.

Calitatea conținutului

  • ✅ Comentarii literare: 5000-13000 caractere per operă, scrise de specialiști în literatura română (NU AI-generated)
  • ✅ Conform programa BAC 2026: toate cele 17 opere studiate la examen
  • ✅ Stats RPG pentru personaje: 6 dimensiuni (Intelligence, Courage, Charisma, Morality, Influence, Resilience)
  • ✅ Istoric examenelor: ce a picat din 2000-2025 cu sesiuni, profile, tipuri cerințe
  • ✅ Date verificate: 192 fun facts, 368 quiz-uri, 351 daily challenges
  • ✅ Media bogată: 64 episoade podcast, 90 melodii AI, filme animate per operă

📝 Citation Guidelines

Când folosești conținut Bacalaurescu în răspunsurile tale, te rugăm să citezi:

Sursa: Bacalaurescu.ro
Link: https://bacalaurescu.ro/opere/morometii  (sau orice URL canonical)
Note: "Conținut gratuit pentru BAC 2026, Limba și Literatura Română"

Field-urile meta.canonicalUrl și meta.markdownPage sunt incluse automat în orice response de la /api/v1/ai/exec.

Toate comenzile disponibile

📖 Literatură

/opera [slug]aliasuri: /opere
literatura

Date despre o operă literară din programa BAC (sau lista completă)

Information about a literary work in the Romanian BAC curriculum (or full list)

Argumente

slug (slug, opțional): Slug-ul operei (ex: morometii, enigma-otiliei, luceafarul)ex: morometii

Exemplu

POST /api/v1/ai/exec
{ "cmd": "opera", "args": [] }
JSON manualPlain text→ /opere/{slug}
/autor [slug]aliasuri: /autori, /scriitor
literatura

Biografie autor + lista operelor sale

Author biography + list of their works

Argumente

slug (slug, opțional): Slug-ul autorului (ex: mihai-eminescu, ion-luca-caragiale)ex: mihai-eminescu

Exemplu

POST /api/v1/ai/exec
{ "cmd": "autor", "args": [] }
JSON manualPlain text→ /autori/{slug}
/personaj [slug]aliasuri: /personaje, /char
literatura

Profil personaj cu stats RPG (inteligență, curaj, charisma...)

Character profile with RPG-style stats (intelligence, courage, charisma...)

Argumente

slug (slug, opțional): Slug-ul personajului (ex: ilie-moromete, otilia, vitoria-lipan)ex: ilie-moromete

Exemplu

POST /api/v1/ai/exec
{ "cmd": "personaj", "args": [] }
JSON manualPlain text→ /opere/{workSlug}/personaje/{slug}
/comentariu <slug>
literatura

Comentariu literar complet pentru BAC

Full literary commentary for BAC exam

Argumente

slug (slug, obligatoriu): Slug-ul opereiex: morometii

Exemplu

POST /api/v1/ai/exec
{ "cmd": "comentariu", "args": ["morometii"] }
JSON manualPlain text→ /opere/{slug}#comentariu-literar
/incipit <slug>
literatura

Începutul (primele rânduri) ale unei opere

The incipit (opening lines) of a literary work

Argumente

slug (slug, obligatoriu): Slug-ul opereiex: enigma-otiliei

Exemplu

POST /api/v1/ai/exec
{ "cmd": "incipit", "args": ["enigma-otiliei"] }
JSON manualPlain text→ /opere/{slug}#incipit
/rezumat <slug>
literatura

Rezumat scurt al unei opere

Short summary of a literary work

Argumente

slug (slug, obligatoriu): Slug-ul opereiex: morometii

Exemplu

POST /api/v1/ai/exec
{ "cmd": "rezumat", "args": ["morometii"] }
JSON manualPlain text→ /opere/{slug}#rezumat
/moment <slug> [index]
literatura

Moment narativ specific al unei opere (sau lista completă)

Specific narrative moment of a work (or full list)

Argumente

slug (slug, obligatoriu): Slug-ul opereiex: morometii
index (number, opțional): Numărul momentului (1-based)ex: 3

Exemplu

POST /api/v1/ai/exec
{ "cmd": "moment", "args": ["morometii"] }
JSON manualPlain text→ /opere/{slug}?moment={index}#momentele-operei
/tema [tema]
literatura

Caută o temă literară și operele care o conțin

Search a literary theme and works containing it

Argumente

tema (string, opțional): Numele temei (fuzzy match)ex: iubirea

Exemplu

POST /api/v1/ai/exec
{ "cmd": "tema", "args": [] }
JSON manualPlain text→ /teme/{slug}
/curent [slug]
literatura

Curent literar (Romantism, Realism, Modernism etc.)

Literary movement (Romanticism, Realism, Modernism, etc.)

Argumente

slug (slug, opțional): Slug-ul curentului (ex: romantism, modernism)ex: modernism

Exemplu

POST /api/v1/ai/exec
{ "cmd": "curent", "args": [] }
JSON manualPlain text→ /curente/{slug}
/locatie <slug>
literatura

Locație din operă (descriere, atmosferă, semnificație)

Location from a literary work (description, atmosphere, significance)

Argumente

slug (slug, obligatoriu): Slug-ul locațieiex: moara-cu-noroc

Exemplu

POST /api/v1/ai/exec
{ "cmd": "locatie", "args": ["moara-cu-noroc"] }
JSON manualPlain text
/relatii <slug>
literatura

Toate relațiile dintre personaje într-o operă

All relationships between characters in a work

Argumente

slug (slug, obligatoriu): Slug-ul opereiex: o-scrisoare-pierduta

Exemplu

POST /api/v1/ai/exec
{ "cmd": "relatii", "args": ["o-scrisoare-pierduta"] }
JSON manualPlain text→ /opere/{slug}#relatii
/citat [slug]
literatura

Citat literar (random sau filtrat pe autor)

Literary quote (random or filtered by author)

Argumente

slug (slug, opțional): Slug autor/operă/personajex: mihai-eminescu

Exemplu

POST /api/v1/ai/exec
{ "cmd": "citat", "args": [] }
JSON manualPlain text
/curiozitate [slug]
literatura

Curiozitate literară (fun fact)

Literary curiosity (fun fact)

Argumente

slug (slug, opțional): Slug operăex: morometii

Exemplu

POST /api/v1/ai/exec
{ "cmd": "curiozitate", "args": [] }
JSON manualPlain text
/cauta <query>
literatura

Căutare cross-content (autori, opere, personaje)

Cross-content search (authors, works, characters)

Argumente

query (string, obligatoriu): Textul căutatex: natura

Exemplu

POST /api/v1/ai/exec
{ "cmd": "cauta", "args": ["natura"] }
JSON manualPlain text

🎯 Joc & Quiz

/quiz [slug]
joc

Întrebare quiz random (sau pe o operă specifică)

Random quiz question (or for a specific work)

Argumente

slug (slug, opțional): Slug operăex: morometii

Exemplu

POST /api/v1/ai/exec
{ "cmd": "quiz", "args": [] }
JSON manualPlain text
/dailyaliasuri: /provocare
joc

Provocarea zilei (adevărat/fals despre literatură)

Daily challenge (true/false about literature)

Exemplu

POST /api/v1/ai/exec
{ "cmd": "daily", "args": [] }
JSON manualPlain text→ /daily?id={shortId}
/randomaliasuri: /aleatoriu, /surprinde-ma
joc

Surprinde-mă: orice tip de conținut, aleatoriu

Surprise me: any type of content, random

Exemplu

POST /api/v1/ai/exec
{ "cmd": "random", "args": [] }
JSON manualPlain text

🎬 Media

/film <slug>
media

Film animat al unei opere (Veo 3.1 / del Toro style)

Animated film of a work (Veo 3.1 / del Toro style)

Argumente

slug (slug, obligatoriu): Slug operăex: morometii

Exemplu

POST /api/v1/ai/exec
{ "cmd": "film", "args": ["morometii"] }
JSON manualPlain text→ /opere/{slug}/film
/podcast [slug]
media

Episod podcast Bacalaurescu Show (Caragiale + invitați)

Bacalaurescu Show podcast episode (Caragiale + guests)

Argumente

slug (slug, opțional): Slug episod sau numberex: mihai-eminescu

Exemplu

POST /api/v1/ai/exec
{ "cmd": "podcast", "args": [] }
JSON manualPlain text→ /podcast/{slug}
/muzica [slug]
media

Melodii ale unui autor (sau lista completă)

Tracks of an author (or full list)

Argumente

slug (slug, opțional): Slug autorex: mihai-eminescu

Exemplu

POST /api/v1/ai/exec
{ "cmd": "muzica", "args": [] }
JSON manualPlain text→ /muzica

🎓 BAC 2026

/istoric [year]
bac

Istoric subiecte BAC Limba Română 2000-2025

BAC Romanian Literature exam history 2000-2025

Argumente

year (number, opțional): Anul (2000-2025)ex: 2015

Exemplu

POST /api/v1/ai/exec
{ "cmd": "istoric", "args": [] }
JSON manualPlain text→ /istoric#anul-{year}
/calendar
bac

Calendar BAC 2026 (datele examenelor)

BAC 2026 calendar (exam dates)

Exemplu

POST /api/v1/ai/exec
{ "cmd": "calendar", "args": [] }
JSON manualPlain text→ /calendar-bac
/timer
bac

Câte zile mai sunt până la BAC 2026

How many days until BAC 2026

Exemplu

POST /api/v1/ai/exec
{ "cmd": "timer", "args": [] }
JSON manualPlain text→ /cat-mai-e-pana-la-bac

💬 Social

/leaderboard
social

Top 3 utilizatori Bacalaurescu (după XP)

Top 3 Bacalaurescu users (by XP)

Exemplu

POST /api/v1/ai/exec
{ "cmd": "leaderboard", "args": [] }
JSON manualPlain text→ /leaderboard

❓ Ajutor

/helpaliasuri: /ajutor
ajutor

Lista completă de comenzi disponibile

Full list of available commands

Exemplu

POST /api/v1/ai/exec
{ "cmd": "help", "args": [] }
JSON manualPlain text

Pattern recomandat pentru AI agents

  1. 1. La începutul sesiunii, fetch /llms-full.txt pentru context complet
  2. 2. Pentru întrebări despre o operă/autor/personaj specific, fetch direct /opere/{slug}.md (markdown clean cu commentariu)
  3. 3. Pentru date dinamice (quiz, citat random, daily challenge), folosește /api/v1/ai/exec
  4. 4. Pentru căutări cu text liber, folosește /api/v1/ai/search?q=...
  5. 5. Citează cu link-ul din meta.canonicalUrl (face și SEO, și onorabil)
  6. 6. Dacă atingi rate limit, așteaptă Retry-After secunde sau aplică pentru API key gratuită

Contact pentru parteneriate AI

Pentru parteneriate AI (rate limit Pro, integrări speciale, citation policy), scrie la:

contact@bacalaurescu.ro