Guia · Futebol brasileiro

API do Brasileirão para agentes de IA: cobertura, limites e como conectar

Uma API do Brasileirão para agentes de IA é uma camada de dados do Campeonato Brasileiro que um agente consulta sozinho, em linguagem natural ou por comando, para responder sobre tabela, jogos, escalações e estatísticas. A Machina distribui essa camada como skill aberta: código aberto, sem chave de API e sem cadastro.

Por Machina SportsAtualizado em 2026-07-287 min de leitura

O que é uma API do Brasileirão para agentes de IA?

É a diferença entre um endpoint que devolve JSON e uma camada que um agente sabe usar sozinho. Uma API tradicional exige que alguém leia a documentação, escolha a rota, monte a chamada e trate a resposta. Uma skill de agente carrega essa instrução junto com os dados: o agente descobre qual comando serve para a pergunta, resolve o time e a rodada pelo nome e devolve o resultado já formatado para virar resposta.

Na prática isso muda quem escreve o código. Em vez de um desenvolvedor integrar cada rota, o agente decide em tempo de execução — e a mesma camada serve para um chat de torcedor, um gerador de prévia de jogo e um painel interno de redação.

Quais dados do Campeonato Brasileiro estão disponíveis hoje?

O skill football-data do sports-skills trata o Brasileirão como liga de primeira classe (chave serie-a-brazil), com os 20 clubes da Série A e três fontes combinadas por comando.

Tabela e classificação da temporada, por rodada, com pontos, jogos, saldo e aproveitamento.
Calendário completo da temporada, jogos do dia e calendário por clube.
Elenco e lista de times da temporada, além de busca de time por nome.
Escalações confirmadas, estatísticas da partida e linha do tempo dos lances.
Perfil e histórico do clube, resumo de partida encerrada.
Valores de mercado e histórico de transferências dos jogadores, via Transfermarkt.

O que ainda não é coberto, e por quê

Vale mais dizer isso do que descobrir depois. Três limites valem para o Brasileirão hoje:

xG e estatísticas avançadas por jogador não existem para o Brasileirão — a fonte de xG cobre apenas as cinco grandes ligas europeias.
Artilharia consolidada e notícias de lesão vêm de uma fonte exclusiva da Premier League; nas demais ligas esses comandos voltam vazios.
Não é feed ao vivo. Os dados atualizam depois da partida — para narração em tempo real é preciso outra fonte.

Como conectar o Brasileirão a um agente de IA

Quatro passos, sem cadastro e sem chave de API.

Instale a biblioteca
pip install sports-skills — o pacote é código aberto e não pede credencial de nenhuma das fontes.
Chame um comando
sports-skills football get_season_standings --season_id=serie-a-brazil-2026 devolve a tabela da temporada. O identificador de temporada é sempre a chave da liga mais o ano.
Entregue a skill ao agente
Cada skill traz um arquivo SKILL.md com quando usar, quando não usar e a referência dos comandos. É esse arquivo que o agente lê para decidir sozinho.
Suba para produção quando precisar
Agente rodando de verdade pede orquestração, regras de marca, aprovação e telemetria — é onde entra a plataforma, não a skill solta.

Skill aberta ou plataforma: quando cada uma faz sentido

A skill resolve o acesso ao dado. Ela não resolve o que acontece depois: quem aprova o texto antes de publicar, como manter voz de marca em escala, o que fazer quando a fonte cai, como medir custo por conteúdo gerado e como distribuir o mesmo agente em site, app e mensageria.

Para protótipo, análise pontual ou projeto interno, a skill basta e é gratuita. Para operação — clube, portal, casa de apostas — o gargalo deixa de ser o dado e passa a ser o fluxo em volta dele.

Skill aberta, plataforma e API tradicional

Arraste para comparar →

	Skill aberta (sports-skills)	API tradicional de dados	Plataforma Machina
Custo de entrada	Gratuito, código aberto	Plano por volume de chamadas	Sob consulta
Chave de API	Não precisa	Obrigatória	Gerenciada
Feito para agente	Sim — instrução junto do dado (SKILL.md)	Não — só o endpoint	Sim — MCP, SDK e API
Cobertura do Brasileirão	Tabela, jogos, elencos, escalações, estatísticas, transferências	Varia por fornecedor	A mesma, mais as fontes do cliente
Dados ao vivo	Não — atualiza pós-jogo	Depende do plano	Depende da fonte contratada
Fluxo de produção	Você monta	Você monta	Aprovação, voz de marca, telemetria e distribuição inclusas

Cobertura conferida em julho de 2026 na matriz do skill football-data.

Perguntas frequentes

Existe uma API do Brasileirão gratuita para desenvolvedores?

Sim. O sports-skills, da Machina, é código aberto e cobre o Campeonato Brasileiro sem chave de API e sem cadastro. Instala com pip, roda por linha de comando ou dentro de um agente, e devolve tabela, calendário, elencos, escalações e estatísticas de partida da Série A.

Quais dados do Brasileirão o sports-skills entrega?

Classificação da temporada, calendário completo e jogos do dia, elenco e lista de clubes, busca de time, escalações confirmadas, estatísticas e linha do tempo da partida, perfil do clube e valores de mercado dos jogadores via Transfermarkt. Tudo pela chave de liga serie-a-brazil.

Os dados do Brasileirão são ao vivo?

Não. A atualização acontece depois da partida, não lance a lance. Para prévia, recapitulação, tabela, escalação e análise pós-jogo o dado serve; para narração em tempo real é preciso combinar com uma fonte de tempo real, o que a plataforma faz via conectores.

Tem xG do Brasileirão?

Não. A fonte de xG usada pelo skill cobre apenas Premier League, La Liga, Bundesliga, Serie A italiana e Ligue 1. Os comandos de xG existem, mas retornam vazio para o Brasileirão — assim como artilharia consolidada e notícia de lesão, exclusivas da Premier League.

Como conectar o Brasileirão a um agente de IA ou a um cliente MCP?

Instale o pacote, chame um comando com o identificador da temporada (serie-a-brazil mais o ano) e entregue o arquivo SKILL.md ao agente. É esse arquivo que descreve quando usar cada comando, então o agente escolhe sozinho a chamada certa para a pergunta do usuário.

Quando vale usar a plataforma em vez da skill aberta?

Quando o gargalo deixa de ser o dado. Publicação com aprovação, voz de marca em escala, várias línguas, fontes próprias do cliente, telemetria de custo e distribuição em site, app e mensageria são o que a plataforma resolve — a skill entrega o dado, não a operação em volta dele.

Coloque seu primeiro agente no ar esta semana

Agendar uma demo Ou construa você mesmo → docs