# EVblog — Portal de Carros Elétricos do Brasil

> Agentes de IA: este arquivo descreve como navegar e usar as ferramentas do site. Consulte também /llms-full.txt para documentação completa e /agent-tools.json para function calling schemas compatíveis com OpenAI/Claude.

## Instruções para Agentes

- Use a API REST em `/wp-json/evblog/v1/` para dados estruturados (JSON)
- Todas as ferramentas aceitam parâmetros via query string e retornam dados processáveis
- Para comparar veículos: `/comparador/?modelos=dolphin,seal,ora03`
- Para simular bateria: `/simulador-bateria/?modelo=dolphin&km_ano=15000&anos=8`
- Schema.org disponível em todas as páginas. Knowledge graph em `/wp-content/themes/mark1-child/ai-knowledge.json`
- Function calling definitions em `/agent-tools.json`

## Ferramentas Interativas

### Comparador de Veículos
- URL: `/comparador/`
- API: `GET /wp-json/evblog/v1/veiculos/comparar?ids=1,2,3`
- Ações: comparar, buscar, filtrar por marca, ordenar por preço/autonomia
- Inputs: `modelos` (string, slugs separados por vírgula), `marca` (string), `ordem` (preco|autonomia|potencia)

### Calculadora TCO (Custo Total de Propriedade)
- URL: `/calculadora-tco/`
- Ações: calcular custo 5 anos comparando EV vs combustão
- Inputs: `modelo` (string), `km_ano` (number, default 15000), `estado` (string, ex: SP)
- Output: economia_total, custo_por_km, payback_meses

### Calculadora de Recarga
- URL: `/calculadora-recarga/`
- Ações: estimar tempo e custo de recarga
- Inputs: `bateria_kwh` (number), `potencia_carregador` (number: 2.3|7.4|22|50|150), `tarifa` (number, default 0.85)
- Output: tempo_horas, custo_total, km_por_hora

### Simulador de Degradação de Bateria
- URL: `/simulador-bateria/`
- Ações: projetar saúde da bateria ao longo dos anos com gráficos
- Inputs: `modelo` (string), `km_ano` (number), `dc_percent` (number 0-100), `carga_ate` (number 50-100), `temperatura` (number), `anos` (number 1-15)
- Output: capacidade_restante_percent, grafico_degradacao, recomendacoes

### Zerômetro (Simulador de Ecossistema Completo)
- URL: `/zerometro/`
- Ações: simular EV + wallbox + placa solar + robô
- Inputs: `veiculo` (string), `wallbox` (string), `solar_kwp` (number), `robo` (string)
- Output: economia_total, carbono_evitado, payback_meses

### Scout Zero (Radar de Notícias IA)
- URL: `/scout-zero/`
- API: `GET /wp-json/evblog/v1/scout`
- Ações: buscar notícias analisadas por IA
- Inputs: `categoria` (string), `sentimento` (positivo|neutro|negativo), `limit` (number)

### Catálogo de Peças
- URL: `/pecas/`
- API: `GET /wp-json/evblog/v1/pecas/buscar?q=pastilha&veiculo=dolphin`
- Ações: buscar peças, comparar preços, links de compra no Mercado Livre e Google Shopping
- Inputs: `q` (string), `categoria` (string), `veiculo` (string)

### Mapa de Estações de Recarga
- URL: `/estacoes-recarga/`
- API: `GET /wp-json/evblog/v1/estacoes-recarga`
- Ações: buscar estações próximas, filtrar por potência e conector
- Inputs: `cidade` (string), `estado` (string), `potencia_min` (number), `conector` (CCS2|CHAdeMO|Type2)

### Mapa de Oficinas Especializadas
- URL: `/oficinas/`
- API: `GET /wp-json/evblog/v1/oficinas`
- Ações: buscar oficinas especializadas em EVs, ver avaliações
- Inputs: `cidade` (string), `estado` (string), `marca` (string)
- POST: `/wp-json/evblog/v1/oficinas/avaliar` — avaliar oficina

