Bzzoiro MCP con Gemini CLI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Bzzoiro Sports Data, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Bzzoiro Sports Data + Gemini

Dati di calcio da Bzzoiro Sports Data: campionati, classifiche e graduatorie dei giocatori, calendari e risultati in diretta, formazioni, gol e statistiche delle partite, squadre, rose e forma, giocatori e le loro statistiche partita per partita, allenatori, trasmissioni TV e una valutazione della partita basata su un modello. Token API gratuito.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

BZZOIRO_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account gratuito su Bzzoiro Sports Data: per il calcio non serve un piano a pagamento.

1. Registrati gratis su sports.bzzoiro.com/register e copia il token API dalla pagina del tuo account.
2. Incollalo in BZZOIRO_API_KEY. Solo il token, senza la parola Token davanti: il connettore lo invia da solo come Authorization: Token <key>.
3. Installa il connettore e verifica la connessione con bzzoiro_list_leagues.

Cloud e self-hosting funzionano allo stesso modo: il connettore ha bisogno solo del tuo token.

Gratis entro i limiti: il calcio è gratuito entro i limiti pubblicati da Bzzoiro: 7.500 richieste al giorno per account, azzerate a mezzanotte UTC, più un limite di picco di circa 25 richieste al secondo.

Risultati in diretta: bzzoiro_list_live_matches copre le partite da cinque minuti prima del calcio d'inizio fino a poco dopo il fischio finale. Bzzoiro aggiorna i dati circa ogni 30 secondi; non interrogarli più spesso di ogni 10 secondi.

Formazioni: vengono confermate circa un'ora prima del calcio d'inizio. Prima di allora lineup_status indica che sono stimate dal modello di Bzzoiro.

Id: campionati, stagioni, squadre, partite (chiamate events nell'API), giocatori e allenatori hanno id interi. L'AI li trova con bzzoiro_list_leagues, bzzoiro_list_league_seasons, bzzoiro_list_teams, bzzoiro_list_players e bzzoiro_list_managers; gli id delle partite arrivano da bzzoiro_list_matches, bzzoiro_list_live_matches e bzzoiro_list_team_fixtures.

Orari e paginazione: tutti gli orari sono in UTC (ISO 8601), quindi un orario di inizio va convertito prima di citarlo. I filtri per data accettano YYYY-MM-DD o un timestamp completo. Le liste si sfogliano con limit (fino a 200) e offset. Senza date, bzzoiro_list_team_fixtures e bzzoiro_list_broadcasts coprono da tre ore fa a sette giorni avanti.

Valutazione della partita: bzzoiro_get_match_outlook restituisce la valutazione di Bzzoiro basata su un modello per una partita, ad esempio per la presentazione di un match. È una stima statistica, mai una certezza.

Errori comuni: 401 vuol dire che Bzzoiro ha rifiutato il token: copialo di nuovo dal tuo account e incolla solo il token. 403 vuol dire che il piano del token non include la risorsa: il calcio è gratuito, gli altri sport richiedono un piano a pagamento. 429 con taster_exhausted vuol dire che la quota del giorno è esaurita; con rate_limited basta rallentare per un secondo. 400 vuol dire che un filtro è sconosciuto: Bzzoiro lo rifiuta invece di ignorarlo.

Solo calcio: gli altri sport di Bzzoiro non fanno parte di questo connettore. I dati possono arrivare in ritardo o essere incompleti; verificali prima di farci affidamento.

Cosa legge: campionati e coppe con stagioni e fasi; classifiche e graduatorie di gol, assist, cartellini gialli e rossi e falli; calendari e risultati con orario di inizio, stato, punteggio, giornata e fase; partite in corso con punteggio e minuto; per ogni partita formazioni e moduli, gol con marcatore e assist, cartellini, sostituzioni e decisioni VAR, statistiche di squadra compresi gli xG, statistiche dei singoli giocatori e i precedenti tra le due squadre; squadre con rosa, infortuni e rientro previsto, e la loro forma nelle ultime partite; profili dei giocatori e statistiche partita per partita; allenatori con bilancio e profilo tattico; i canali TV che trasmettono una partita; e la valutazione di Bzzoiro basata su un modello per una partita.

Sola lettura: ogni tool legge soltanto, quindi non c'è nulla da confermare e nessun tool è disattivato all'installazione.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Bzzoiro Sports Data.

Tool disponibili

Esempi di prompt

• "Mostrami la classifica attuale della Premier League e i 10 migliori marcatori."
• "Quando gioca il Benfica la prossima partita, e quali canali TV in Portogallo la trasmettono?"
• "Quali partite di Serie A sono in corso adesso, qual è il punteggio e chi ha segnato?"
• "Le formazioni della prossima partita del Real Madrid sono già confermate? Mostrami modulo e undici titolare."
• "Confronta la forma di Inter e Juventus nelle ultime 10 partite di Serie A ed elenca partita per partita i gol e gli assist di Lautaro Martínez in questa stagione."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude