video-lens

python3 -c "
import re, urllib.request, datetime
from youtube_transcript_api import YouTubeTranscriptApi
video_id = 'VIDEO_ID'
lang_pref = 'LANG_PREF_VALUE'
try:
    req = urllib.request.Request(f'https://www.youtube.com/watch?v={video_id}', headers={'User-Agent': 'Mozilla/5.0'})
    html = urllib.request.urlopen(req).read().decode('utf-8', errors='ignore')
    m = re.search(r'<title>([^<]+)</title>', html)
    title = m.group(1).replace(' - YouTube', '').strip() if m else ''
    channel = ''
    published = ''
    views = ''
    m_ch = re.search(r'\"channelName\"\s*:\s*\"([^\"]+)\"', html)
    if m_ch: channel = m_ch.group(1)
    m_pub = re.search(r'\"publishDate\"\s*:\s*\"([^\"]+)\"', html)
    if m_pub:
        parts = m_pub.group(1)[:10].split('-')
        months = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec']
        published = f'{months[int(parts[1])-1]} {int(parts[2])} {parts[0]}'
    m_views = re.search(r'\"viewCount\"\s*:\s*\"([0-9]+)\"', html)
    if m_views:
        v = int(m_views.group(1))
        views = f'{v/1e6:.1f}M views' if v >= 1e6 else f'{v/1e3:.0f}K views' if v >= 1e3 else f'{v} views'
    m_dur = re.search(r'\"lengthSeconds\"\s*:\s*\"([0-9]+)\"', html)
    if m_dur:
        total_s = int(m_dur.group(1))
        h2, rem = divmod(total_s, 3600); m2 = rem // 60
        duration = f'{h2}h {m2}m' if h2 > 0 else f'{m2} min'
    else:
        duration = ''
except Exception:
    title = ''
    channel = ''
    published = ''
    views = ''
    duration = ''
try:
    try:
        tlist = YouTubeTranscriptApi().list(video_id)
    except (AttributeError, TypeError):
        tlist = YouTubeTranscriptApi.list_transcripts(video_id)
except Exception as e:
    raise SystemExit(f'Transcript fetch failed: {e}')
transcript_obj = None
if lang_pref:
    for t in tlist:
        if t.language_code == lang_pref and not getattr(t, 'is_translation', False):
            transcript_obj = t
            break
    if transcript_obj is None:
        for t in tlist:
            if t.language_code == lang_pref:
                transcript_obj = t
                break
    if transcript_obj is None:
        for t in tlist:
            if not getattr(t, 'is_translation', False):
                transcript_obj = t
                break
        if transcript_obj is None:
            transcript_obj = next(iter(tlist))
        print(f'LANG_WARN: Requested language \"{lang_pref}\" not available; using {transcript_obj.language_code}')
else:
    for t in tlist:
        if not getattr(t, 'is_translation', False):
            transcript_obj = t
            break
    if transcript_obj is None:
        transcript_obj = next(iter(tlist))
transcript = transcript_obj.fetch()
lang = transcript_obj.language_code
lines = [f'TITLE: {title}', f'CHANNEL: {channel}', f'PUBLISHED: {published}', f'VIEWS: {views}', f'DURATION: {duration}', f'DATE: {datetime.date.today().isoformat()}', f'TIME: {datetime.datetime.now().strftime(\"%H%M%S\")}', f'LANG: {lang}']
for s in transcript:
    total_s = int(s.start)
    h3, rem3 = divmod(total_s, 3600)
    m2, s2 = divmod(rem3, 60)
    if h3 > 0:
        lines.append(f'[{h3}:{m2:02d}:{s2:02d}] {s.text}')
    else:
        lines.append(f'[{m2}:{s2:02d}] {s.text}')
print('\n'.join(lines))
"

yt-dlp --skip-download --quiet --no-warnings --print '{"channel":%(channel)j,"description":%(description)j,"upload_date":%(upload_date)j,"view_count":%(view_count)j,"duration":%(duration)j,"chapters":%(chapters)j}' "https://www.youtube.com/watch?v=VIDEO_ID" 2>/dev/null | python3 -c "
import sys, json, html, datetime, re
raw = sys.stdin.read()
try:
    data = json.loads(raw)
