Vídeo vira Mapa
Você assiste um vídeo de viagem cheio de lugar bom, salva, e semana que vem já salvou mais dez. Aí chega a hora de viajar e você tem uma pilha de vídeos e nenhum lugar anotado. Este sistema resolve isso: você cola a legenda do vídeo (aquele textão embaixo do post) e ele acha cada lugar citado e crava num mapa, com o motivo de ir em cada um. É o mesmo que roda no meu Laboratório, em público.
O que resolve
O trabalho chato de organizar viagem é pegar aquele monte de dica solta e transformar em algo que você usa: um mapa com os lugares marcados. Os apps que prometem isso quase sempre salvam o vídeo pra você assistir de novo, e o trabalho de anotar continua todo com você. O pulo do gato é a extração: ler o texto e tirar dali os nomes de verdade, o café, o mirante, o restaurante. É exatamente aí que o app número 1 do setor (com 4,8 estrelas) tropeça. Este sistema faz três coisas: lê a legenda, lista cada lugar com uma linha explicando por que ir, e coloca todos num mapa. Um vídeo que cita dez lugares vira dez pontinhos no mapa em segundos.
Os ingredientes
- O programa em si (a pasta com todo o código pronto, o "repositório", ou "repo"). É só baixar.
- Uma "chave de acesso" de uma IA (a sua). É o que autoriza o programa a ler a legenda e listar os lugares. Você pega no painel do fornecedor de IA e cola no arquivo de configuração. Essa parte é trocável: quer usar outro modelo de IA amanhã? Muda uma linha.
- Um serviço que transforma nome de lugar em ponto no mapa (isso se chama geocodificação). Uso o do OpenStreetMap, o mapa aberto e gratuito da internet, sem chave e sem pagar nada.
- A biblioteca que desenha o mapa na tela (chama-se Leaflet, também gratuita). Ela vem junto com o programa, guardada dentro da própria pasta, não é baixada de fora.
- Um lugar na nuvem pra ele morar (um servidor barato), pra a ferramenta ficar no ar pros seus clientes usarem.
- O Claude Code pra instalar e ajustar. Nunca usou? O "01 · Instalação do zero" começa do zero absoluto.
.env.example) pra você preencher. E o mapa e a geocodificação são de graça, você não fica preso a nenhum fornecedor pago.Acesso liberado pra membro. O repo é privado no GitHub, amarrado ao seu login.
O modo de preparo
- Baixa a pasta do programa e abre ela no Claude Code.
- Põe a sua chave de IA no arquivo de configuração (copia o modelo
.env.example, renomeia pra.enve cola a chave). - Sobe no servidor do jeito que já vem pronto (ele expõe um endereço que a sua página do site chama por trás). O passo a passo está no arquivo de deploy dentro do repo.
- Abre a página, cola a legenda de um vídeo de viagem de verdade, e confere: apareceram os lugares na lista e os pontinhos no mapa? Deu certo? Tá no ar.
O que queimou
Os perrengues que você não passa de novo porque eu já passei:
- O mapa jogava o lugar no país errado. Existe uma "Manteigaria" em Lisboa e outra em São Paulo. Quando eu pedia só "Manteigaria", o serviço de mapa às vezes chutava a de São Paulo, e o "Bonde 28" de Lisboa foi parar na Suécia. O conserto: primeiro eu localizo a cidade do vídeo e uso ela como âncora, tudo que cai longe demais dali é descartado. E aqui está a regra de ouro: ponto errado no mapa é pior que ponto nenhum. Quando não dá pra localizar com segurança, ele escreve "não consegui localizar" em vez de fingir. Honestidade acima de encher o mapa.
- O site tem uma trava de segurança que bloqueia programa de fora. Sites sérios têm uma regra (chama-se CSP) que só deixa rodar código que mora no próprio site, pra ninguém injetar coisa estranha. A biblioteca do mapa, quando eu tentei puxar de um site externo, foi bloqueada em silêncio, o mapa simplesmente não aparecia, e nenhum aviso na tela. A pista veio de olhar o "porão" do navegador (o console de erros). Conserto: trazer a biblioteca pra dentro da pasta do site. Lição que vale pra sempre: biblioteca nova, guarda dentro de casa, não puxa de fora.
- Ele lê só o que está escrito, nunca inventa. Se a legenda não cita um lugar de verdade, ele não põe no mapa, e se for uma atividade solta ("passeio de barco") em vez de um endereço, ele lista mas avisa que não deu pra cravar o ponto. Nada de encher o mapa com lugar imaginário só pra parecer completo.
- "Deployou" não é "funciona". Depois de subir tudo, parecia pronto, mas o preview travava e eu não via o mapa. Só quando abri a página de verdade num navegador automatizado (que preenche o formulário sozinho e tira a foto) é que a trava de segurança apareceu. Testar de mentira engana; testar de verdade é abrir e usar.