# 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:

```text
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](/guia-ia.md) | Passo a passo para o agente: stack, variável de ambiente, código, tela, erros e teste |
| [/llms.txt](/llms.txt) | Índice do site para IAs |
| [/llms-full.txt](/llms-full.txt) | Toda a documentação num arquivo só |
| [/openapi.json](/openapi.json) | Especificação OpenAPI 3.1 |
| `/docs/{pagina}.md` | Cada página da documentação em Markdown (ex.: [/docs/consultar-placa.md](/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`):

```markdown
## 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.txt
```

## Skill para Claude Code

Baixe a skill em [/skill/SKILL.md](/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](/docs/mcp).

## Guias por ferramenta

Passo a passo e configuração de cada uma em [Integrações](/integracoes): Claude Code, Cursor, Gemini CLI, Google Antigravity, OpenAI Codex, Windsurf, Lovable, Bolt.new, v0 e n8n.