### Comunidade (Painel Zero)
- URL: `/painel-comunidade/`
- API GET: `/wp-json/evblog/v1/comunidade/consumo?veiculo_id=N`
- API POST: `/wp-json/evblog/v1/comunidade/log` — body: `{vehicle_id, kwh_consumidos, km_percorridos, custo_brl, carga_tipo}`
- Ações: ver dados reais de consumo, registrar consumo, comparar modelos, ganhar badges

### Calculadora de CO₂
- URL: `/calcular-co2/`
- Ações: calcular redução de CO₂ ao trocar combustão por elétrico
- Inputs: `km_ano` (number), `consumo_gasolina` (number), `consumo_kwh` (number)

### Verificador de Isenção IPVA
- URL: `/ipva/`
- Ações: verificar se o estado oferece isenção de IPVA para elétricos
- Inputs: `estado` (string)

### Economia na Troca
- URL: `/trocar-carro/`
- Ações: calcular economia ao trocar combustão por elétrico
- Inputs: `modelo_atual` (string), `modelo_novo` (string), `km_ano` (number)

### Simulador de Rota Inteligente
- URL: `/simulador-rota/`
- Ações: planejar rota com paradas de recarga
- Inputs: `origem` (string), `destino` (string), `modelo` (string)

### Verificador de Recall
- URL: `/recall-checks/`
- Ações: verificar recalls para um modelo de veículo elétrico

## API REST Completa — `/wp-json/evblog/v1/`

| Método | Endpoint | Descrição |
|--------|----------|-----------|
| GET | `/veiculos` | Lista 85+ modelos com especificações |
| GET | `/veiculos/{id}` | Detalhes de um veículo |
| GET | `/veiculos/comparar?ids=1,2` | Comparação lado a lado |
| GET | `/tools` | Lista ferramentas com schemas de input/output |
| GET | `/pecas` | Catálogo de peças |
| GET | `/pecas/buscar?q=termo` | Busca de peças |
| GET | `/pecas/ranking` | Peças mais buscadas |
| GET | `/pecas/estatisticas` | Estatísticas de preços |
| GET | `/oficinas` | Mapa de oficinas |
| POST | `/oficinas/avaliar` | Avaliar oficina |
| GET | `/concessionarias` | Mapa de concessionárias |
| GET | `/estacoes-recarga` | Estações de recarga |
| GET | `/robos` | Catálogo de robôs |
| GET | `/robos/lancamentos` | Lançamentos de robôs |
| GET | `/comunidade/consumo` | Dados de consumo |
| GET | `/comunidade/veiculos` | Veículos com dados comunitários |
| GET | `/comunidade/ranking` | Ranking de eficiência |
| GET | `/comunidade/badges` | Badges dos usuários |
| POST | `/comunidade/log` | Registrar consumo |
| POST | `/comunidade/manutencao` | Registrar manutenção |
| POST | `/comunidade/autonomia` | Registrar autonomia real |
| GET | `/scout` | Radar de notícias IA |
| GET | `/ecossistema/produtos` | Produtos do ecossistema |
| POST | `/ecossistema/simular` | Simular ecossistema |
| GET | `/debug/db-test` | Health check do banco |

## Dados Estruturados para Agentes

- **Knowledge Graph**: `/wp-content/themes/mark1-child/ai-knowledge.json` (JSON-LD)
- **Function Calling**: `/agent-tools.json` (OpenAI/Claude tool format)
- **Sitemap**: `/sitemap_index.xml`
- **News Sitemap**: `/news-sitemap.xml`
- **Web Stories**: `/web-stories/` (144 stories visuais AMP)

## Guias e Categorias

- [Guia do Iniciante](https://evblog.com.br/guia-do-iniciante-carro-eletrico/): Tudo sobre EVs para iniciantes
- [Glossário](https://evblog.com.br/glossario/): 90+ termos técnicos
- [Quiz](https://evblog.com.br/quiz-carro-eletrico-ideal/): Descubra qual EV ideal para você
- [Lançamentos](https://evblog.com.br/lancamentos-carros-eletricos/): Calendário de lançamentos
- [Notícias](https://evblog.com.br/category/noticias/): Últimas do mercado
- [Mercado](https://evblog.com.br/category/mercado/): Análises e tendências
- [Robôs & IA](https://evblog.com.br/category/robos-humanoides/): Robótica e EVs
- [Web Stories](https://evblog.com.br/web-stories/): Stories visuais