ScrapOddsAPI

# 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
```

| Layer | Technology |
|-------|-----------|
| Data source | [The Odds API](https://the-odds-api.com/) |
| Scraper | Python 3.11+, httpx, pandas |
| Database | PostgreSQL 15+ (Docker) |
| Backend | Flask, LangGraph, DeepSeek V3.1 (OpenRouter), psycopg2 |
| RAG | ChromaDB, sentence-transformers |
| Live data | [football-data.org](https://www.football-data.org/) (standings, scorers) |
| Frontend | React 18, Vite, TailwindCSS |

## 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](https://docs.astral.sh/uv/) (fast Python package manager)
- Node.js 18+
- Docker Desktop
- API keys: [The Odds API](https://the-odds-api.com/), [OpenRouter](https://openrouter.ai/keys), [football-data.org](https://www.football-data.org/client/register)

## Setup

```bash
git clone <your-repo-url>
cd ScrapOddsAPI

# Environment va