# fipeX MCP [Health: Active] **Category:** 💰 Finance & Fintech **Repository:** https://github.com/fipex-labs/dataset **GitHub Stars:** 6 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/fipex-mcp ## Description Brazilian FIPE vehicle reference prices: search, current price, history and comparison. Keyless. ## Claude Desktop Quick Installation Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client: ```json "mcpServers": { "fipex-mcp": { "url": "https://fipex.com.br" } } ``` ## Documentation & README --- license: cc0-1.0 task_categories: - tabular-regression - time-series-forecasting language: - pt tags: - fipe - veiculos - brasil - carros - precos pretty_name: fipeX - Dados de Veículos da Tabela FIPE size_categories: - 1M **Por que apenas versão original nos dumps por período?** > A versão consolidada (merged) reflete o estado *atual* das fusões de modelos, que muda ao longo do tempo conforme a FIPE renomeia veículos. Um dump merged feito hoje seria diferente de um feito daqui a 6 meses. Para dados por período, a versão original é a única que permanece imutável e reproduzível. ### Qual versão usar? Ambas as versões do histórico completo contêm **o mesmo número de registros de preços**. A diferença está na atribuição dos nomes de modelos: **Versão Original** (`fipex-prices-latest.csv` / `.parquet`): - Usa os nomes de modelos exatamente como foram publicados pela FIPE em cada período - Se a FIPE renomeou um modelo (ex: "Gol 1.0 Mi" → "Gol 1.0 12V"), os preços antigos mantêm o nome original - Ideal para análises históricas que precisam rastrear renomeações ao longo do tempo **Versão Consolidada/Merged** (`fipex-prices-latest-merged.csv` / `.parquet`): - Unifica modelos renomeados sob o nome atual em **todos os períodos** - Se um modelo foi renomeado, os preços históricos também aparecem com o nome novo - Ideal para consultas e análises onde se quer acompanhar a evolução de preço de um veículo sem se preocupar com mudanças de nomenclatura **Formato CSV** (`.csv`): - Separado por tabulação (`\t`) - TSV format - Compatível com Excel, Google Sheets, e qualquer ferramenta de análise de dados - Fácil de ler e inspecionar visualmente - Tamanho maior que Parquet **Formato Parquet** (`.parquet`): - Formato colunar binário otimizado para análise - Compressão eficiente (~70% menor que CSV) - Leitura 3-5x mais rápida que CSV - Ideal para processamento em Python/Pandas, Spark, DuckDB - Preserva tipos de dados nativamente ## Estrutura dos Dados Todos os arquivos compartilham a mesma estrutura de 12 colunas: | Coluna | Tipo | Descrição | |----------------------|--------|---------------------------------------------------------------| | `tipo_veiculo` | string | Categoria do veículo (carro, moto, caminhão) | | `codigo_fipe` | string | Código único do veículo na FIPE | | `nome_modelo` | string | Nome do modelo (ex: Palio 1.0, Corolla XEi) | | `nome_marca` | string | Fabricante do veículo (ex: Fiat, Toyota) | | `nome_combustivel` | string | Tipo de combustível (Gasolina, Diesel, Flex, etc) | | `sigla_combustivel` | string | Sigla do combustível (g, e, d, l, f, h, n) | | `ano_modelo` | int | Ano de fabricação do modelo | | `zero_km` | bool | Se o veículo é zero quilômetro (true/false) | | `valor_centavos` | int | Valor do veículo em centavos (evita erros de ponto flutuante) | | `valor_formatado` | string | Valor do veículo em Reais (R$) para facilidade de leitura | | `mes_referencia` | int | Mês de referência da tabela FIPE (1-12) | | `ano_referencia` | int | Ano de referência da tabela FIPE | ## Exemplos de Uso ### Python - Polars ```python import polars as pl # Carregar CSV (note o separador tab) df = pl.read_csv("fipex-prices-latest-merged.csv", separator="\t") # Carregar Parquet (mais rápido!) df = pl.read_parquet("fipex-prices-latest-merged.parquet") # Estatísticas básicas print(f"Total de registros: {df.height:,}") print(f"Total de marcas: {df['nome_marca'].n_unique():,}") # Top 10 marcas print(df.group_by("nome_marca").len().sort("len", descending=True).head(10)) ``` Para mais exemplos completos, veja [`examples/python.py`](examples/python.py). ### SQL - DuckDB ```sql -- Carregar Parquet diretamente SELECT nome_marca, COUNT(*) as total FROM 'fipex-prices-latest-merged.parquet' GROUP BY nome_marca ORDER BY total DESC LIMIT 10; ``` Mais consultas prontas em [`examples/duckdb.sql`](examples/duckdb.sql). ## Aviso Legal Este dataset é derivado de informações públicas disponibilizadas pela FIPE. O fipeX é um projeto independente e **não possui afiliação** com a Fundação Instituto de Pesquisas Econômicas (FIPE). Os dados são fornecidos "como estão", sem garantias de precisão absoluta. Recomenda-se utilizar com cautela para decisões financeiras críticas. ## Atualização Os dados são extraídos do banco de dados do FipeX. A intenção é manter este dataset atualizado mensalmente conforme a FIPE libera novas tabelas. ## Como contribuir Veja [CONTRIBUTING.md](CONTRIBUTING.md). Scripts de exemplo em outras linguagens (R, Julia, Spark, etc.) são especialmente bem-vindos. ## Projetos relacionados | Recurso | Conteúdo | |--------------------------------------------------------------|-------------------------------------------------------| | [fipex-labs/dataset](https://github.com/fipex-labs/dataset) | Este repositório — dataset (CC0) | | [fipex.com.br](https://fipex.com.br) | Consulta da Tabela FIPE, gratuita e sem cadastro | | [API pública](https://fipex.com.br/dados-e-api) | API REST gratuita, sem chave, 10 req/s por IP |