African movie extractor with Playwright token capture
# African Movie Extractor
A standalone Node.js proxy and aggregator for African movies from the `123movies`/`moviebox` network.
## Features
- **Aggregated African Content**: Combined list from South African Drama, Nollywood (Nigeria), and Showmax Originals.
- **Signed Streaming Links**: Automatically generates time-sensitive signed playback URLs.
- **Self-Healing Token**: Automatically captures and refreshes JWT tokens using Playwright.
- **Vercel Ready**: Pre-configured for deployment as a serverless function.
## API Endpoints
### 1. `GET /api/african-movies`
Returns a combined list of movies from all African categories.
- **Query Params**: `page` (default 1)
### 2. `GET /api/stream`
Generates a signed streaming link for a movie.
- **Query Params**:
- `id`: The `subjectId` of the movie.
- `path`: The `detailPath` of the movie.
### 3. `GET /api/ranking/:id`
Fetch a specific ranking list by ID.
- **Common IDs**:
- `4307848214843217008`: SA Drama
- `8216283712045280`: Nollywood
- `2076266324048625696`: Showmax Original
### 4. `GET /api/health`
Check server and token status.
## Local Setup
1. `npm install`
2. `node index.js`
3. The server will automatically attempt to capture a token on first request if none is provided in `.env`.
## Deployment
Deploy to Vercel or Netlify using the provided `vercel.json`. Ensure `playwright` dependencies are handled (Vercel supports this in some tiers, otherwise use a dedicated server).