@danhachuel/thunderbolt 0.5.53 → 0.5.55

package/app/main.py

@@ -1521,6 +1521,14 @@ def render_growth_youtube():
         for label in ("Demanda validada", "Qualidade da thumbnail", "Qualidade do título", "Hook — retenção inicial", "Ritmo e edição", "Origem do tráfego", "Conversão em inscritos", "Cadência de publicação")
     ]
     overall = int(selected_record.get("overall_score", 0)) if selected_record else None
+    if selected_record:
+        analytics_state = (selected_record.get("analytics") or {}).get("status", "not_connected")
+        if analytics_state == "ready":
+            st.success("Dados internos activos: YouTube Analytics OAuth aplicado à análise.")
+        elif analytics_state in {"requires_authorization", "not_connected"}:
+            st.info("Dados públicos activos. Para CTR, retenção, tráfego, RPM e demografia, autorize a conta Google proprietária do canal; os valores privados não são estimados como reais.")
+        else:
+            st.warning("A consulta YouTube Analytics não ficou disponível; os cartões afectados estão marcados como estimados ou indisponíveis.")
     color = _growth_score_color(overall) if overall is not None else "#64748b"
     score_text = str(overall) if overall is not None else "—"
     score_suffix = "/100" if overall is not None else ""
@@ -1541,20 +1549,25 @@ def render_growth_youtube():
         else:
             st.button("BAIXAR ANALISE COMPLETA", disabled=True, use_container_width=True, key="growth_download_disabled")
     st.subheader("Dashboard de Growth")
-    st.caption("Vermelho: 0–30 · Amarelo: 31–69 · Verde: 70–100. Clique em ANALISAR CANAL para recolher dados públicos actualizados.")
-    for row_start in range(0, len(metrics), 4):
-        cols = st.columns(4, gap="small")
-        for col, metric in zip(cols, metrics[row_start:row_start + 4]):
-            with col:
-                score = metric["score"]
-                st.markdown(
-                    f'<div style="min-height:142px;border:1px solid #263447;border-radius:10px;padding:14px;background:#0d141e;">'
-                    f'<div style="font-size:13px;color:#cbd5e1;min-height:34px;">{metric["label"]}</div>'
-                    f'<div style="font-size:30px;font-weight:800;color:{_growth_score_color(score)};">{score}<span style="font-size:13px;color:#94a3b8;">/100</span></div>'
-                    f'<div style="font-size:12px;color:#e2e8f0;margin-top:5px;">{metric["value"]}</div>'
-                    f'<div style="font-size:11px;color:#64748b;margin-top:5px;">{metric.get("diagnosis", "")[:100]}</div></div>',
-                    unsafe_allow_html=True,
-                )
+    st.caption("Visão híbrida: os 3 pilares críticos em destaque e os 5 pilares operacionais abaixo. Vermelho: 0–30 · Amarelo: 31–69 · Verde: 70–100.")
+    source_names = {"public": "PÚBLICO", "paligemma": "PALIGEMMA", "estimated": "DADO ESTIMADO", "unavailable": "INDISPONÍVEL", "youtube_analytics_oauth": "ANALYTICS OAUTH"}
+    featured, secondary = metrics[:3], metrics[3:]
+
+    def growth_card(metric: dict[str, Any], featured_card: bool = False) -> str:
+        score = int(metric.get("score", 0))
+        source = source_names.get(str(metric.get("source", "unknown")), "A VERIFICAR")
+        height = "min-height:238px" if featured_card else "min-height:190px"
+        return (
+            f'<div style="{height};border:1px solid #2b3b52;border-radius:14px;padding:18px;background:linear-gradient(145deg,#111c2b,#0b121c);box-shadow:0 8px 22px rgba(0,0,0,.16);">'
+            f'<div style="font-size:11px;font-weight:800;letter-spacing:.08em;color:#7dd3fc;text-transform:uppercase;">{source}</div>'
+            f'<div style="font-size:{"18px" if featured_card else "15px"};font-weight:750;color:#f8fafc;margin-top:9px;min-height:40px;">{metric.get("label", "Métrica")}</div>'
+            f'<div style="display:flex;align-items:baseline;gap:5px;margin-top:7px;"><span style="font-size:{"42px" if featured_card else "32px"};font-weight:850;color:{_growth_score_color(score)};">{score}</span><span style="font-size:13px;color:#94a3b8;">/100</span></div>'
+            f'<div style="border-top:1px solid #263447;margin-top:10px;padding-top:10px;font-size:13px;color:#e2e8f0;"><b>KPI observado</b><br>{metric.get("value", "—")}</div>'
+            f'<div style="font-size:11px;color:#94a3b8;margin-top:9px;line-height:1.35;">{metric.get("diagnosis", "")[:150]}</div></div>'
+        )
+
+    st.markdown('<div style="display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:14px;margin:14px 0 18px;">' + "".join(growth_card(metric, True) for metric in featured) + '</div>', unsafe_allow_html=True)
+    st.markdown('<div style="display:grid;grid-template-columns:repeat(5,minmax(0,1fr));gap:12px;margin:0 0 18px;">' + "".join(growth_card(metric) for metric in secondary) + '</div>', unsafe_allow_html=True)
     st.divider()
     history_tab, dashboard_tab = st.tabs(["Últimas análises", "Leitura estratégica"])
     with dashboard_tab:

