Full-stack platform that scrapes, stores, and analyzes sports betting odds in real time using a LangGraph AI agent powered by DeepSeek V3.1.

ScrapOddsAPI

Full-stack platform that scrapes, stores, and analyzes sports betting odds in real time using a LangGraph AI agent powered by DeepSeek V3.1.

Architecture

The Odds API --> Python Scraper --> PostgreSQL --> Flask + LangGraph Agent --> React Frontend
                                                       |
                                              ChromaDB (RAG) + football-data.org

Project Structure

ScrapOddsAPI/
├── scrapping/                   # Data collection scripts
│   ├── odds_scraper.py
│   └── rag/                     # RAG context builder
├── odds-agent/
│   ├── backend/server_py/       # Flask API + LangGraph agent
│   │   ├── app.py               # API routes
│   │   ├── graph.py             # LangGraph state graph
│   │   ├── budget.py            # Cost tracking
│   │   ├── tools/               # Agent tools (odds, RAG, football-data)
│   │   └── services/            # Data services
│   └── frontend/                # React application
├── pyproject.toml               # Python dependencies (uv)
├── docker-compose.yml
└── README.md

Supported Leagues

Premier League, La Liga, Serie A, Bundesliga, Ligue 1, Champions League.

Prerequisites

• Python 3.11+
• uv (fast Python package manager)
• Node.js 18+
• Docker Desktop
• API keys: The Odds API, OpenRouter, football-data.org

Setup

git clone <your-repo-url>
cd ScrapOddsAPI

# Environment va