OpenBrowser

Enhanced MCP Playwright Browser Server — умная навигация, персистентный кеш локаторов, авто-ожидание, force-click, accessibility tree и дельта-обновления DOM.

Ключевые улучшения относительно стандартного MCP Playwright

1. Персистентный кеш локаторов (LocatorCache)

Ref ID из browser_get_compact_map (например, [e5]) и browser_get_accessibility_tree ([a3]) сохраняются в кеше с привязкой к стабильным атрибутам (data-tsid > aria-label > role+name). При повторном вызове клика с ref локатор пересобирается из кеша — не протухает после DOM-мутаций.

2. Авто-фолбек при клике (3 уровня)

browser_click пробует:

1. Playwright click() — стандартный клик

2. el.click() через JS — если элемент невидим/перекрыт оверлеем

3. role=role[name="..."] через Playwright a11y API + JS-поиск по aria-label

Флаг force: true включает чистый JS-клик без попытки Playwright.

3. Accessibility Tree с scope и кликом

browser_get_accessibility_tree с параметром scope фильтрует дерево по CSS-селектору. browser_click_a11y кликает по accessibility-tree ref (например, a3) — работает даже для элементов, невидимых в DOM (React-порталы, shadow DOM, off-screen контролы). Использует Playwright page.accessibility.snapshot().

4. browser_wait_for_navigation_or_popup — авто-переключение на popup

Ждёт любой из трёх исходов после действия:

• Смена URL (навигация)

• Открытие popup-окна (OAuth) — авто-переключает активную вкладку на popup

• Завершение сетевой активности

Убирает ручные browser_sleep(3000-5000).

5. browser_get_compact_map с scope + a11y-only элементы

• Параметр scope: "#chat-panel" фильтрует карту по CSS-селектору

• Параметр include_a11y_only: true включает элементы, видимые только в accessibility tree (скрытые CSS-элементы с aria-label)

6. browser_fill для contenteditable

Авто-определение типа поля. Для contenteditable div использует execCommand('insertText') + dispatchEvent('input') — работает с кастомными веб-компонентами (Stencil, React, Vue, VKUI).

7. Дельта с отслеживанием навигации

browser_get_delta сообщает не только о DOM-мутациях, но и о смене URL.

8. browser_list_tabs / browser_switch_tab

Управление вкладками, включая popup-окна OAuth. Возможность переключения между вкладками.

9. browser_navigate с авто-детектом popup

Автоматически перехватывает popup-события при навигации. Если страница открывает popup — возвращает его ID и URL в ответе.

10. browser_smart_wait с mutation-settle

Не просто sleep(N) — ждёт network idle + стабилизацию DOM-мутаций (MutationObserver). Точнее определяет момент готовности SPA.

Related MCP server: Pilot

Установка

npm install
npm run build

Конфигурация MCP

{
  "mcpServers": {
    "openbrowser": {
      "command": "node",
      "args": ["dist/index.js"]
    }
  }
}

Инструменты

Маппинг проблем → решений