# fipeX

> fipeX é uma camada de inteligência sobre a tabela FIPE — a referência mensal oficial de preços de veículos no Brasil. Oferece histórico de preços, tendências, retenção de valor, comparações e posição no segmento para carros, motos e caminhões, além de API REST e dataset aberto.

Host canônico: https://www.fipex.com.br. Todo o conteúdo é derivado de dados públicos da tabela FIPE; uso por assistentes de IA (busca, respostas e treinamento) é permitido — ver robots.txt.

Páginas de preço seguem o padrão `/preco/{marca}/{modelo}/{ano}/{combustivel}`: `{marca}` e `{modelo}` são slugs que podem ter sufixo (ex.: `fiat-21`), `{ano}` é o ano-modelo ou `zero` para veículo novo (0km) e `{combustivel}` é a sigla do combustível em minúsculas (ex.: `f` flex, `g` gasolina, `d` diesel). Exemplo: `/preco/fiat-21/argo-drive-1-0-6v-flex/2022/f`. Use os slugs exatamente como aparecem nos sitemaps, sem derivá-los do nome do veículo. Todas as URLs ativas estão no índice de sitemaps referenciado no robots.txt. A mesma URL de preço serve Markdown quando a requisição envia o cabeçalho `Accept: text/markdown`.

Páginas por marca e modelo agrupam as páginas de preço: `/preco` lista as marcas, `/preco/{marca}` lista os modelos da marca, `/preco/{marca}/{modelo}` traz a faixa de preço de cada ano-modelo e `/preco/{marca}/{modelo}/{ano}` lista as versões daquele ano (código FIPE, combustível, preço e variação mensal), com link para cada página de preço. Aqui `{marca}` e `{modelo}` são slugs da marca e da família de modelos (ex.: `/preco/chevrolet/onix/2020`), diferentes dos slugs das páginas de preço; um slug de fabricante como `fiat-21` redireciona para `/preco/fiat`. Páginas com uma única versão não são indexadas; as demais estão no sitemap `/sitemap-hubs.xml`.

Relatório mensal: `/tabela-fipe` lista todos os meses desde abril de 2010 e `/tabela-fipe/{ano}/{mes}` (ex.: `/tabela-fipe/2026/outubro`, mês por extenso sem acento) mostra, por tipo de veículo, quantos preços subiram, caíram e ficaram iguais em relação ao mês anterior, as maiores altas e quedas, as versões novas e as que perderam o preço 0 km. `/desvalorizacao/carros`, `/desvalorizacao/motos` e `/desvalorizacao/caminhoes` comparam o preço FIPE atual com o primeiro preço publicado para o mesmo ano-modelo, por idade (1 a 10 anos), em reais nominais. São preços de referência da FIPE, não preços de venda. Essas páginas estão no sitemap `/sitemap-relatorios.xml`.

## Páginas principais

- [Início](https://www.fipex.com.br/): busca de veículos por nome
- [Tabela FIPE por marca](https://www.fipex.com.br/preco): todas as marcas, com links para modelos, anos e versões
- [Tabela FIPE mês a mês](https://www.fipex.com.br/tabela-fipe): relatório mensal de altas e quedas, um por mês desde 2010
- [Desvalorização de carros](https://www.fipex.com.br/desvalorizacao/carros): retenção do preço FIPE por idade (também motos e caminhões)
- [Busca avançada](https://www.fipex.com.br/busca-avancada): catálogo completo com filtros por tipo, marca, ano, combustível e preço
- [Comparar](https://www.fipex.com.br/comparar): comparação lado a lado de até 4 veículos
- [Dados & API](https://www.fipex.com.br/dados-e-api): porta de entrada para a API REST, o dataset aberto e o schema
- [Sobre](https://www.fipex.com.br/sobre): o que é o fipeX e de onde vêm os dados

## Dados e API

- [Documentação da API (Swagger)](https://www.fipex.com.br/api/v1/docs): API REST pública em https://api.fipex.com.br
- Servidor MCP (streamable HTTP, sem chave): https://api.fipex.com.br/mcp — ferramentas `search_vehicles`, `get_price`, `get_price_history`, `compare_prices`
- [Dataset aberto no Hugging Face](https://huggingface.co/datasets/alanwgt/fipex-veiculos-brasil): tabela FIPE completa em Parquet, atualizada mensalmente
- [Repositório do dataset](https://github.com/fipex-labs/dataset): issues e documentação do dataset

## Conceitos

- "Tabela FIPE" é a publicação mensal oficial de preços de referência; fipeX consome essa tabela, não a substitui.
- "Referência" é o mês de publicação FIPE em que um preço foi cotado (ex.: "Maio de 2026").
- "Retenção" é quanto do valor um veículo manteve desde sua primeira aparição na tabela FIPE.