Integração com IA
O Placa & FIPE foi documentado para ser integrado por assistentes de IA. Você não precisa ler a documentação inteira: copie o pedido abaixo, cole no seu assistente e ele faz o resto.
O pedido pronto
Cole no Claude Code, Cursor, Gemini CLI, Antigravity, Codex, Windsurf, Lovable ou Bolt:
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}
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.
Antes de escrever código, identifique a stack do projeto.
No fim, me diga onde colocar a chave e como testar.No site, o botão Copiar instruções para a IA copia exatamente esse texto.
O que a IA vai ler
| Arquivo | Para quê |
|---|---|
| /guia-ia.md | Passo a passo para o agente: stack, variável de ambiente, código, tela, erros e teste |
| /llms.txt | Índice do site para IAs |
| /llms-full.txt | Toda a documentação num arquivo só |
| /openapi.json | Especificação OpenAPI 3.1 |
/docs/{pagina}.md | Cada página da documentação em Markdown (ex.: /docs/consultar-placa.md) |
Regra para o projeto (AGENTS.md, CLAUDE.md, GEMINI.md)
Para a IA lembrar da integração nas próximas tarefas, adicione ao arquivo de instruções do projeto (AGENTS.md, CLAUDE.md, GEMINI.md ou .cursor/rules/placaefipe.mdc):
## Consulta de placa (Placa & FIPE)
- Dados de veículo e valor FIPE vêm da API Placa & FIPE: GET https://api.placaefipe.com.br/v1/placas/{placa}
- Autenticação: Authorization: Bearer ${PLACAEFIPE_API_KEY} (só no servidor, nunca no front)
- Erros: use erro.codigo (placa_invalida, placa_nao_encontrada, sem_creditos, limite_excedido, indisponivel)
- Todo campo pode ser null, exceto placa e consulta. FIPE com várias versões vem em fipe.versoes
- Referência completa: https://placaefipe.com.br/llms-full.txtSkill para Claude Code
Baixe a skill em /skill/SKILL.md e salve em .claude/skills/placaefipe/SKILL.md. O Claude Code passa a saber integrar e usar a API sempre que o assunto for placa ou FIPE.
Servidor MCP
Para a IA consultar placas durante a conversa (e não só escrever o código), conecte o servidor MCP.
Guias por ferramenta
Passo a passo e configuração de cada uma em Integrações: Claude Code, Cursor, Gemini CLI, Google Antigravity, OpenAI Codex, Windsurf, Lovable, Bolt.new, v0 e n8n.