# 浏览器

通过 MoreLogin 本地 API 以编程方式管理测浏览器环境。

## 概述

浏览器 API 允许您使用唯一的指纹创建、启动和控制浏览器。它专为多帐户管理、网络抓取和自动化测试等自动化场景而设计。

**基本网址**：`http://127.0.0.1:40000`

> 本地 API 与 MoreLogin 桌面应用程序一起在您的计算机上运行。所有请求必须来自同一台机器。


## 能力

| 资源 | 描述 | 关键操作 |
|  --- | --- | --- |
| **浏览器** | 指纹浏览器实例 | 创建、启动、停止、删除、修改、检查状态 |
| **代理** | 浏览器的代理配置 | 添加、更新、删除、列出代理 |
| **分组** | 将浏览器环境分组 | 创建、编辑、删除分组 |
| **标签** | 用标签标记浏览器环境 | 创建、编辑、删除标签 |


## 快速示例

创建并启动 Chrome 浏览器：

```bash
# 1. Create a profile
curl -X POST "http://127.0.0.1:40000/api/env/create/quick" \
  -H "Content-Type: application/json" \
  -d '{"browserTypeId": 1, "operatorSystemId": 1, "quantity": 1}'

# 2. Start the profile (use envId from step 1)
curl -X POST "http://127.0.0.1:40000/api/env/start" \
  -H "Content-Type: application/json" \
  -d '{"envId": "YOUR_ENV_ID"}'
```

开始后，您将收到：

- **调试端口** — 用于 Selenium/Puppeteer 连接
- **WebDriver 路径** — 用于浏览器自动化


## 自动化集成

### Selenium

```python
from selenium import webdriver

options = webdriver.ChromeOptions()
options.debugger_address = "127.0.0.1:DEBUG_PORT"
driver = webdriver.Chrome(
    executable_path="WEBDRIVER_PATH",
    options=options
)
driver.get("https://example.com")
```

### Puppeteer

```javascript
const puppeteer = require('puppeteer');

const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://127.0.0.1:DEBUG_PORT'
});
const page = await browser.newPage();
await page.goto('https://example.com');
```

## 要求

- MoreLogin 桌面应用程序 **v2.15.0+** 已安装并运行
- 已登录您的 MoreLogin 帐户
- 请求必须来自本地机器


> **注意**：本地 API 还支持云手机管理端点。对于云手机操作，我们建议使用[开放 API](/zh/api-reference/cloud-phone) 来实现远程访问功能。


有关身份验证的详细信息，请参阅[身份验证](/zh/api-reference/getting-started/authentication)。