Youtube-Intelligence

YouTube Intelligence

Não é um extrator de transcrições. É uma camada de acesso ao conhecimento.

Os criadores em quem você confia têm as respostas que você precisa. Encontrá-las leva horas. Agora leva segundos.

---

O problema real

Você tem uma decisão específica a tomar.
Uma reunião amanhã. Um negócio a fechar. Uma contratação a avaliar. Um pitch a preparar.

A melhor resposta provavelmente existe — em algum lugar nas 500 horas de conteúdo
dos criadores que você já segue e em quem confia.

Mas o YouTube não tem memória. Não há busca dentro de um canal. Não há síntese entre vídeos.
Então você assiste ao que aparece, perde 90% do que foi dito e decide com informações incompletas.

O conhecimento está lá. O acesso não está.

O que isto faz

You  →  "What does YC say about raising your seed round without traction?"

AI   →  Based on 3 videos:

        1. "How to Get Your First Users" — Y Combinator (Mar 2023)
           → https://youtu.be/abc?t=312
           "Most founders wait until the product is perfect before talking
            to users. That's the wrong order. Launch ugly, learn fast..."

        2. "Fundraising Fundamentals" — YC (Jan 2022)
           → https://youtu.be/xyz?t=89
           "Investors fund lines, not dots. If you have no traction,
            your job is to give them a second dot as fast as possible..."

Uma pergunta. Resposta instantânea. Citações reais. Timestamps exatos.

---

O que torna isto diferente

	Ferramentas de scraping do YouTube	YouTube Intelligence
Escopo	URL de vídeo único	Canal inteiro (1.000+ vídeos)
Busca	Nenhuma	Semântica — encontra significado, não palavras-chave
Saída	Transcrição bruta	Resposta com fontes e citações
Memória	Nenhuma	Persistente — indexe uma vez, consulte para sempre
Multi-canal	Não	Sim — compare especialistas lado a lado
Seus dados	Nuvem	100% local — permanece na sua máquina
Custo	Variável	Gratuito (apenas uma chave gratuita da API do YouTube)

---

Casos de uso

• Fundadores — Extraia tudo o que um criador diz sobre captação de recursos, GTM, contratações
• Representantes de vendas — Explore 1.000 episódios de vendas em busca de táticas para objeções específicas
• Pesquisadores — Sintetize o que vários especialistas dizem sobre o mesmo tópico
• Executivos — Acompanhe o pensamento de um criador sem assistir a todos os vídeos

---

Configuração (5 minutos)

1. Clonar e instalar

git clone https://github.com/trichanizar/youtube-intelligence
cd yt-intelligence
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

2. Adicionar sua chave da API do YouTube

cp .env.example .env

Abra .env e adicione sua chave gratuita da YouTube Data API v3.
→ Obtenha uma em console.cloud.google.com (gratuita, leva 2 min)
→ Tutorial completo: SETUP.md

3. Conectar ao Claude Desktop

Adicione isto à configuração do seu Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "yt-intelligence": {
      "command": "/absolute/path/to/yt-intelligence/.venv/bin/python",
      "args": ["/absolute/path/to/yt-intelligence/mcp_server.py"]
    }
  }
}

Reinicie o Claude Desktop. Pronto.

---

Uso

Abra o Claude Desktop e comece a conversar:

"Index the channel @GuillaumeMoubeche-FR"
→ Claude indexes all 68 videos (takes ~5 min)

"What does he say about the first 10 customers?"
→ Claude searches across all videos and answers with sources

"Now also index @30MPC and compare their views on cold outreach"
→ Claude searches both channels and synthesizes

Sem código. Sem terminal. Apenas conversa.

---

Uso via CLI (opcional)

# Index a channel
python index_channel.py @GuillaumeMoubeche-FR

# Index with topic filter (skips off-topic videos)
python index_channel.py @30MPC --filter "B2B sales, prospecting, objection handling"

# Query directly
python search.py "how to handle pricing objections"

---

Como funciona

YouTube Channel
    ↓  YouTube Data API (free)
List of videos
    ↓  youtube-transcript-api (free)
Transcripts with timestamps
    ↓  Chunking + local embeddings (sentence-transformers, free)
Vector database (ChromaDB, local)
    ↓  Semantic search + cross-encoder reranking
Relevant excerpts
    ↓  Claude synthesizes
Sourced answer with timestamps

Tudo roda localmente. Nenhum dado sai da sua máquina.

---

Requisitos

• Python 3.10+
• Claude Desktop (gratuito ou Pro)
• Chave da YouTube Data API v3 (gratuita)

Só isso.