Kaggle API / CLI のセットアップ

kaggle.json で認証し、コマンドラインからデータ取得・提出を自動化する方法を学びます。

Kaggle API とは#

公式の kaggle CLI を使うと、ブラウザを開かずにコマンドラインからデータのダウンロードや提出ができます。ローカル開発や自動化に便利です。

インストールと認証#

pip install kaggle

次に API トークンを取得します。Kaggle の Settings → API → Create New Token で kaggle.json（ユーザー名とキー）がダウンロードされるので、所定の場所に置きます。

# macOS / Linux
mkdir -p ~/.kaggle
mv ~/Downloads/kaggle.json ~/.kaggle/kaggle.json
chmod 600 ~/.kaggle/kaggle.json

注意

kaggle.json はパスワード相当の秘密情報です。リポジトリにコミットしたり他人と共有したりしないでください（漏れたら Settings から失効・再発行）。

よく使うコマンド#

# コンペ一覧
kaggle competitions list

# コンペデータのダウンロード（規約への同意が必要）
kaggle competitions download -c titanic

# 予測の提出
kaggle competitions submit -c titanic -f submission.csv -m "first baseline"

# データセットのダウンロード
kaggle datasets download -d <owner>/<dataset>

次のステップ#

最後に、ローカル環境とクラウド（Kaggle Notebook / Google Colab）の使い分けを整理します。