YouTube Video Search

Core Goal

• Search public YouTube videos with search.list.
• Support domain discovery from flexible query strings and optional channel/time filters.
• Enrich discovered videos with videos.list metadata and statistics.
• Return machine-readable JSON and optionally save JSONL candidate artifacts.
• Keep execution observable with structured logs and optional log file.

Required Environment

• Configure runtime via environment variables (see references/env.md).
• Start from assets/config.example.env and keep real secrets in assets/config.env.
• Load env values before running commands:

set -a
source assets/config.env
set +a