DP

djannot/puppeteer-vision-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

48 stars 9 forks 품질 60 트렌드 13

이 모델 Context Protocol (MCP) 서버는 웹 페이지를 긁고 Puppeteer, Readability 및 Turndown을 사용하여 Markdown 형식으로 변환하기위한 도구를 제공합니다.

개요

이 모델 Context Protocol (MCP) 서버는 웹 페이지를 긁고 Puppeteer, Readability 및 Turndown을 사용하여 Markdown 형식으로 변환하기위한 도구를 제공합니다. AI 기반 상호 작용 기능을 통해 쿠키, captchas 및 기타 상호 작용 요소를 자동으로 처리할 수 있습니다. 이 웹 사이트는 귀하가 웹 사이트를 탐색하는 동안 귀하의 경험을 향상시키기 위해 쿠키를 사용합니다. 이 쿠키들 중에서 필요에 따라 분류 된 쿠키는 웹 사이트의 기본적인 기능을 수행하는 데 필수적이므로 브라우저에 저장됩니다. 또한이 웹 사이트의 사용 방식을 분석하고 이해하는 데 도움이되는 제 3 자 쿠키를 사용합니다. 이 쿠키는 귀하의 동의하에 만 브라우저에 저장됩니다. 이러한 쿠키를 거부 할 수도 있습니다. 이러한 쿠키 중 일부를 선택 해제하면 검색 환경에 영향을 미칠 수 있습니다.

개요(AI 번역)

이 모델 Context Protocol (MCP) 서버는 웹 페이지를 긁고 Puppeteer, Readability 및 Turndown을 사용하여 Markdown 형식으로 변환하기위한 도구를 제공합니다. AI 기반 상호 작용 기능을 통해 쿠키, captchas 및 기타 상호 작용 요소를 자동으로 처리할 수 있습니다.

[T0]]을 통해 쉽게 실행할 수 있습니다!

특징

  • 훔친 모드로 Puppeteer를 사용하는 웹 페이지
  • 자동 핸들에 AI 전원 상호 작용을 사용합니다:
  • 쿠키 동의 배너
  • 자동차
  • 뉴스레터 또는 구독 안내
  • Paywalls 및 로그인 벽
  • 나이 검증
  • Interstitial 광고
  • 다른 모든 상호 작용하는 성분 차단 내용
  • Mozilla의 Readability를 가진 주요 내용 추출
  • HTML을 잘 포맷된 Markdown으로 변환
  • 부호 구획, 테이블 및 다른 Structured 내용을 위한 특별한 취급
  • 모형 Context 의정서를 통해 접근 가능
  • headless 모드를 비활성화하여 실시간 브라우저 상호 작용을 볼 수 있는 옵션
  • npx 패키지로 쉽게 소모품.

NPX로 빠른 시작

이 서버를 사용하는 권장 방법은 npx]을 통해, 클론 또는 수동 설치 필요없이 최신 버전을 실행하는 것을 보장합니다.

  1. ** 필수품: ** Node가 있습니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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"],
GitHub에서 전체 README 보기

설치

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