DP

djannot/puppeteer-vision-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

48 stars 9 forks 品質 60 トレンド 13

このモデルコンテキストプロトコル(MCP)サーバーは、Webページをスクレイピングし、Puppeteer、Readability、およびターンダウンを使用してマークダウン形式に変換するツールを提供します.

概要

このモデルコンテキストプロトコル(MCP)サーバーは、Webページをスクレイピングし、Puppeteer、Readability、およびターンダウンを使用してマークダウン形式に変換するツールを提供します。 それは、自動的にクッキー、カプチャスおよび他の相互要素を処理するAI主導の相互作用機能を備えています。 - Puppeteerを使用してWebページをステルスモードを使用してスクレイプ - 自動的に処理するためにAIを搭載した相互作用を使用する: - クッキーの同意バナー - CAPTCHAs - ニュースレターまたはサブスクリプションプロンプト - ペイウォールとログインウォール - 年齢確認プロンプト - インタースティアル広告 - コンテンツをブロックする他のインタラクティブ要素 - MozillaのReadabilityでメインコンテンツを抽出 - 変換 - 適切にフォーマットされたMarkdown - コードブロック、テーブル、およびその他の構成のための特別な取り扱い - テキストをリアルタイムで表示する - テキストオプション - テキストオプション - テキストを経由して表示する - テキストオプション - 使いやすいオプション -.

概要(AI 翻訳)

このモデルコンテキストプロトコル(MCP)サーバーは、Webページをスクレイピングし、Puppeteer、Readability、およびターンダウンを使用してマークダウン形式に変換するツールを提供します。 それは、自動的にクッキー、カプチャスおよび他の相互要素を処理するAI主導の相互作用機能を備えています。

[npxで簡単に実行可能!

##特徴

  • ステルスモードでPuppeteerを使用してWebページをスクレイプ
  • 自動的に処理するためにAIによって動力を与えられた相互作用を使用して下さい:
  • クッキーの同意バナー
  • カプセル
  • ニュースレターまたはサブスクリプションプロンプト
  • ペイウォールとログインウォール
  • 年齢確認プロンプト
  • 空間広告
  • コンテンツをブロックするその他のインタラクティブ要素
  • Mozillaの読みやすさで主要なコンテンツを抽出します
  • HTMLを適切にフォーマットされたMarkdownに変換する
  • コードブロック、テーブル、その他の構造コンテンツの特別な取り扱い
  • モデルコンテキストプロトコルを介してアクセス可能
  • ヘッドレスモードを無効にすることにより、ブラウザの相互作用をリアルタイムで表示するオプション
  • npxパッケージとして簡単に消耗品。

クイックスタート NPX

このサーバーを使用する推奨方法は[npxで、クローンや手動でインストールする必要はありません。

  1. 前提条件: ノードを持っていることを確認してください.

このページは 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 } }