fipeX MCP

---

license: cc0-1.0 task_categories:

• tabular-regression
• time-series-forecasting language:
• pt tags:
• fipe
• veiculos
• brasil
• carros
• precos pretty_name: fipeX - FIPE テーブルの車両データ size_categories:
• 1M<n<10M

---

fipeX：FIPE テーブルの完全なデータセット

このデータセットには、FIPE テーブル（経済研究所）に基づく、ブラジルで販売された車両の過去および現在の価格が含まれています。

データはプロジェクト fipeX によって抽出、整理されています。無料の公開 API と、このパブリックドメインのデータセットを通じて、公開されている自動車データへのアクセスを容易にする独立した取り組みです。

ライセンス： CC0-1.0 — パブリックドメインです。帰属表示は不要で、商用利用を含め自由にご利用いただけます（もちろん、帰属表示していただけるとうれしいです）。

データセットについて

このデータセットは、次の用途に最適です。

• 車両の減価償却分析
• 価格予測（機械学習）
• ブラジルの自動車市場に関する経済研究
• 検索・分析アプリケーションの作成

データの取得方法

データセットは3つの方法で配布されています。

1. GitHub Releases（直接ダウンロードにおすすめ）

完全なスナップショット（CSV 約1 GB／Parquet 約120 MB）は、github.com/fipex-labs/dataset/releases の リリースアセットとして公開されています。各タグ（v2026.05.0、v2026.04.0 など）は、FIPE の月次基準データに対応しています。

# Download direto do release mais recente
curl -L -o fipex-prices-latest-merged.parquet \
  https://github.com/fipex-labs/dataset/releases/latest/download/fipex-prices-latest-merged.parquet

# Ou via gh CLI
gh release download --pattern '*.parquet' -R fipex-labs/dataset

2. Hugging Face Datasets

公式ミラーは huggingface.co/datasets/alanwgt/fipex-veiculos-brasil にあります。ML スタック（datasets、polars など）との統合に最適です。

3. 月ごとの個別ダンプ（git 内）

基準期間ごとのダンプ（2026/01/、2026/02/、…）はこのリポジトリ内にあります。ファイルサイズが小さく、バージョン管理もでき、過去の全データをダウンロードせずに特定の期間を分析するのに便利です。

利用可能なファイル

全期間の履歴（GitHub Releases 経由）

リリースごとに、2種類のデータと2種類の形式を組み合わせた4つのファイルがあります。

ファイル	バージョン	形式	説明
fipex-prices-latest.csv	オリジナル	CSV	FIPE が公開した過去のデータ
fipex-prices-latest-merged.csv	統合版	CSV	現在のモデル名を反映した統合ビュー
fipex-prices-latest.parquet	オリジナル	Parquet	列指向に最適化された形式のオリジナル版
fipex-prices-latest-merged.parquet	統合版	Parquet	列指向に最適化された形式の統合版

基準期間別（YYYY/MM/）

FIPE の基準期間ごとの個別ダンプは、オリジナル版のみ利用できます。

ファイル	形式	説明
YYYY/MM/fipex-prices.csv	CSV	FIPE が公開した基準期間の価格
YYYY/MM/fipex-prices.parquet	Parquet	同じデータを列指向に最適化された形式で収録

基準期間別のダンプがオリジナル版のみである理由 統合版（merged）は、モデル統合の現在の状態を反映しており、FIPE が車両名を変更するたびに時間の経過とともに変わります。今日作成した統合版のダンプは、6か月後に作成したものとは異なります。基準期間別のデータでは、オリジナル版だけが不変で再現可能な状態を保ちます。

どちらのバージョンを使えばよいですか？

履歴データの両バージョンには、同じ数の価格レコードが含まれています。違いは、モデル名の割り当て方法にあります。

オリジナルバージョン（fipex-prices-latest.csv / .parquet）：

• 各期間に FIPE が公開したモデル名をそのまま使用します
• FIPE がモデル名を変更した場合（例：「Gol 1.0 Mi」→「Gol 1.0 12V」）、過去の価格には変更前の名前が保持されます
• 時間の経過に伴う名称変更を追跡する必要がある履歴分析に最適です

統合／マージ済みバージョン（fipex-prices-latest-merged.csv / .parquet）：

• 名称変更されたモデルを、すべての期間で現在の名称に統一します
• モデル名が変更された場合、過去の価格にも新しい名前が表示されます
• 名称の変更を気にせず車両の価格推移を追跡したい場合の、検索や分析に最適です

CSV 形式（.csv）：

• タブ区切り（\t）の TSV 形式です
• Excel、Google Sheets、およびあらゆるデータ分析ツールと互換性があります
• 読みやすく、目視で確認しやすい形式です
• Parquet よりファイルサイズが大きくなります

Parquet 形式（.parquet）：

• 分析に最適化されたバイナリ列指向形式です
• 効率的に圧縮されます（CSV より約 70％小さくなります）
• CSV より 3〜5 倍高速に読み込めます
• Python/Pandas、Spark、DuckDB での処理に最適です
• データ型がネイティブに保持されます

データ構造

すべてのファイルで、次の 12 列の同じ構造を使用しています。

列	型	説明
tipo_veiculo	string	車両のカテゴリ（車、オートバイ、トラック）
codigo_fipe	string	FIPE における車両の一意のコード
nome_modelo	string	モデル名（例：Palio 1.0、Corolla XEi）
nome_marca	string	車両メーカー（例：Fiat、Toyota）
nome_combustivel	string	燃料の種類（ガソリン、ディーゼル、フレックスなど）
sigla_combustivel	string	燃料の略号（g、e、d、l、f、h、n）
ano_modelo	int	モデルの製造年
zero_km	bool	車両が新車であるかどうか（true/false）
valor_centavos	int	センターボ単位の車両価格（浮動小数点の誤差を回避）
valor_formatado	string	読みやすいようにレアル（R$）で表した車両価格
mes_referencia	int	FIPE テーブルの基準月（1〜12）
ano_referencia	int	FIPE テーブルの基準年

使用例

Python - Polars

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))

詳しい使用例については、examples/python.py をご覧ください。

SQL - DuckDB

-- 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;

すぐに使えるその他のクエリは、examples/duckdb.sql にあります。

免責事項

このデータセットは、FIPE が公開している情報を基にしています。fipeX は独立したプロジェクトであり、Fundação Instituto de Pesquisas Econômicas（FIPE）とは一切提携していません。

データは「現状のまま」提供され、絶対的な正確性は保証されません。重要な財務上の判断に使用する場合は、慎重にご利用ください。

更新

データは FipeX のデータベースから抽出されています。FIPE が新しいテーブルを公開するのに合わせて、このデータセットを毎月更新する予定です。

貢献方法

CONTRIBUTING.md をご覧ください。他の言語（R、Julia、Spark など）でのサンプルスクリプトも、特に歓迎します。

関連プロジェクト

リソース	内容
fipex-labs/dataset	このリポジトリ — データセット（CC0）
fipex.com.br	FIPE テーブルを無料で検索できます。登録は不要です
公開 API	無料の REST API。キー不要、IP あたり 10 req/s