Yandex Browser Tabs MCP Server v2.0
MCP (Model Context Protocol) сервер для управления вкладками Яндекс Браузера с расширенной функциональностью.
🚀 Новые возможности в версии 2.0
📊 Прямой доступ к консоли браузера
- Перехват всех логов консоли (log, warn, error, info)
- Сохранение истории консоли
- Фильтрация логов по типу
🎯 Быстрый скроллинг
- Скролл к элементу с плавной анимацией
- Скролл в любом направлении на заданное расстояние
- Поддержка smooth и instant режимов
📄 Получение информации без скриншотов
- Извлечение текста со страницы или элемента
- Получение HTML контента (inner/outer)
- Чтение атрибутов элементов
- Получение метаинформации страницы
🎮 Расширенное взаимодействие
- Hover эффекты
- Нажатие клавиш и комбинаций
- Заполнение форм
- Ожидание появления элементов
📋 Установка
# Клонируйте репозиторий
git clone <repository-url>
cd yandex-browser-mcp
# Установите зависимости
npm install
# Соберите проект
npm run build
🔧 Использование
1. Запустите Яндекс Браузер в режиме отладки
Используйте один из предоставленных батников:
start-yandex-debug.bat
Или вручную:
"C:\Users\%USERNAME%\AppData\Local\Yandex\YandexBrowser\Application\browser.exe" --remote-debugging-port=9222
2. Подключите MCP сервер к Claude Desktop
Добавьте в конфигурацию Claude Desktop:
{
"mcpServers": {
"yandex-browser": {
"command": "node",
"args": ["C:\\Users\\Professional\\Desktop\\yandex-browser-mcp\\build\\index.js"]
}
}
}
📚 Полный список функций
Базовые функции
connect_to_browser
Подключиться к уже открытому Яндекс Браузеру
connect_to_browser({ port?: number })
list_tabs
Получить список всех открытых вкладок
list_tabs({})
navigate
Перейти по URL в указанной вкладке
navigate({
url: string,
tabIndex?: number,
waitForSelector?: string
})
Взаимодействие с элементами
click
Кликнуть по элементу
click({ selector: string, tabIndex?: number })
type
Ввести текст в поле
type({
selector: string,
text: string,
tabIndex?: number,
delay?: number
})
hover
Навести курсор на элемент
hover({ selector: string, tabIndex?: number })
key_press
Нажать клавишу или комбинацию
key_press({
key: string,
modifiers?: ['Control' | 'Shift' | 'Alt' | 'Meta'][],
tabIndex?: number
})
Скроллинг
scroll
Прокрутить страницу или к элементу
scroll({
tabIndex?: number,
direction?: 'up' | 'down' | 'left' | 'right',
distance?: number,
selector?: string,
smooth?: boolean
})
Получение информации
get_text
Получить текстовое содержимое
get_text({ selector?: string, tabIndex?: number })
get_html
Получить HTML содержимое
get_html({
selector?: string,
outerHTML?: boolean,
tabIndex?: number
})
get_attributes
Получить атрибуты элемента
get_attributes({
selector: string,
attributes?: string[],
tabIndex?: number
})
get_page_info
Получить информацию о странице
get_page_info({ tabIndex?: number })
// Возвращает: URL, title, description, viewport, metaTags
get_console_logs
Получить логи консоли браузера
get_console_logs({
tabIndex?: number,
type?: 'all' | 'log' | 'warn' | 'error' | 'info',
limit?: number
})
Работа с формами
fill_form
Заполнить форму данными
fill_form({
formSelector?: string,
fields: { [selector: string]: any },
tabIndex?: number
})
Утилиты
wait_for_element
Ждать появления элемента
wait_for_element({
selector: string,
tabIndex?: number,
timeout?: number,
visible?: boolean
})
screenshot
Сделать скриншот
screenshot({
name: string,
tabIndex?: number,
fullPage?: boolean,
selector?: string
})
evaluate
Выполнить JavaScript код
evaluate({ script: string, tabIndex?: number })
execute_test
Выполнить тест (выбрать ответы и отправить)
execute_test({
tabIndex: number,
testSelectors: string[],
submitButtonSelector: string
})
💡 Примеры использования
Пример: Мониторинг консоли и извлечение данных
// Подключаемся к браузеру
connect_to_browser({})
// Переходим на страницу
navigate({ url: "https://example.com" })
// Получаем логи консоли
get_console_logs({ type: 'error' })
// Извлекаем текст
get_text({ selector: '.main-content' })