> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# Kaggle 数据集

> 使用 Kaggle API 从终端下载和搜索 Kaggle 数据集。

Arka 包含一个 **kaggle** 技能，用于下载和搜索 Kaggle 数据集。它通过 `kaggle` CLI（优先）或 Python `kaggle` 包使用官方 Kaggle API。

## 快速示例

```bash theme={null}
kaggle status
kaggle search titanic
kaggle download heptapod/titanic
kaggle download heptapod/titanic --unzip -o ~/Downloads
```

也支持自然语言：

```bash theme={null}
arka "download kaggle dataset heptapod/titanic"
arka "kaggle search housing prices"
arka "kaggle status"
```

或通过 CLI 子命令：

```bash theme={null}
arka kaggle download heptapod/titanic --unzip
```

## 命令

| 命令                                        | 描述                      |
| ----------------------------------------- | ----------------------- |
| `kaggle status`                           | 检查是否已配置 Kaggle 凭据       |
| `kaggle search <keywords>`                | 按关键字搜索数据集               |
| `kaggle download <owner/dataset>`         | 下载数据集到 Downloads 文件夹    |
| `kaggle download <owner/dataset> -o DIR`  | 下载到自定义目录                |
| `kaggle download <owner/dataset> --unzip` | 下载并解压归档文件               |
| `kaggle open <owner/dataset>`             | 在浏览器中打开数据集页面（无需 API 密钥） |
| `kaggle download <owner/dataset> --open`  | 缺少凭据时在浏览器中打开            |

## 凭据

Kaggle 需要 API 令牌。在 [kaggle.com/settings](https://www.kaggle.com/settings) 创建（Account → API → Create New Token）。

**选项 A —— 环境变量**（推荐用于 Arka）：

```bash theme={null}
KAGGLE_USERNAME=your_username
KAGGLE_KEY=your_api_key
```

将其添加到 `~/.config/arka/.env`。

**选项 B —— `kaggle.json`**（标准 Kaggle 布局）：

```bash theme={null}
mkdir -p ~/.kaggle
# 将下载的令牌解压到 ~/.kaggle/kaggle.json
chmod 600 ~/.kaggle/kaggle.json
```

下载前运行 `kaggle status` 以验证凭据。

## 无 API 密钥

官方 Kaggle API 需要凭据。如果您尚未拥有 API 令牌，仍可以在浏览器中打开数据集页面，并从 Kaggle 网站手动下载文件。

```bash theme={null}
kaggle open heptapod/titanic
kaggle open https://www.kaggle.com/datasets/heptapod/titanic
```

自然语言：

```bash theme={null}
arka "open kaggle dataset heptapod/titanic"
arka "kaggle open heptapod/titanic"
```

您也可以在下载时传入 `--open`（或 `--browser`），以便在缺少凭据时打开页面而不是失败：

```bash theme={null}
kaggle download heptapod/titanic --open
```

如果没有凭据就运行 `kaggle download` 或 `kaggle search`，Arka 会打印一条简短消息，建议使用 `kaggle open owner/dataset` 进行手动下载。

## API 方式

如果 `kaggle` CLI 位于 `PATH` 上，此技能会优先使用它：

```bash theme={null}
kaggle datasets download -d owner/dataset -p /output/dir
kaggle datasets list -s "query"
```

如果未安装 CLI，则回退到 Python `kaggle` 包：

```bash theme={null}
pip install kaggle
```

## 相关技能

| 技能              | 示例                           |
| --------------- | ---------------------------- |
| `generate_data` | `generate 100 users as csv`  |
| `data_ask`      | `ask data in reports folder` |
| `competitions`  | `search kaggle competitions` |

另请参阅：[生成数据](/cn/guides/generate-data)


## Related topics

- [生成数据](/cn/guides/generate-data.md)
- [数据问答](/cn/guides/data-ask.md)
- [黑客松与 ML 竞赛搜索](/cn/guides/competitions.md)
- [内置技能目录](/cn/guides/skills.md)
- [Kalshi 预测市场](/cn/guides/kalshi.md)