diegoivo
README.md

Monitor de Palavras-chave Google

App de monitoramento de ranking de palavras-chave no Google Brasil usando Serper.dev.

šŸš€ Funcionalidades

  • Plano Gratuito: 1 projeto, 10 palavras-chave, atualizaƧƵes semanais
  • Plano Unlimited: Projetos ilimitados, palavras-chave ilimitadas, atualizaƧƵes diĆ”rias
  • HistĆ³rico completo de posiƧƵes
  • Interface simples e focada no Brasil
  • Dados completos: posiĆ§Ć£o, URL, tĆ­tulo e snippet

šŸ“ Estrutura

  • backend/ - API Hono + SQLite
  • frontend/ - React + TailwindCSS
  • cron/ - Jobs de verificaĆ§Ć£o de ranking
  • scripts/ - UtilitĆ”rios de setup

āš™ļø ConfiguraĆ§Ć£o

Defina as variƔveis de ambiente:

  • SERPER_API_KEY - Sua chave da API Serper.dev
  • JWT_SECRET - Segredo para tokens JWT (opcional, tem fallback)

šŸ‘¤ Contas de Teste

UsuƔrio Unlimited:

  • Email: unlimited@keywordmonitor.com
  • Senha: unlimited123

šŸ”§ Como Usar

  1. Acesse o app no navegador
  2. Registre uma conta ou use a conta unlimited
  3. Crie um projeto com seu domĆ­nio
  4. Adicione palavras-chave para monitorar
  5. Acompanhe os rankings no dashboard

šŸ“Š Cron Job

O cron job /cron/check-rankings.ts verifica automaticamente:

  • UsuĆ”rios gratuitos: 1x por semana
  • UsuĆ”rios unlimited: Diariamente

Configure o schedule no Val Town web UI apĆ³s deployment.

šŸ› ļø Tecnologias

  • Backend: Hono + SQLite
  • Frontend: React 18 + TailwindCSS
  • API: Serper.dev para dados do Google
  • AutenticaĆ§Ć£o: JWT
  • Hospedagem: Val Town

šŸ“ˆ PrĆ³ximos Passos

  • GrĆ”ficos de evoluĆ§Ć£o de posiĆ§Ć£o
  • Alertas por email
  • ExportaĆ§Ć£o de dados
  • ComparaĆ§Ć£o com concorrentes
  • AnĆ”lise de SERP features