web2clip · De site a clipe com narração
Transforme um site (de preferência interativo) em uma série de clipes curtos por capítulo + 1 clipe de compilação final, no formato vertical 9:16 ou horizontal 16:9, com apresentador de IA (voz ElevenLabs), efeitos na página sincronizados com a narração (borda brilhante, cursor clicando, arrasto de barra, legendas), dados 100% precisos por serem gravados da página real.
Subcomandos (use separadamente quando precisar de apenas uma etapa)
| Comando | Etapa |
|---|---|
/web2clip-setup | 1–2 · Verificar conexão, ferramentas, permissões de rede, conta |
/web2clip-plan | 3 · Ler o site, sugerir ideias, roteiro + painel de aprovação (dashboard) |
/web2clip-voice | 4–5 · Sugerir vozes, gerar áudio para cada clipe, baixar arquivos |
/web2clip-record | 4 · Gravar vídeo sincronizado com áudio, exportar cada clipe |
/web2clip-merge | 6 · Montar clipe de compilação, nomear, entregar arquivos, armazenar |
Execute /web2clip para percorrer todas as 7 etapas abaixo em ordem. Não pule a etapa de aprovação.
Regras de ouro (baseadas em projetos reais)
- Aprovação do texto primeiro, gasto depois: o roteiro deve ser aprovado antes de gerar a voz (voz gasta créditos).
- Faça um clipe piloto antes para o usuário aprovar a voz e o estilo dos efeitos, depois produza em lote.
- A voz é de um narrador, não lê o texto da página. Tem um nome (ex.: "Chip, assistente do Sr. X"), tom amigável, começa com uma pergunta/situação e termina com uma transição para a próxima parte.
- Divida a série em clipes curtos por capítulo (1–2 minutos) e só então monte o clipe final. Não crie um clipe longo de uma vez.
- A imagem deve seguir a narração: a parte mencionada deve ficar destacada no momento certo. Use o sistema de gravação sincronizada com marcadores ocultos (
scripts/w2c/record.py), sem estimativas manuais. - Faça no máximo 1–3 perguntas ao usuário por vez, com opções pré-definidas. Avise honestamente sobre limites.
Processo em 7 etapas
1. Verificar conexão → veja /web2clip-setup
Execute python -m w2c.check_env (na pasta scripts/). Exiba uma tabela: quais ferramentas estão disponíveis, quais conexões estão ativas (ElevenLabs, Drive, Canva, navegador); se algo faltar, sugira instalação + instruções para criar conta.
2. Preparar MCP / API / permissões
Se faltar permissão de rede → oriente o usuário a liberar os domínios corretos (lista em setup). Se faltar conexão ElevenLabs → convide a conectar. Lembre de selecionar "Sempre permitir" quando a solicitação de permissão da ferramenta aparecer.
3. Criar ideias → veja /web2clip-plan
Leia o site, liste capítulos/seções, sugira: formato, duração, voz, narrador, quantos clipes. Escreva roteiro em 2 colunas (Fala · Efeitos na página). Monte um painel de aprovação (w2c.dashboard) e envie o link para o usuário ter uma visão geral e aprovar cada clipe.
4. Roteiro → voz → gravação → montagem de cada clipe
Voz: /web2clip-voice. Gravação: /web2clip-record. Atualize o painel após cada clipe.
5. Sugerir vozes
Filtre vozes por idioma, gênero, faixa etária, região; ofereça 2–3 opções com justificativa; por padrão, escolha vozes naturais, de narração.
6. Clipe final → veja /web2clip-merge
Monte em ordem, nomeie <Projeto>_Clip<N>_<NomeParte>.mp4, o clipe final nomeie 0. ..._COMPILACAO para ficar sempre no topo da pasta.
7. Entrega até 100% de satisfação
Envie arquivos + atualize o painel, faça uma prévia visual antes de enviar (extraia 4–6 frames/clipe), liste erros auto-detectados, corrija até o usuário aprovar. Salve roteiro, voz e especificações para correções rápidas.
Documentação de referência
references/loi-thuong-gap.md— erros comuns e como evitá-los (OBRIGATÓRIO ler antes de gravar).references/viet-kich-ban.md— como escrever narração envolvente + modelo de roteiro.references/chon-giong.md— como sugerir vozes, estimar créditos, pacotes ElevenLabs.examples/spec_example.json(na raiz do repositório) — exemplo de arquivo de especificação de roteiro.