Costruisci su Sporfie
Un’API REST e un server MCP per gli eventi, i video e le dirette che la tua organizzazione già gestisce su Sporfie. Crea eventi dal tuo sistema di prenotazione, invia i punteggi live, taglia gli highlights, ricevi webhook — o chiedi semplicemente al tuo assistente IA.
Funziona negli strumenti IA che usi già
Sporfie fornisce un server MCP che espone l’API pubblica come 19 strumenti selezionati. Collegalo una volta e chiedi in linguaggio naturale. Ogni chiamata a uno strumento è una normale chiamata API — stessi identificatori, stessi permessi, stessi limiti.
- Claude
- ChatGPT
- Grok Bot
- Cursor
- e qualsiasi altro client compatibile MCP
Trasporto Streamable HTTP. Gli strumenti del centro assistenza funzionano senza token.
Connessione in un clic
Aggiungi il server senza header e il tuo client avvia il flusso OAuth standard di MCP: accedi a Sporfie una volta, approva la connessione, fatto. Nessuna chiave da copiare.
Oppure usa la tua chiave
Per CLI, CI e script, crea una chiave personale in Impostazioni → Sviluppatore e passala come header Bearer. La stessa chiave funziona anche per le chiamate REST dirette.
Gestisci le chiavi APICosa coprono gli strumenti
Creare, leggere, aggiornare, chiudere ed eliminare eventi · ricerca ed evento in corso · luoghi e sport · momenti salienti · webhook degli eventi · ricerca nel centro assistenza.
Chiedi invece di integrare
Tre conversazioni che usano soltanto strumenti realmente esposti dal server MCP di Sporfie.
Fatto — ho letto 6 partite dalla foto e le ho programmate sui tuoi campi con telecamera:
- Sab 09:00 · U14 Tigers – Falcons · Campo 1
- Sab 10:30 · U16 Tigers – Ravens · Campo 1
- Sab 12:00 · U19 Tigers – Bulls · Campo 2
- + altre 3 domenica
Ognuna si registra e va in diretta automaticamente all’inizio. Vuoi che aggiunga un webhook così il tuo sito si aggiorna quando partono?
Ecco cosa ho trovato sulla finale della Spring Cup (26 apr, Campo 1):
La più vista: il match point a 2:31:07, con 412 visualizzazioni.
Le visualizzazioni sono contate per clip highlight. L’API non riporta gli spettatori della diretta.
La finale U19 è programmata sabato dalle 14:00 alle 16:00 sul Campo 2, quindi l’evento è pronto. Gli URL RTMP vengono assegnati per encoder dentro Sporfie, non tramite l’API. La via più rapida:
- Apri Impostazioni → Encoder e aggiungi la tua GoPro (o selezionala).
- Copia il suo URL RTMP nell’app GoPro.
- Oppure mostra il QR code GoPro e scansionalo con la camera — lo stream si configura da solo.
Conversazioni a scopo illustrativo. La formulazione varia in base all’assistente; le chiamate agli strumenti sono reali.
Cosa puoi costruire
Tutto quanto segue è già nella specifica OpenAPI pubblica — niente roadmap.
Eventi con i tuoi ID
Crea, aggiorna, chiudi ed elimina eventi. Indirizzali con il tuo externalID così il tuo sistema resta la fonte di verità.
Registrazione programmata
Collega un evento a un luogo dotato di telecamere con ora di inizio e fine: si registra e va in diretta da solo.
Punteggi live
Invia un flusso di punteggio dalla tua app o dal tuo dispositivo; tabellone ed evento seguono.
Highlights su richiesta
Registra un clic a un istante e Sporfie taglia una clip intorno — da un pulsante, un sensore o la tua logica.
Webhook
Segui un evento e ricevi l’oggetto completo a ogni modifica. Meglio del polling.
Momenti, reel e segnalibri
Leggi URL e visualizzazioni delle clip, gestisci reel e raccolte di segnalibri, esporta le clip taggate.
Incorpora il player
Il player Sporfie si inserisce in qualsiasi pagina come iframe.
Cinque chiamate coprono la maggior parte delle integrazioni
Prese direttamente dalla documentazione. Imposta SPORFIE_TOKEN, COMPANY_KEY e PLACE_KEY nel tuo ambiente e girano così come sono.
curl -X POST "https://api.sporfie.com/public/events/booking-48213" \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
-H "Content-Type: application/json" \
-d @- <<JSON
{
"companyKey": "$COMPANY_KEY",
"name": "U16 semi-final",
"sport": "volleyball",
"homeTeam": "Tigers",
"awayTeam": "Falcons",
"placeKey": "$PLACE_KEY",
"scheduledStartTime": 1757683200000,
"scheduledEndTime": 1757690400000
}
JSON
# → { "eventKey": "-Nq7xK2mBv9pL3aRt8Zc" }›Verifica prima la tua chiave
curl -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
https://api.sporfie.com/public/sports
# 200 means the key works. 401 means it doesn't.Come funziona l’accesso
Crea una chiave personale
In Impostazioni → Sviluppatore. Il segreto viene mostrato una sola volta — conservalo in un gestore di segreti.
Agisce per tuo conto
Una chiave raggiunge le organizzazioni che amministri e può essere limitata ad alcune alla creazione. Ogni chiamata è verificata rispetto alla tua appartenenza attuale.
Chiama l’API o collega MCP
REST su api.sporfie.com, strumenti su mcp.sporfie.com — stessa chiave, stesso ambito, stessi limiti.
Devi gestire organizzazioni che non amministri? Serve una chiave di integrazione rilasciata da Sporfie.
Parla con noiBuono a sapersi
- Circa 1 richiesta al secondo per chiave. Distribuisci le operazioni massive e rallenta in caso di 429.
- Tutti i tempi sono millisecondi UTC dall’epoca Unix.
- I watch sugli eventi scadono dopo 12 ore — registrali di nuovo periodicamente.
- Un clic viene accettato, non completato: le clip richiedono qualche secondo. Interroga il momento se ti serve il file.
- Le chiavi restano lato server. Mai in un browser, in un’app mobile o in un repository.
Inizia a costruire
La documentazione completa, la specifica OpenAPI e una guida scritta per gli agenti IA sono su docs.sporfie.com.
Guida per gli agenti IA