# BurakBox — Ultimate Letterboxd Pro & Cinema Suite

> Free Letterboxd Pro & Patron tier cinema analytics, canonical list completion tracker, and Excel archive export engine.

## Overview
BurakBox bridges the gap for cinema enthusiasts by providing all-time stats, list completion progress bars, director/genre breakdowns, interactive film explorer, and smart unwatched movie recommendations based on user diaries.

## Key Features
- Live Letterboxd RSS Synchronization with multi-stage RapidFuzz text matching
- Canonical Lists Tracking: IMDb Top 250, Letterboxd Top 250, Oscar Best Picture, Cannes Palme d'Or, BFI Sight & Sound 2022, 1001 Movies, AFI 100
- Analytics: Top Directors, Genre Breakdown, Rating Distributions, Historical Decades Radar
- Smart Recommendations: Unwatched canonical masterpieces scored by user's favorite directors & genres
- Professional Multi-tab Excel Export (.xlsx) with KPI summary dashboard

## API Endpoints
- POST `/api/analyze`: Takes `{ "username": "letterboxd_user" }` and returns complete analytics, list stats, charts, recommendations, and film explorer data.
- GET `/api/export-excel?username=letterboxd_user`: Streams formatted multi-tab Excel workbook.