except Exception as e:
    print(f'YTDLP_ERROR: {e} — raw output: {raw[:200]}')
    sys.exit(0)
desc_raw = (data.get('description') or '')[:3000]
if len(data.get('description') or '') > 3000:
    desc_raw += '\u2026'
def _linkify(line):
    parts = []; last = 0
    for m in re.finditer(r'https?://\S+', line):
        parts.append(html.escape(line[last:m.start()]))
        url = m.group()
        parts.append(f'<a href=\"{html.escape(url, quote=True)}\" target=\"_blank\" rel=\"noopener\">{html.escape(url)}</a>')
        last = m.end()
    parts.append(html.escape(line[last:]))
    return ''.join(parts)
desc_html = '<br>'.join(_linkify(l) for l in desc_raw.split('\n'))
chapters = data.get('chapters') or []
ud = data.get('upload_date') or ''
if len(ud) == 8:
    months = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec']
    published = f'{months[int(ud[4:6])-1]} {int(ud[6:8])} {ud[:4]}'
else:
    published = ''
vc = data.get('view_count')
views = ''
if vc is not None:
    views = f'{vc/1e6:.1f}M views' if vc >= 1e6 else f'{vc/1e3:.0f}K views' if vc >= 1e3 else f'{vc} views'
dur_s = data.get('duration') or 0
h2, rem = divmod(int(dur_s), 3600); m2 = rem // 60
duration = f'{h2}h {m2}m' if h2 > 0 else f'{m2} min'
print(f'YTDLP_CHANNEL: {data.get(\"channel\") or \"\"}')
print(f'YTDLP_PUBLISHED: {published}')
print(f'YTDLP_VIEWS: {views}')
print(f'YTDLP_DURATION: {duration}')
print(f'YTDLP_DESC_HTML: {desc_html}')
import json as j2; print(f'YTDLP_CHAPTERS: {j2.dumps(chapters)}')
"

<li><strong>Core claim, concept, or term</strong> — one sentence on why it matters or what the viewer should understand from it. Optionally include <em>the speaker's own phrasing</em> when it adds colour or precision.
<p>2–4 sentence analytical paragraph: context, causality, connections to other ideas, implications, and the speaker's reasoning. Must add depth the headline cannot — do not merely expand the headline into a longer sentence.</p></li>

python3 << 'PYEOF'
import pathlib

subs = {
    "VIDEO_ID":             "...",
    "VIDEO_TITLE":          "...",
    "VIDEO_URL":            "...",
    "META_LINE":            "...",
    "SUMMARY":              "...",
    "TAKEAWAY":             "...",
    "KEY_POINTS":           """...""",
    "OUTLINE":              """...""",
    "DESCRIPTION_SECTION":  "",
}

_home = pathlib.Path.home()
_search = [
    _home / ".agents" / "skills" / "video-lens" / "template.html",
    *[_home / f".{_a}" / "skills" / "video-lens" / "template.html"
      for _a in ("claude","copilot","gemini","cursor","windsurf","opencode","codex")]
]
_found = next((_p for _p in _search if _p.exists()), None)
if not _found:
    raise FileNotFoundError("template.html not found — run: npx skills add kar2phi/video-lens")
tpl = _found.read_text()
for k, v in subs.items():
    tpl = tpl.replace("{{" + k + "}}", v)
pathlib.Path("OUTPUT_PATH").write_text(tpl)
PYEOF

lsof -ti:8765 | xargs kill 2>/dev/null; sleep 0.2; python3 -m http.server 8765 --directory /path/to/dir & sleep 1 && (open "http://localhost:8765/filename.html" 2>/dev/null || xdg-open "http://localhost:8765/filename.html" 2>/dev/null || echo "Open http://localhost:8765/filename.html in your browser")

HTML_REPORT: /your/output/dir/2026-01-01-201025-video-lens_youtube_title.html