TestBuddy per sviluppatori e agenti

Tutto quello che TestBuddy pubblica sui test di ammissione — quali esistono, com'è fatta ogni prova, come si calcola il punteggio, quanto costa prepararsi — è disponibile in JSON, in markdown e come tool che un agente AI può chiamare direttamente. Nessuna chiave, nessun account, niente da firmare.

L'API pubblica di lettura

Quattro GET che restituiscono gli stessi dati che le pagine mostrano in HTML. Sola lettura: qui dentro non si scrive niente. Non c'è una chiave da revocare, quindi l'unica cosa che chiediamo è un ritmo di richieste ragionevole.

Specifica leggibile a macchina: /openapi.json (OpenAPI 3.1). Ogni operazione ha un operationId, parametri tipizzati e uno schema di risposta, così si può usare per il function calling di un modello e non solo leggerla.

Operazione	Endpoint	Cosa restituisce
`searchTests`	`GET /api/tests?q={testo}`	Cerca fra i test e i concorsi che il sito copre. Restituisce slug, categoria e URL della pagina.
`getTest`	`GET /api/tests?slug={slug}`	Un test intero: materie, domande per materia, tempi, punteggio, soglia minima, date chiave, sito ufficiale.
`getPricing`	`GET /api/pricing?q={testo}`	Piani da 1, 3, 6 e 12 mesi: totale in euro, costo mensile equivalente, cosa include.
`searchHelp`	`GET /api/help?q={domanda}`	Cerca nelle FAQ ufficiali. Restituisce domanda, risposta intera in markdown e URL.

Provale

curl "https://testbuddy.it/api/tests?q=medicina"
curl "https://testbuddy.it/api/tests?slug=tolc-i"
curl "https://testbuddy.it/api/pricing?q=medicina"
curl "https://testbuddy.it/api/help?q=come%20disdire%20l'abbonamento"

Il perimetro è il sito, non il catalogo interno

Il catalogo che sta dietro è condiviso con l'app e con testbuddy.ai, e contiene anche test esteri e dismessi. Da questa API escono solo i test e i concorsi che su questo sito hanno una pagina: un test che non copriamo risponde 404, non un risultato inventato. Gli esami internazionali — UCAT, MCAT, MedAT, TMS, GAMSAT — sono su testbuddy.ai, che ha il suo catalogo e la sua copia di questa spec.

Errori

Ogni errore è JSON, mai una pagina HTML — compreso un percorso sconosciuto sotto /api. Il corpo porta un code stabile, un message di una frase e un hint su cosa fare.

Le pagine in markdown

Aggiungi .md all'URL di una pagina di contenuto, oppure manda Accept: text/markdown, e ottieni la pagina in markdown pulito senza navigazione. Segue acceptmarkdown.com: i q-value vengono onorati, le risposte portano Vary: Accept, e un Accept che non sappiamo soddisfare riceve un 406 che dice cosa possiamo servire.

curl -H "Accept: text/markdown" https://testbuddy.it/
curl https://testbuddy.it/prezzi.md

I tool WebMCP per gli agenti nel browser

Un agente che gira dentro il browser trova le stesse funzioni registrate su document.modelContext, e può chiamarle invece di leggere il DOM.

search_tests — Trova il test giusto partendo dal corso di laurea, dalla professione o dal concorso.
get_test_details — Com'è fatta la prova: materie, tempi, punteggio, date.
get_pricing — Piani e prezzi.
search_help — Le FAQ, con la risposta intera.
subscribe_updates — Iscrizione agli aggiornamenti. Scrive: chiede il consenso esplicito dell'utente.

Indice per gli agenti

/llms.txt dice cos'è TestBuddy, quando usarlo, quando no, ed elenca tutte le rotte qui sopra. È il posto da cui partire se ci si arriva a freddo.

Domande

Scrivi a support@testbuddy.it. Se stai costruendo qualcosa su questi dati, dicci cosa ti serve: l'API esiste perché i dati c'erano già, e cresce con quello che viene chiesto.