package/hermes_ui/growth_youtube.py

@@ -183,14 +183,15 @@ def analyse_thumbnail_with_paligemma(path: str, card: Mapping[str, Any]) -> dict
 
 
 def _report_markdown(record: Mapping[str, Any]) -> str:
-    lines = [f"# CHANNEL AUDIT REPORT: {record.get('channel_name', 'Canal')}", "", f"- Código: `{record.get('code')}`", "- Plataforma: YouTube", f"- Data: {record.get('created_at')}", f"- Nota geral: **{record.get('overall_score', 0)}/100**", "", "## 1. Projecção financeira e contexto", "", "A análise pública não expõe RPM, país da audiência nem horas de visualização. O relatório não inventa estes valores. Para referência do agente, o YPP usa 1.000 inscritos e 4.000 horas de vídeos longos em 12 meses ou 10 milhões de visualizações de Shorts em 90 dias até 31/01/2027; a partir de 01/02/2027 a meta de Shorts indicada pelo agente é 20 milhões.", "", "## 2. Resumo do diagnóstico", "", "| Pilar | Nota | Métrica observada | Resultado |", "|---|---:|---|---|"]
+    analytics = record.get("analytics") or {}
+    lines = [f"# CHANNEL AUDIT REPORT: {record.get('channel_name', 'Canal')}", "", f"- Código: `{record.get('code')}`", "- Plataforma: YouTube", f"- Data: {record.get('created_at')}", f"- Nota geral: **{record.get('overall_score', 0)}/100**", "", "## 1. Projecção financeira e contexto", "", "A análise pública não expõe RPM, país da audiência nem horas de visualização. O relatório não inventa estes valores. Para referência do agente, o YPP usa 1.000 inscritos e 4.000 horas de vídeos longos em 12 meses ou 10 milhões de visualizações de Shorts em 90 dias até 31/01/2027; a partir de 01/02/2027 a meta de Shorts indicada pelo agente é 20 milhões.", "", "## 2. Resumo do diagnóstico", "", "| Pilar | Nota | Métrica observada | Origem | Diagnóstico |", "|---|---:|---|---|---|"]
     pillar_names = {"Demanda validada": "Demanda", "Qualidade da thumbnail": "Thumbnail", "Qualidade do título": "Título", "Hook — retenção inicial": "Hook", "Ritmo e edição": "Pacing", "Origem do tráfego": "Tráfego", "Conversão em inscritos": "CTA", "Cadência de publicação": "Cadência"}
     for metric in record.get("metrics", []):
-        lines.append(f"| **{pillar_names.get(metric['label'], metric['label'])}** | {metric['score']}/100 | {metric['value']} | {metric['diagnosis']} |")
+        lines.append(f"| **{pillar_names.get(metric['label'], metric['label'])}** | {metric['score']}/100 | {metric['value']} | {metric.get('source', 'unknown')} | {metric['diagnosis']} |")
     lines += ["", "## 3. Últimos 3 vídeos", "", "| Título | Visualizações | Thumbnail | Transcrição | Nota do título |", "|---|---:|---|---|---:|"]
     for video in record.get("videos", []):
         lines.append(f"| {video.get('title', '').replace('|', '/')} | {video.get('view_count', 0):,} | {video.get('thumbnail_status', '')} | {video.get('transcript_status', '')} | {video.get('title_score', 0)}/100 |")
