
djannot/puppeteer-vision-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер Model Context Protocol (MCP) предоставляет инструмент для скрапа веб-страниц и преобразования их в формат разметки с использованием Puppeteer, Readability и Turndown.
Обзор
Сервер Model Context Protocol (MCP) предоставляет инструмент для скрапа веб-страниц и преобразования их в формат разметки с использованием Puppeteer, Readability и Turndown. Он имеет возможности взаимодействия на основе ИИ для автоматической обработки файлов cookie, капчей и других интерактивных элементов. - Уничтожает веб-страницы с использованием Puppeteer со скрытым режимом - Использует взаимодействие на основе AI для автоматической обработки: - баннеры согласия на использование файлов cookie - CAPTCHA - Newsletter или подписка подсказки - Paywalls и стенки входа - Подсказки проверки возраста - Интерстициальные объявления - Любые другие интерактивные элементы, блокирующие контент - Извлекает основной контент с возможностью чтения Mozilla - Преобразует HTML в хорошо отформатированный Markdown - Специальная обработка для блоков кода, таблиц и другого структурированного контента - Доступный через протокол Model Context - Возможность просмотра взаимодействия браузера в режиме реального времени путем отключения безголового режима - Легко расходуемый как пакет npx.
Обзор (машинный перевод)
Сервер Model Context Protocol (MCP) предоставляет инструмент для скрапа веб-страниц и преобразования их в формат разметки с использованием Puppeteer, Readability и Turndown. Он имеет возможности взаимодействия на основе ИИ для автоматической обработки файлов cookie, капчей и других интерактивных элементов.
** Теперь легко запустить через npx!**
Особенности
- Скрапирует веб-страницы с помощью Puppeteer в режиме скрытности Использует взаимодействие на основе ИИ для автоматической обработки:
- баннеры согласия cookie
- Капча
- Бюллетень или подписка подсказки
- Paywalls и стены входа Проверка возраста подсказывает
- Промежуточная реклама Любые другие интерактивные элементы, блокирующие контент
- Извлечение основного контента с возможностью чтения Mozilla
Преобразует HTML в хорошо отформатированный Markdown
Специальная обработка для блоков кода, таблиц и другого структурированного контента
Доступно по протоколу Model Context
Возможность просмотра взаимодействия браузера в режиме реального времени путем отключения режима без головы
Легко расходуется как
npxупаковка.
Быстрый старт с NPX
Рекомендуемый способ использования этого сервера - через T2, который гарантирует, что вы используете последнюю версию без необходимости клонирования или ручной установки.
1.** Предпосылки:** Убедитесь, что у вас есть узел.
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Puppeteer vision MCP Server
This Model Context Protocol (MCP) server provides a tool for scraping webpages and converting them to markdown format using Puppeteer, Readability, and Turndown. It features AI-driven interaction capabilities to handle cookies, captchas, and other interactive elements automatically.
Now easily runnable via npx!
Features
- Scrapes webpages using Puppeteer with stealth mode
- Uses AI-powered interaction to automatically handle:
- Cookie consent banners
- CAPTCHAs
- Newsletter or subscription prompts
- Paywalls and login walls
- Age verification prompts
- Interstitial ads
- Any other interactive elements blocking content
- Extracts main content with Mozilla’s Readability
- Converts HTML to well-formatted Markdown
- Special handling for code blocks, tables, and other structured content
- Accessible via the Model Context Protocol
- Option to view browser interaction in real-time by disabling headless mode
- Easily consumable as an
npxpackage.
Quick Start with NPX
The recommended way to use this server is via npx, which ensures you’re running the latest version without needing to clone or manually install.
-
Prerequisites: Ensure you have Node.js and npm installed.
-
Environment Setup: The server requires an
OPENAI_API_KEY. You can provide this and other optional configurations in two ways:.envfile: Create a.envfile in the directory where you will run thenpxcommand.- Shell Environment Variables: Export the variables in your terminal session.
Example
.envfile or shell exports:# Required OPENAI_API_KEY=your_api_key_here # Optional (defaults shown) # VISION_MODEL=gpt-4.1 # API_BASE_URL=https://api.openai.com/v1 # Uncomment to override # TRANSPORT_TYPE=stdio # Options: stdio, sse, http # USE_SSE=true # Deprecated: use TRANSPORT_TYPE=sse instead # PORT=3001 # Only used in sse/http modes # DISABLE_HEADLESS=true # Uncomment to see the browser in action -
Run the Server: Open your terminal and run:
npx -y puppeteer-vision-mcp-server- The
-yflag automatically confirms any prompts fromnpx. - This command will download (if not already cached) and execute the server.
- By default, it starts in
stdiomode. SetTRANSPORT_TYPE=sseorTRANSPORT_TYPE=httpfor HTTP server modes.
- The
Using as an MCP Tool with NPX
This server is designed to be integrated as a tool within an MCP-compatible LLM orchestrator. Here’s an example configuration snippet:
{
"mcpServers": {
"web-scraper": {
"command": "npx",
"args": ["-y", "puppeteer-vision-mcp-server"],
Установка
npx -y puppeteer-vision-mcp-serverКонфигурация
{
"mcpServers": {
"web-scraper": {
"command": "npx",
"args": ["-y", "puppeteer-vision-mcp-server"],
"env": {
"OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
// Optional:
// "VISION_MODEL": "gpt-4.1",
// "API_BASE_URL": "https://api.example.com/v1",
// "TRANSPORT_TYPE": "stdio", // or "sse" or "http"
// "DISABLE_HEADLESS": "true" // To see the browser during operations
}
}
// ... other MCP servers
}
}