feat: inspect public video sources with yt-dlp

README.md

@@ -72,6 +72,19 @@ Open <http://127.0.0.1:8000> or request the health endpoint:
 curl --fail http://127.0.0.1:8000/health
 ```
 
+Inspect a public, non-live video without downloading it:
+
+```bash
+curl --fail --request POST http://127.0.0.1:8000/api/inspect \
+  --header 'Content-Type: application/json' \
+  --data '{"url":"https://example.com/video"}'
+```
+
+Inspection accepts only HTTP and HTTPS URLs on standard ports. The initial
+hostname must resolve entirely to public IP addresses. Playlists and
+multi-video sources are rejected, and raw signed media URLs are not returned
+to the browser.
+
 Run the automated tests in an ephemeral container:
 
 ```bash