-    lines += ["", "## 4. Actionable Roadmap — Top 3 prioridades", "", "1. **REMAKE THUMBNAILS** dos vídeos abaixo de 70: aumentar contraste, sujeito claro, emoção forte e máximo de três palavras legíveis no telemóvel.", "2. **REWRITE TITLES** com Curiosity, Clarity e Urgency; colocar a keyword principal no início e usar números/adjectivos de poder quando forem verdadeiros.", "3. **EDIT HOOK**: começar pelo resultado, promessa ou estatística forte e introduzir pattern interrupts a cada 5–8 segundos.", "", "## 5. Estratégia de longo prazo", "", "Construir uma biblioteca de pelo menos 50 vídeos evergreen, publicar com cadência semanal fixa e procurar que Browse Features se torne a principal origem de tráfego. Para um criador solo, consistência supera frequência; melhorar Thumbnail + Título antes de alterar a produção.", "", "## Limitações", "", "CTR, retenção real, origem de tráfego, RPM e horas de visualização exigem dados autorizados do YouTube Studio e não são inventados a partir da página pública."]
+    lines += ["", "## 4. Dados internos do YouTube Studio", "", f"Estado Analytics: **{analytics.get('status', 'not_connected')}**. {analytics.get('message', 'Sem OAuth Analytics autorizado; os valores privados permanecem indisponíveis ou estimados.')}", "", "## 5. Actionable Roadmap — Top 3 prioridades", "", "1. **REMAKE THUMBNAILS** dos vídeos abaixo de 70: aumentar contraste, sujeito claro, emoção forte e máximo de três palavras legíveis no telemóvel.", "2. **REWRITE TITLES** com Curiosity, Clarity e Urgency; colocar a keyword principal no início e usar números/adjectivos de poder quando forem verdadeiros.", "3. **EDIT HOOK**: começar pelo resultado, promessa ou estatística forte e introduzir pattern interrupts a cada 5–8 segundos.", "", "## 6. Estratégia de longo prazo", "", "Construir uma biblioteca de pelo menos 50 vídeos evergreen, publicar com cadência semanal fixa e procurar que Browse Features se torne a principal origem de tráfego. Para um criador solo, consistência supera frequência; melhorar Thumbnail + Título antes de alterar a produção.", "", "## Limitações", "", "CTR, retenção real, origem de tráfego, RPM e horas de visualização exigem dados autorizados do YouTube Studio e não são inventados a partir da página pública."]
     return "\n".join(lines) + "\n"
 
 
