Uma API desenvolvida com FastAPI para consultar e baixar os borderôs (boletim financeiro) dos jogos da Federação de Futebol do Piauí (FFP), sem precisar acessar manualmente o site oficial.
Facilitar o acesso aos dados de competições organizadas pela FFP, como:
- Lista de competições
- Tabelas e fases
- Partidas (com data, placar, times)
- Download do borderô em PDF
- Extração de informações do PDF (em breve)
main.py→ Arquivo principal da API (endpoints)scraper.py→ Módulo que faz o scraping de dados e baixa PDFscoletar_partidas.py→ Script auxiliar que coleta partidas via Playwrightrequirements.txt→ Dependências do projeto
| Rota | Método | Descrição |
|---|---|---|
/ |
GET | Verifica se a API está ativa |
/competicoes |
GET | Lista os campeonatos disponíveis |
/tabelas?idcampeonato=... |
GET | Mostra as fases da competição |
/partidas?idcampeonato=...&id_fase=... |
GET | Lista as partidas da fase |
/bordero?id_partida=... |
GET | Baixa o PDF do borderô da partida |
-
Clone o repositório:
git clone https://github.com/AntonioIvoDeOliveiraSouza/checabordero.git cd checa-bordero -
Crie e ative um ambiente virtual:
python -m venv venv
source venv/bin/activate # Linux/macOS
.\venv\Scripts\activate # Windows- Instale as dependências:
pip install -r requirements.txt- Execute a API:
uvicorn main:app --reload- Acesse a documentação interativa:
http://localhost:8000/docsA API pode ser acessada pela documentação no FastAPI acima, ou pelo próprio terminal, onde verá a documentação abaixo:
- Para iniciar o projeto:
python scraper.py- Para acessar os campeonatos disponíveis:
python scraper.py get_campeonato- Para acessar as fases do campeonato:
python scraper.py get_tabelas <id_campeonato>- Para acessar as partidas do campeonato:
python coletar_partidas.py coletar_partidas <id_campeonato> <id_fase>- Para acessar os borderôs em pdf dos jogos:
python scraper.py get_bordero <id_partida>- Para ler os dados dos borderôs no próprio terminal e criar txt:
python scraper.py extract_bordero <id_partida>