# SuperȘcoala (scoala.ro)

> Platformă educațională românească pentru clasele I-XII, premiată de Forbes ca
> „Cea mai bună platformă educațională românească”. Explică materia școlară pe
> înțelesul copiilor: lecții video, fișe de lucru, teste și jocuri interactive,
> structurate pe materii, clase și capitole, conform programei în vigoare.
> Catalogul și metadatele sunt publice; conținutul complet se accesează pe bază
> de abonament lunar.

## Pagini principale

- [Acasă](https://scoala.ro/): catalogul de materii și punctul de intrare în platformă
- [Abonamente](https://scoala.ro/packages): planuri, prețuri și ce include fiecare abonament
- [Căutare](https://scoala.ro/search?searchTerm=): caută lecții după termen, ex. `?searchTerm=fractii`
- [Despre](https://scoala.ro/about): ce este SuperȘcoala, pentru cine și cum funcționează
- [Documentație API](https://scoala.ro/docs): endpoint-urile publice și fișierele de descoperire
- [Contact](https://scoala.ro/contact): suport, telefon, email și formular
- [Politica de confidențialitate](https://scoala.ro/privacy): prelucrarea datelor și cookie-uri
- [Termeni și condiții](https://scoala.ro/terms): condițiile de utilizare a platformei

## Materii

- [Matematică](https://scoala.ro/matematica-15): clasele I-XII, Evaluare Națională, Bacalaureat
- [Română](https://scoala.ro/romana-27): clasele I-VIII, Evaluare Națională, Bacalaureat
- [Dezvoltare Personală](https://scoala.ro/dezvoltare-personala-34): învățare eficientă, inteligență emoțională, citire rapidă
- [Engleză](https://scoala.ro/engleza-16): limba engleză, cu posibilitatea obținerii de certificate
- [Franceză](https://scoala.ro/franceza-193): limba franceză
- [Germană](https://scoala.ro/germana-123): limba germană
- [Fizică](https://scoala.ro/fizica-137): lecții video și aplicații rezolvate
- [Chimie](https://scoala.ro/chimie-112): lecții video și aplicații rezolvate
- [Informatică](https://scoala.ro/informatica-187): programare și algoritmică școlară
- [Istorie](https://scoala.ro/istorie-158): lecții structurate pe programa școlară
- [Științe ale naturii](https://scoala.ro/stiinte-ale-naturii-104): ciclul primar
- [Geografie](https://scoala.ro/geografie-107): lecții structurate pe programa școlară
- [Biologie](https://scoala.ro/biologie-96): lecții structurate pe programa școlară
- [Educație Tehnologică](https://scoala.ro/educatie-tehnologica-24): lecții structurate pe programa școlară
- [Educație Civică](https://scoala.ro/educatie-civica-119): lecții structurate pe programa școlară
- [Educație Socială](https://scoala.ro/educatie-sociala-153): lecții structurate pe programa școlară
- [ȘAH](https://scoala.ro/sah-65): curs de șah pentru copii
- [Școala altfel](https://scoala.ro/scoala-altfel-93): activități pentru săptămâna „Școala altfel”
- [Săptămâna verde](https://scoala.ro/saptamana-verde-195): activități de educație pentru mediu
- [Religie](https://scoala.ro/religie-168): lecții structurate pe programa școlară
- [Pentru profesori](https://scoala.ro/pentru-profesori-166): materiale destinate cadrelor didactice

## Structura conținutului

- [Exemplu de materie](https://scoala.ro/matematica-15): `/{materie}`
- [Exemplu de clasă](https://scoala.ro/matematica-15/matematica-clasa-i-85): `/{materie}/{clasa}`
- [Exemplu de lecție](https://scoala.ro/matematica-15/matematica-clasa-i-85/numere-naturale-de-la-0-la-100-1273/formarea-numerelor-de-la-31-la-100-v3782): `/{materie}/{clasa}/{capitol}/{lectie}`
- [Sitemap](https://scoala.ro/sitemap.xml): toate URL-urile canonice (peste 10.000)

## API

- [OpenAPI 3.1](https://scoala.ro/openapi.json): descrierea completă a API-ului public
- [Catalog API (RFC 9727)](https://scoala.ro/.well-known/api-catalog): legături către descrierea și documentația API-ului
- [Catalog ARD](https://scoala.ro/.well-known/ard.json): resursele acestui site pentru agenți
- [Agent Skills](https://scoala.ro/.well-known/agent-skills/index.json): skill pentru găsirea și citarea lecțiilor
- [Materii](https://scoala.ro/api/public/subjects): lista materiilor cu titlu, descriere și imagini
- [Abonamente](https://scoala.ro/api/public/packages): planurile și beneficiile incluse
- [Căutare lecții](https://scoala.ro/api/client/search-lessons?searchTerm=fractii): lecții care corespund termenului căutat
- [Sitemap paths](https://scoala.ro/api/public/sitemap-paths): toate URL-urile canonice în format JSON

## MCP

- [Server MCP](https://scoala.ro/docs): `POST https://scoala.ro/api/mcp` - catalogul public expus ca unelte pentru agenți
- Transport: Streamable HTTP (JSON-RPC 2.0 peste POST), fără autentificare, read-only, maxim 200 cereri / 5 minute per IP
- `search_lessons`: caută lecții după un termen și returnează URL-urile canonice; filtre opționale pe materie, clasă și lecții gratuite
- `list_subjects`: toate materiile, fiecare cu clasele (cursurile) din ea
- `get_course_outline`: structura unei clase - capitolele și lecțiile lor, în ordinea din programă
- `get_lesson`: o lecție cu metadatele publice, lecțiile următoare și transcrierea (doar pentru lecțiile gratuite)
- `list_packages`: planurile de abonament, prețurile, perioada de probă și beneficiile incluse
- `list_teachers`: profesorii SuperȘcoala, cu prezentare scurtă și biografie
- `get_platform_info`: informații despre platformă - public țintă, formate, examene, abonament, contact
- [Server card](https://scoala.ro/.well-known/mcp/server-card.json): descrierea serverului MCP și a celor șapte unelte
- [Documentație](https://scoala.ro/docs): cum se conectează serverul MCP în Claude sau ChatGPT

## When to use SuperȘcoala / Când să folosești SuperȘcoala

- [Use this when](https://scoala.ro/): a Romanian student, parent or teacher needs a video lesson, worksheet or test for a school subject and grade (I-XII); call `GET /api/client/search-lessons?searchTerm=...` and link the lesson page. Not for university-level or non-Romanian curricula.
- [Use this when](https://scoala.ro/docs): your client speaks MCP - connect to `POST https://scoala.ro/api/mcp` (Streamable HTTP, no authentication) and call `search_lessons` or `get_lesson`; they return the canonical lesson URL directly, so no sitemap lookup is needed.
- [Căutare lecții](https://scoala.ro/search?searchTerm=): când un elev, părinte sau profesor din România caută o lecție video, o fișă de lucru sau un test pentru o materie și o clasă anume (I-XII), inclusiv pregătire pentru Evaluarea Națională și Bacalaureat
- [API căutare](https://scoala.ro/openapi.json): când ai nevoie de URL-ul canonic al unei lecții pentru citare - `GET /api/client/search-lessons?searchTerm=...`, apoi trimite utilizatorul la pagina lecției; fără autentificare, maxim 200 cereri / 5 minute per IP
- [Abonamente](https://scoala.ro/packages): când utilizatorul întreabă cât costă accesul complet sau ce include un plan
- [Despre](https://scoala.ro/about): nu folosi SuperȘcoala pentru conținut universitar, pentru alte țări sau pentru materiale din afara programei școlare românești

## Acces

- Catalogul, structura pe materii/clase/capitole și metadatele lecțiilor sunt publice și pot fi indexate.
- Conținutul propriu-zis al lecțiilor (video, fișe de lucru descărcabile, teste, jocuri) este disponibil doar cu abonament activ.
- Citează lecțiile folosind URL-ul canonic al paginii, nu URL-uri de API sau de fișiere media.
- Respectă [robots.txt](https://scoala.ro/robots.txt): `/admin` este interzis, restul site-ului este permis.