@@ -242,19 +243,29 @@ def run_audit(channel: Mapping[str, Any], settings: Mapping[str, Any], *, vision
             try: video["vision"] = analyse_thumbnail_with_paligemma(video["thumbnail_path"], vision_card)
             except Exception as exc: video["vision"] = {"score": 50, "status": "erro", "diagnosis": str(exc)[:220]}
         else: video["vision"] = {"score": 50, "status": "sem_dados", "diagnosis": "Provider Paligemma não configurado."}
+    analytics: dict[str, Any]
+    try:
+        from integrations.youtube_growth_api import query_channel_analytics
+        analytics = query_channel_analytics(channel, settings, STORAGE)
+    except Exception as exc:
+        analytics = {"status": "query_failed", "message": str(exc)[:300]}
+    analytics_values = analytics.get("values", {}) if analytics.get("status") == "ready" else {}
+    analytics_source = "youtube_analytics_oauth" if analytics_values else "estimated_proxy"
+    analytics_note = "YouTube Analytics OAuth" if analytics_values else str(analytics.get("message") or "Sem dados internos; proxy estimado")
     thumb_scores = [int((video.get("vision") or {}).get("score", 50)) for video in videos]
     metrics = [
-        {"label": "Demanda validada", "score": 50, "value": f"{len(videos)} vídeos públicos", "diagnosis": "Amostra pública recolhida; volume de pesquisa/concorrência não disponível."},
-        {"label": "Qualidade da thumbnail", "score": round(sum(thumb_scores) / len(thumb_scores)), "value": f"{len(videos)} thumbnails analisadas", "diagnosis": "Avaliação Paligemma/NIM ou sem dados quando não configurado."},
-        {"label": "Qualidade do título", "score": round(sum(title_scores) / len(title_scores)), "value": f"{len(videos)} títulos analisados", "diagnosis": "Curiosidade, clareza, urgência, palavras-chave e números."},
-        {"label": "Hook — retenção inicial", "score": round(sum(transcript_scores) / len(transcript_scores)), "value": "Análise textual das aberturas", "diagnosis": "Inferência textual; retenção percentual real não está disponível."},
-        {"label": "Ritmo e edição", "score": 50, "value": "Sem vídeo/curva de retenção", "diagnosis": "Requer gráfico de retenção do YouTube Studio."},
-        {"label": "Origem do tráfego", "score": 50, "value": "Sem dados públicos", "diagnosis": "Requer YouTube Studio."},
-        {"label": "Conversão em inscritos", "score": 50, "value": "Sem inscritos por vídeo", "diagnosis": "Requer Analytics autorizado."},
-        {"label": "Cadência de publicação", "score": 50, "value": "Datas públicas recolhidas", "diagnosis": "Cadência detalhada será calculada quando datas válidas forem fornecidas."},
+        {"label": "Demanda validada", "score": 50, "value": f"{len(videos)} vídeos públicos", "source": "public", "diagnosis": "Amostra pública recolhida; volume de pesquisa/concorrência não disponível."},
+        {"label": "Qualidade da thumbnail", "score": round(sum(thumb_scores) / len(thumb_scores)), "value": f"{len(videos)} thumbnails analisadas", "source": "paligemma" if any((video.get("vision") or {}).get("status") == "analisado" for video in videos) else "estimated", "diagnosis": "Avaliação Paligemma/NIM ou sem dados quando não configurado."},
+        {"label": "Qualidade do título", "score": round(sum(title_scores) / len(title_scores)), "value": f"{len(videos)} títulos analisados", "source": "public", "diagnosis": "Curiosidade, clareza, urgência, palavras-chave e números."},
+        {"label": "Hook — retenção inicial", "score": round(sum(transcript_scores) / len(transcript_scores)), "value": "Análise textual das aberturas", "source": "estimated", "diagnosis": "Inferência textual; retenção percentual real não está disponível."},
+        {"label": "Ritmo e edição", "score": _safe_int(analytics_values.get("averageViewPercentage"), 50) if analytics_values else 50, "value": "Percentagem média assistida (OAuth)" if analytics_values else "Proxy: sem curva de retenção", "source": analytics_source, "diagnosis": analytics_note},
+        {"label": "Origem do tráfego", "score": 50, "value": "Dados de tráfego (OAuth)" if analytics_values else "Indisponível sem OAuth", "source": analytics_source if analytics_values else "unavailable", "diagnosis": analytics_note},
+        {"label": "Conversão em inscritos", "score": 50, "value": f"{analytics_values.get('subscribersGained', '—')} ganhos / {analytics_values.get('subscribersLost', '—')} perdidos" if analytics_values else "Indisponível sem Analytics", "source": analytics_source if analytics_values else "unavailable", "diagnosis": analytics_note},
+        {"label": "Cadência de publicação", "score": 50, "value": "Datas públicas recolhidas", "source": "public", "diagnosis": "Cadência detalhada será calculada quando datas válidas forem fornecidas."},
     ]
-    overall = round(sum(metric["score"] for metric in metrics) / len(metrics))
-    record = {"code": code, "channel_id": str(channel.get("id") or ""), "channel_name": str(channel.get("name") or "Canal"), "platform": "YouTube", "created_at": datetime.now(timezone.utc).isoformat(), "overall_score": overall, "score_color": _score_color(overall), "metrics": metrics, "videos": videos, "status": "completed"}
+    weights = {"Qualidade da thumbnail": 0.30, "Qualidade do título": 0.25, "Hook — retenção inicial": 0.25, "Conversão em inscritos": 0.20}
+    overall = round(sum(metric["score"] * weights.get(metric["label"], 0) for metric in metrics) / sum(weights.values()))
+    record = {"code": code, "channel_id": str(channel.get("youtube_channel_id") or channel.get("id") or ""), "channel_name": str(channel.get("name") or "Canal"), "platform": "YouTube", "created_at": datetime.now(timezone.utc).isoformat(), "overall_score": overall, "score_color": _score_color(overall), "score_weights": weights, "analytics": analytics, "metrics": metrics, "videos": videos, "status": "completed"}
     report_path = root / f"{code}.md"
     report_path.write_text(_report_markdown(record), encoding="utf-8")
     record["report_path"] = str(report_path)

package/integrations/youtube_growth_api.py

@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+import json
+from datetime import date, timedelta
+from pathlib import Path
+from typing import Any, Mapping
+
+from .youtube_batch import account_status, token_path
+
+ANALYTICS_SCOPE = "https://www.googleapis.com/auth/yt-analytics.readonly"
+
+
+def _text(value: Any) -> str:
+    return str(value or "").strip()
+
+
+def _accounts(settings: Mapping[str, Any]) -> list[dict[str, Any]]:
+    value = settings.get("youtube_batch_accounts", [])
+    return [dict(item) for item in value if isinstance(item, Mapping)] if isinstance(value, list) else []
+
+
+def find_account_for_channel(channel: Mapping[str, Any], settings: Mapping[str, Any]) -> dict[str, Any] | None:
+    channel_id = _text(channel.get("youtube_channel_id") or channel.get("id"))
+    account_id = _text(channel.get("google_account_id"))
+    accounts = _accounts(settings)
+    for account in accounts:
+        if account_id and _text(account.get("id")) == account_id:
+            return account
+        known_channels = account.get("channels", [])
+        if isinstance(known_channels, list) and any(_text(item.get("youtube_channel_id") or item.get("id")) == channel_id for item in known_channels if isinstance(item, Mapping)):
+            return account
+    return None
+
+
+def _load_credentials(account: Mapping[str, Any], storage_root: Path) -> tuple[Any | None, str]:
+    path = token_path(storage_root, dict(account))
+    status = account_status(dict(account), storage_root)
+    if not status.ok:
+        return None, str(status.message)
+    try:
+        from google.auth.transport.requests import Request
+        from google.oauth2.credentials import Credentials
+        raw = json.loads(path.read_text(encoding="utf-8"))
+        scopes = list(raw.get("scopes") or []) if isinstance(raw, dict) else []
+        if ANALYTICS_SCOPE not in scopes:
+            return None, "OAuth autorizado sem o scope YouTube Analytics; é necessária uma nova autorização condicional."
+        credentials = Credentials.from_authorized_user_info(raw, scopes)
+        if credentials.expired and credentials.refresh_token:
+            credentials.refresh(Request())
+            path.write_text(credentials.to_json(), encoding="utf-8")
+        return credentials, "ready"
+    except ImportError:
+        return None, "Dependências Google OAuth/API não instaladas."
+    except (OSError, ValueError, TypeError) as exc:
+        return None, f"Token OAuth inválido: {exc}"
+
+
+def query_channel_analytics(channel: Mapping[str, Any], settings: Mapping[str, Any], storage_root: Path, *, days: int = 28) -> dict[str, Any]:
+    account = find_account_for_channel(channel, settings)
+    if not account:
+        return {"status": "not_connected", "message": "Nenhuma conta Google OAuth compatível com este canal."}
+    credentials, message = _load_credentials(account, storage_root)
+    if credentials is None:
+        return {"status": "requires_authorization", "message": message, "email": _text(account.get("email"))}
+    channel_id = _text(channel.get("youtube_channel_id") or channel.get("id"))
+    if not channel_id:
+        return {"status": "unavailable", "message": "O canal não tem YouTube channel ID."}
+    try:
+        from googleapiclient.discovery import build
+        analytics = build("youtubeAnalytics", "v2", credentials=credentials, cache_discovery=False)
+        end_date = date.today()
+        start_date = end_date - timedelta(days=max(1, days) - 1)
+        response = analytics.reports().query(
+            ids=f"channel=={channel_id}",
+            startDate=start_date.isoformat(),
+            endDate=end_date.isoformat(),
+            metrics="views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained,subscribersLost",
+        ).execute()
+        rows = response.get("rows", [])
+        headers = [item.get("name") for item in response.get("columnHeaders", [])]
+        values = dict(zip(headers, rows[0])) if rows else {}
+        return {"status": "ready", "source": "youtube_analytics_oauth", "window_days": days, "values": values, "email": _text(account.get("email"))}
+    except ImportError:
+        return {"status": "missing_dependencies", "message": "A biblioteca Google API Client ainda não está instalada."}
+    except Exception as exc:
+        return {"status": "query_failed", "message": str(exc)[:300], "email": _text(account.get("email"))}
+
+
+__all__ = ["ANALYTICS_SCOPE", "find_account_for_channel", "query_channel_analytics"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.5.53",
+  "version": "0.5.55",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",