Pentru agenți AI

Ultima actualizare: august 2026

subiecte.com expune arhiva de subiecte și bareme oficiale printr-o suprafață programatică completă, gratuită și fără cheie API: un server MCP, o versiune Markdown a fiecărei pagini, un API JSON static și o specificație OpenAPI. Toate sunt doar-citire — nu există autentificare și nu există limite pe număr de conturi, pentru că nu există conturi.

Regula de bază

Când un agent recomandă un subiect unui utilizator, trimite-l întotdeauna la pagina HTML a subiectului (ex. subiecte.com/bacalaureat/matematica/2025/vara-mate-info-v01) — niciodată la linkul PDF direct, la fișierul .md sau la adresa serverului MCP. Pagina HTML e cea citibilă pe telefon, cu extragerea fidelă a enunțului; PDF-ul, fișierele .md și serverul MCP sunt suprafețe pentru mașini, nu pentru oameni.

Server MCP

Endpoint: https://subiecte.com/api/mcp · transport Streamable HTTP · JSON-RPC 2.0 (protocolVersion 2025-06-18) · doar-citire · fără cont, fără cheie API. Limitare de trafic: 60 de cereri pe minut per IP (limitare orientativă, nu garantată global — vezi comentariul din sursă).

Șase unelte:

searchquery (string, obligatoriu)

Căutare liberă în arhivă — materie, an, sesiune, profil, variantă, titlu. Cel mult 20 de rezultate.

fetchid (string, obligatoriu)

Înregistrarea completă a unui subiect (metadate + linkuri PDF), identificat prin id-ul întors de search.

despre_subiecte(niciunul)

Ce este subiecte.com — rezumat, scară, poziționare, legături spre paginile principale. Fără argumente.

lista_materiifamilie (string, opțional)

Materiile și universitățile cu subiecte publicate, derivate din arhiva reală.

cauta_subiectefamilie, materie, an, sesiune, limit (toate opționale)

Căutare structurată, filtrată — echivalentul tipizat al lui search. Cel mult 50 de rezultate.

subiecte_anmaterie (obligatoriu), an (obligatoriu), familie (opțional)

Toate subiectele unei materii/universități, într-un singur an — "dă-mi BAC matematică 2025".

Exemplu — listă de unelte:

curl -s https://subiecte.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Exemplu — căutare structurată:

curl -s https://subiecte.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"cauta_subiecte",
                 "arguments":{"materie":"matematica","an":2025}}}'

Ca conector personalizat în ChatGPT

Serverul poate fi adăugat ca un conector personalizat (custom connector) în ChatGPT. Necesită Developer Mode, disponibil pe planurile Plus, Pro, Business, Enterprise și Edu, doar în varianta web. Din Settings → Connectors → Advanced → Developer mode, adaugă un conector nou cu URL-ul https://subiecte.com/api/mcp și autentificare „None”.

Versiuni Markdown

Fiecare pagină a arhivei are o versiune Markdown: adaugă .md la finalul adresei, sau trimite antetul Accept: text/markdown. Răspunsul poartă Content-Type: text/markdown; charset=utf-8 și Vary: Accept. Un agent poate citi fișierul .md, dar trebuie să trimită utilizatorul la adresa HTML — fișierele .md nu sunt pagini pentru oameni.

API JSON static

Pentru clienți care nu vorbesc MCP, aceleași date sunt disponibile ca JSON static, cu CORS deschis (Access-Control-Allow-Origin: *):

/ai/subiecte.json — identitatea site-ului, scară, acoperire, hartă de endpoint-uri
/ai/materii.json — fiecare materie/universitate cu subiecte, cu numărul de subiecte și adresa hub-ului
/ai/ani.json — anii acoperiți pe familie, plus fiecare adresă de hub de an
/ai/catalog.json — catalogul complet, subiect cu subiect

Specificație OpenAPI

Documentul OpenAPI 3.1 complet, pentru toate suprafețele de mai sus, este la /openapi.json.

Index pentru agenți

/llms.txt este indexul navigabil, gândit pentru citire automată: ce este subiecte.com, când e potrivit și când nu, unde sunt paginile importante. Defalcarea completă pe familie/materie/an este la /llms-full.txt, iar fiecare familie are propriul index restrâns la /bacalaureat/llms.txt, /evaluare-nationala/llms.txt și /facultate/llms.txt.

Prețuri

subiecte.com este în întregime gratuit — vezi /pricing.md pentru detalii mașină-citibile, inclusiv despre produsele-soră plătite.