DP

djannot/puppeteer-vision-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

48 stars 9 forks Качество 60 Тренд 13

Сервер 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 npx package.

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.

  1. Prerequisites: Ensure you have Node.js and npm installed.

  2. Environment Setup: The server requires an OPENAI_API_KEY. You can provide this and other optional configurations in two ways:

    • .env file: Create a .env file in the directory where you will run the npx command.
    • Shell Environment Variables: Export the variables in your terminal session.

    Example .env file 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
    
  3. Run the Server: Open your terminal and run:

    npx -y puppeteer-vision-mcp-server
    
    • The -y flag automatically confirms any prompts from npx.
    • This command will download (if not already cached) and execute the server.
    • By default, it starts in stdio mode. Set TRANSPORT_TYPE=sse or TRANSPORT_TYPE=http for HTTP server modes.

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"],
Открыть полный README на GitHub

Установка

npx -y puppeteer-vision-mcp-server
Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "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 } }