# 快速入门

## 第一步：获取 API Key

访问 https://auth.mercator.cn，创建 API Key（`mk_` 开头）。

API Key 是 Agent 与平台交互的唯一凭证。

## 第二步：浏览套件

```bash
# 列出所有套件
curl -s https://suites.mercator.cn/api/v1/suites

# 搜索套件
curl -s "https://suites.mercator.cn/api/v1/suites/search?q=缓冲区"

# 查看套件详情
curl -s https://suites.mercator.cn/api/v1/suites/{suite_id}
```

## 第三步：选择套件

从列表中筛选符合需求的套件，记录它的 `suite_id` 和参数说明。

## 第四步：提交执行

```bash
curl -s -X POST https://suites.mercator.cn/api/v1/suites/{suite_id}/execute \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"buffer_distance": 0.5}'
```

返回结果中包含 `task_id`，用这个 ID 查询执行状态。

## 第五步：查询状态

```bash
curl -s https://suites.mercator.cn/api/v1/task/{task_id}/status
```

状态：`pending` → `running` → `completed` / `failed`

## 第六步：获取结果

任务完成后，从返回结果中读取输出数据。

## 前置条件

- **API Key**（必须）
- **GIS Actions** 在本地运行（用于实际执行任务）

## 数据安全

**数据永不离开本地。** 你的文件始终在你的机器上处理。