Resposta rápida
Crie a conta no Placa & FIPE, gere uma chave de API e cole o prompt pronto no Claude Code, Cursor ou Gemini CLI. A IA lê o guia em Markdown, descobre a stack do seu projeto e escreve a chamada no servidor. Se quiser que ela consulte placas durante a conversa, conecte o servidor MCP com um comando.
O que você vai ter no fim
- Uma função no servidor do seu app que recebe a placa e devolve marca, modelo, ano, cor e valor FIPE em JSON.
- A chave guardada em variável de ambiente (
PLACAEFIPE_API_KEY), nunca no navegador. - Opcional: a IA consultando placas reais direto na conversa, pelo MCP.
1. Crie a conta e gere a chave
Crie a conta em placaefipe.com.br/criar-conta. Ela já vem com 10 consultas grátis. No painel, em Chaves de API, gere uma chave e copie (ela começa com pf_live_). Se quiser, defina um teto de gasto por mês para a chave.
2. Cole o prompt na sua IA
No Claude Code, Cursor, Gemini CLI, Antigravity ou Codex, abra o projeto e cole:
Integre a API Placa & FIPE (consulta de veículo pela placa com valor FIPE) neste projeto.
Leia e siga o guia oficial para agentes: https://placaefipe.com.br/guia-ia.md
Resumo: GET https://api.placaefipe.com.br/v1/placas/{placa}?tipo=basica
Cabeçalho: Authorization: Bearer <PLACAEFIPE_API_KEY>
A chamada deve ficar só no servidor; a chave vem da variável de ambiente PLACAEFIPE_API_KEY.
Use tipo=basica (dados + FIPE, a mais barata) por padrão; tipo=completa só se o sistema precisar de chassi, Renavam ou número do motor.
Antes de escrever código, identifique a stack do projeto.
No fim, me diga onde colocar a chave e como testar.A IA lê o guia-ia.md, que foi escrito para agentes: formato de resposta, erros, o que cobrar e o que não cobrar. Ela escreve a integração na stack que você já usa (Next.js, Node, Python, PHP, Laravel, Supabase, n8n...).
3. Conecte o MCP (opcional)
Com o servidor MCP, a IA consegue consultar placas durante a conversa ("qual a FIPE da placa ABC1D23?") e usar o JSON real para escrever e testar o código. No Claude Code:
claude mcp add --transport http placaefipe https://api.placaefipe.com.br/mcp \
--header "Authorization: Bearer pf_live_sua_chave"Para Cursor, Gemini CLI, Windsurf e outros, veja a página do servidor MCP ou o guia da sua ferramenta em Integrações.
4. Teste
Peça para a IA rodar o teste ou chame direto:
curl https://api.placaefipe.com.br/v1/placas/ABC1D23 \
-H "Authorization: Bearer $PLACAEFIPE_API_KEY"Placa não encontrada responde 404 com o código placa_nao_encontrada e não desconta saldo.
Cuidados que a IA às vezes esquece
- Nunca chame a API do navegador. A chave fica exposta. A chamada tem que estar no servidor ou numa função serverless.
- Normalize a placa (maiúsculas, sem traço) antes de chamar.
- Trate o 404 como "placa não encontrada" na interface, não como erro do sistema.
- Guarde o resultado se o mesmo usuário consultar a mesma placa várias vezes.
Quanto custa
A consulta básica com FIPE custa R$ 0,09 e a completa (com chassi, Renavam e motor) R$ 0,60. Placa não encontrada não é cobrada. Saldo por Pix a partir de R$ 25, sem mensalidade.
Perguntas frequentes
Funciona com qual IA?
Claude Code, Claude Desktop, Cursor, Gemini CLI, Google Antigravity, OpenAI Codex, Windsurf e qualquer ferramenta que aceite MCP ou leia um guia em Markdown.
Preciso saber programar?
Ajuda, mas a IA escreve a integração. Você precisa saber onde colocar a variável de ambiente e testar.
A IA gasta meu saldo testando?
Só se ela fizer consultas reais pelo MCP ou pela API e a placa for encontrada. Você pode definir um teto de gasto por mês na chave.
Tem SDK?
Há exemplos em Node, Python e PHP na documentação, mas a API é REST simples: uma chamada GET com um cabeçalho.
Consulte uma placa agora
Marca, modelo, ano, cor e o valor FIPE do mês, em segundos.
