Viral Spy Ai ( Descubra só videos virais )

ViralSpy.AI — Encontre sua Próxima Ideia Viral

O ViralSpy é uma ferramenta de descoberta e análise de tendências para YouTube que ajuda você a identificar oportunidades reais de audiência e transformar ideias em conteúdo performático.

Tutorial :
Pesquise no dashboard like points por ( Cadastrar chave api gemini ) 
siga o tutorial do botão tutorial, cadastre o codigo da chave api no sistema e acesse o viral spy aqui nesta pagina depois basta fazer suas pesquisas em qualquer idioma

Como obter a chave da API Gemini

- Requisitos:
  - Uma conta Google ativa.
  - Acesso ao Gemini via Google AI Studio. A versão gratuita tem limites; para uso intensivo pode ser necessário habilitar cobrança.
Passo a passo (Google AI Studio)

- Acesse https://aistudio.google.com/app/apikey e entre com sua conta Google.
- Clique em Create API key e confirme a criação.
- Copie a chave gerada (formato semelhante a AIza... ).
- Mantenha a chave somente no backend; não use em scripts do navegador.
Teste rápido da chave

- Com curl :
  - curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=SEU_API_KEY" -H "Content-Type: application/json" -d "{\"contents\":[{\"parts\":[{\"text\":\"Responda em JSON com {\\\"msg\\\":\\\"Olá\\\"}\"}]}]}"
- Resposta válida contém candidates[0].content.parts[0].text com texto (geralmente JSON ou texto simples).
Onde colocar a chave no seu sistema

- Painel administrativo:
  - Vá em Admin > Sistema > Configurações > APIs por conta do sistema (quotas) .
  - No provedor gemini , cole a chave e salve.
  - Isso permite que módulos como viral_spy/api.php usem a chave do admin sob o modo “por conta do sistema” e consumam quotas corretamente.
- Alternativas para desenvolvimento (evite em produção):
  - api_diversas vinculado ao usuário administrador ( user_level=3 ) com api_service='gemini' .
  - Constante GEMINI_API_KEY ou API_KEYS['gemini'] em _app/Config.inc.php (não recomendado commitar segredos).
Verificação dentro do ViralSpy

- A análise IA chama Gemini primeiro:
  - Código usa a lista de chaves resolvida por APIQuota e alterna para OpenRouter / OpenAI se necessário.
  - Após salvar a chave, abra http://localhost/gc/viral_spy/ , clique em “???? Análise IA” e confirme que os campos do relatório aparecem preenchidos.
Boas práticas de segurança

- Nunca expor a chave no frontend ( index.php /JS).
- Rotacione a chave periodicamente e revogue chaves antigas em Manage keys .
- Defina limites de uso no painel do seu sistema (quotas) para prevenir abuso.
- Logue falhas 401/403/429 e aplique backoff nos módulos que usam IA.
Erros comuns e soluções

- 401 Unauthorized :
  - Verifique se a chave está correta e sem espaços.
  - Confirme que está usando a rota v1beta/models/gemini-2.5-flash:generateContent .
- 429 Too Many Requests :
  - Reduza frequência, implemente retry com espera, use rotação de chaves se aplicável.
- Resposta vazia:
  - Cheque se o texto vem em choices/candidates e remova cercas de markdown (```json) antes de parsear.
  - No seu sistema, mantenha os fallbacks ativos (OpenRouter/OpenAI e heurísticas).

Principais recursos
- Busca por vídeos e Shorts com filtros de nicho, período e volume de views
- Garantia de links reais (coleta direta do YouTube com fallback via Invidious) e validação de thumbnails
- Análise com IA no modal: pontuação viral, gancho sugerido, pontos fortes e fracos, ideias de títulos específicas do vídeo, tags/nicho, horários recomendados, CTA sugerido e prompt de thumbnail
- Recomendações ajustadas ao nicho (oração, finanças, gaming, futebol, tecnologia/IA, receitas, educação, música), incluindo horários ideais e linguagem do público
- Detecção automática de Shorts para recomendações de horários de alto consumo rápido

Arquitetura e segurança
- Backend robusto com rotação de provedores de IA (Gemini, OpenRouter Grok 4.1 Fast, OpenAI 4o‑mini) e sistema de quotas “por conta do sistema”; consome quota apenas quando necessário
- Requer login e respeita permissões/plano do usuário; integra ao painel administrativo
- Respostas sempre em JSON, sem HTML inesperado, garantindo funcionamento estável no frontend

Objetivo
Tornar a pesquisa e a análise de conteúdo mais precisas, com recomendações acionáveis e específicas do vídeo selecionado, acelerando a criação de títulos, thumbnails, CTAs e planos de publicação que maximizam retenção e alcance.