Communitygithub.com

hourlore

Pesquise um tópico de história, mistério ou negócios e obtenha um preview gratuito de storyboard com 8 a 12 cenas, ou renderize um documentário completo narrado em MP4 1080p de 5 a 15 minutos, usando fotos de arquivo da Wikimedia Commons, animações de mapas e legendas palavra por palavra no Hourlore. Use quando o usuário quiser planejar ou produzir documentários longos 16:9 sem rosto.

O que é hourlore?

Hourlore é uma ferramenta de criação de documentários narrados que transforma uma simples linha de tópico em um vídeo completo em 16:9 (1080p). Ele utiliza imagens de arquivo da Wikimedia Commons (domínio público, CC0, CC BY, CC BY-SA), animações de voo sobre mapas, cartões numéricos e legendas palavra por palavra para produzir vídeos de 5 a 15 minutos. A ferramenta oferece dois modos principais: um preview gratuito de storyboard (8 a 12 cenas em ~25 segundos) e a renderização completa do documentário, que consome créditos (5 créditos por minuto). Suporta narradores masculino (Owen) e feminino (Olivia), e pode ser usado como skill do Claude Code / Claude Desktop, ou diretamente via API HTTP. O usuário deve fornecer uma chave de API armazenada na variável de ambiente `HOURLORE_API_KEY`. Antes de gastar créditos, é obrigatório mostrar o preview ao usuário e confirmar o tópico, duração e narrador. O download do vídeo completo fica disponível por 1 hora, mas pode ser renovado dentro de 30 dias.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hourlore/hourlore-mcp/tree/HEAD/skills/hourlore

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Hourlore: criador de documentários narrados de 5 a 15 minutos

Hourlore (https://hourlore.com) transforma uma única linha de tópico em um documentário narrado em 16:9 (1080p) usando imagens de arquivo da Wikimedia Commons (domínio público, CC0, CC BY, CC BY-SA), animações de voo sobre mapas, cartões numéricos e legendas palavra por palavra.

Antes de começar

  • Necessita de uma chave de API de https://hourlore.com/account armazenada na variável de ambiente HOURLORE_API_KEY do usuário (hl_...). Nunca peça ao usuário para codificar chaves diretamente em arquivos fonte.
  • Primeiro o preview, depois pergunte antes de gastar créditos:
    • create_storyboard_preview é gratuito (até 10 previews/dia por conta) e retorna de 8 a 12 cenas iniciais em ~25 segundos.
    • create_documentary_film consome 25 créditos (5 min), 50 créditos (10 min) ou 75 créditos (15 min) (5 créditos = 1 minuto). Sempre confirme o tópico, a duração (5, 10 ou 15 minutos) e o narrador (olivia feminino ou owen masculino) com o usuário antes de enfileirar uma renderização completa.
  • Mantenha o description_text retornado junto com qualquer vídeo publicado para que as atribuições Creative Commons (CC BY / CC BY-SA) sejam preservadas.

Com as ferramentas MCP (https://hourlore.com/mcp)

  1. Chame create_storyboard_preview (topic, opcional notes) para testar o ângulo e mostrar ao usuário a narração inicial e as imagens de arquivo.
  2. Verifique o saldo com get_credits se necessário.
  3. Após a aprovação, chame create_documentary_film (topic, minutes: 5 | 10 | 15, voice: olivia | owen, opcional notes, opcional idempotency_key).
  4. As renderizações completas levam aproximadamente 1× o tempo do filme (~10–20 minutos). Consulte get_documentary_film (film_id, opcional wait_seconds até 50) até que status === "completed", então forneça ao usuário download_url (válido por 1 hora; chame get_documentary_film novamente a qualquer momento dentro de 30 dias para obter um link renovado) e description_text.
  5. Se o usuário mudar de ideia logo após enfileirar, chame cancel_documentary_film (film_id) enquanto cancelable for true para reembolsar os créditos retidos.

Sem MCP (API HTTP)

URL base: https://hourlore.com/api/v1 com Authorization: Bearer $HOURLORE_API_KEY:

  • POST /api/v1/previews — { "topic": "...", "notes": "..." }
  • POST /api/v1/films — { "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." } (cabeçalho opcional Idempotency-Key)
  • GET /api/v1/films/:id — status, download_url e description_text
  • DELETE /api/v1/films/:id — cancela o trabalho enfileirado e libera os créditos retidos
  • GET /api/v1/credits — { credits, held, credits_per_minute: 5 }

Habilidades Relacionadas