# unbrowser by Unchained

Stateful веб-рантайм без Chrome для агентов: держит cookies, возвращает ссылки на элементы DOM и сигналы страницы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Автор: protostatis
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/protostatis/unbrowser
- Обновлён: 2026-08-21
- HTML: https://affpapa.org/nevibecode/mcp/unbrowser-by-unchained

## Что делает

Сервер находится между `curl` и полноценным браузером. Он сохраняет состояние сессии, обрабатывает формы и редиректы, возвращает структурированную карту страницы с заголовками, landmarks и интерактивными элементами. Агент получает стабильные ссылки на узлы вроде `e:142` — кликнуть или заполнить поле можно без повторного разбора HTML.

По умолчанию `navigate` работает как быстрый статический проход. Флаг `exec_scripts: true` запускает лёгкие скрипты в QuickJS под watchdog. Это не V8 и не рендеринг: тяжёлые SPA, Canvas, WebGL и расширения требуют настоящего Chrome. Сервер детектирует challenge и тонкие оболочки, возвращает сигналы `thin_shell` и `challenge.provider` — агент понимает, когда эскалировать задачу.

Для установки через `pip` нужен Python 3.10+. На macOS встроенный `/usr/bin/python3` — это версия 3.9, которая не подходит: ставьте через `pipx` или Homebrew.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

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

**Командой платформы**
```bash
claude mcp add unbrowser -- uvx pyunbrowser
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pyunbrowser <команда>

### Codex

**Командой платформы**
```bash
codex mcp add unbrowser-by-unchained -- uvx pyunbrowser
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pyunbrowser <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unbrowser-by-unchained": {
            "command": "uvx",
            "args": [
                "pyunbrowser"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pyunbrowser <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "unbrowser-by-unchained": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "pyunbrowser"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pyunbrowser <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add unbrowser-by-unchained uvx pyunbrowser
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pyunbrowser <команда>

## Когда брать
- обойти страницу со статическим HTML, сохранив cookies между запросами
- извлечь данные по селектору и получить стабильную ссылку на элемент
- отправить форму и проследить редирект
- узнать, нужен ли для страницы полноценный браузер
- запустить лёгкую гидратацию в QuickJS без Chrome

## Примеры запросов агенту
- Открой `https://news.ycombinator.com` и покажи первые пять ссылок из `.titleline > a`
- Заполни поле `#email` на `example.com/contact` и отправь форму
- Проверь, нужен ли для `site.com` полный браузер или хватит статического прохода

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [apify-mcp-server](https://affpapa.org/nevibecode/mcp/apify-mcp-server.md) — MCP-сервер · ★ 12927

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