audio-scrape

Scrape audio sources: $ARGUMENTS

$ARGUMENTS should be one of:

• A person/topic name to search (e.g. "Alan Hirsch") — discovers podcasts via iTunes
• --rss https://feed.url/rss to scrape a specific RSS feed
• --episode-url https://example.com/episode.mp3 --title "Episode Title" to scrape a single audio file
• --refresh to re-transcribe episodes that don't have transcripts yet
• Empty — ask the user for the search term

Before Starting

1. Confirm OPENAI_API_KEY is set in .env.local — needed for Whisper transcription
2. Read src/lib/database/schema.ts for the podcastEpisodes, podcastSeries table definitions
3. Read scripts/audio-scrape.ts to understand the existing scrape script
4. Optionally confirm ffmpeg is installed (which ffmpeg) — needed for splitting large audio files (>25MB)

Pipeline Stages

Stage 1 — Discover Podcasts