# browsa

MCP-сервер browsa для Claude Code запускает задачи в облачном Chromium или передаёт управление браузером через CDP. Агент может открывать страницы, нажимать кнопки и собирать данные.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3 у репозитория
- Автор: browsa-io
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/browsa-io/browsa/tree/HEAD/browsa-mcp
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/browsa

## Что делает

browsa запускает браузерные задачи в облачном Chromium и возвращает результат агенту. Через `run_task` можно поручить ему перейти на сайт, заполнить форму, прокрутить страницу или собрать данные в структурированном виде. Для долгих задач есть опрос статуса и отмена; агент также может попросить ответить на вопрос, например на CAPTCHA.

Для ручного управления сервер выдаёт CDP-адрес браузера, а инструменты `observe` и `act` позволяют читать страницу и выполнять действия. Нужен ключ `BROWSA_API_KEY`. Ключ модели можно сохранить в рабочей области или задать через `BROWSA_LLM_API_KEY`; размещённые модели Browsa работают без ключа модели и расходуют кредиты за задачу.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `BROWSA_API_KEY`, `BROWSA_LLM_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add browsa -e BROWSA_API_KEY=<BROWSA_API_KEY> -e BROWSA_LLM_API_KEY=<BROWSA_LLM_API_KEY> -- npx -y @browsa/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add browsa-mcp --env BROWSA_API_KEY=<BROWSA_API_KEY> --env BROWSA_LLM_API_KEY=<BROWSA_LLM_API_KEY> -- npx -y @browsa/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "browsa-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@browsa/mcp"
            ],
            "env": {
                "BROWSA_API_KEY": "<BROWSA_API_KEY>",
                "BROWSA_LLM_API_KEY": "<BROWSA_LLM_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "browsa-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@browsa/mcp"
            ],
            "env": {
                "BROWSA_API_KEY": "<BROWSA_API_KEY>",
                "BROWSA_LLM_API_KEY": "<BROWSA_LLM_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e BROWSA_API_KEY=<BROWSA_API_KEY> -e BROWSA_LLM_API_KEY=<BROWSA_LLM_API_KEY> browsa-mcp npx -y @browsa/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- собрать данные с веб-страницы в структурированном виде
- заполнить форму и нажать элементы сайта
- передать агенту браузер через CDP для ручного управления
- проверить статус долгой браузерной задачи

## Примеры запросов агенту
- Открой новостной сайт и верни заголовок главной новости.
- Заполни форму на странице и сообщи, что получилось.
- Запусти браузер и прочитай содержимое открытой страницы.

## Похожие
- [Browserless](https://affpapa.org/nevibecode/mcp/browserless.md) — MCP-сервер · ★ 19 у репозитория
- [HKEx Filings](https://affpapa.org/nevibecode/mcp/hkex-filings.md) — MCP-сервер · ★ 19 у репозитория
- [Playwright Cloud Browsers](https://affpapa.org/nevibecode/mcp/playwright-cloud-browsers.md) — MCP-сервер · ★ 18 у репозитория
- [nab](https://affpapa.org/nevibecode/mcp/nab.md) — MCP-сервер · ★ 18 у репозитория
- [fiverr-mcp-server](https://affpapa.org/nevibecode/mcp/fiverr-mcp-server.md) — MCP-сервер · ★ 18 у репозитория
- [Vibe Test — Browser Testing Agent](https://affpapa.org/nevibecode/mcp/vibe-test-browser-testing-agent.md) — MCP-сервер · ★ 18 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
