Puppeteer Vision Mcp Server

@djannot

About Puppeteer Vision Mcp Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "web-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "puppeteer-vision-mcp-serve"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE"
      }
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is 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 automatically handle cookies, captchas, and other interactive elements. It is intended for developers and LLM orchestrators that need structured web content.

How to use Puppeteer vision MCP Server?

Run the server directly via npx -y puppeteer-vision-mcp-server after setting required environment variables (e.g., OPENAI_API_KEY). It can also be configured as an MCP tool in an orchestrator using the JSON snippet provided in the README. Transport can be stdio (default), SSE, or HTTP, selected via the TRANSPORT_TYPE variable.

Key features of Puppeteer vision MCP Server

Scrapes webpages using Puppeteer with stealth mode
AI‑powered handling of cookies, CAPTCHAs, and overlays
Extracts main content with Mozilla's Readability
Converts HTML to well‑formatted Markdown with Turndown
Supports code blocks and tables with custom rules
Option to view browser interaction by disabling headless mode

Use cases of Puppeteer vision MCP Server

Scrape news articles that require dismissing cookie consent banners
Extract documentation or blog posts from pages with paywalls or login prompts
Capture structured content (code blocks, tables) from dynamic web pages
Feed cleaned Markdown into an LLM for further processing or summarization

FAQ from Puppeteer vision MCP Server

What AI model does it use?

It requires an OpenAI API key; the default vision model is gpt-4.1. You can change the model via the VISION_MODEL environment variable, and point to alternative providers by setting API_BASE_URL.

How do I see the browser during scraping?

Set the environment variable DISABLE_HEADLESS=true to run the browser in visible (non‑headless) mode.

What transport modes are supported?

Three modes are supported: stdio (default), sse, and http. Set the TRANSPORT_TYPE environment variable to switch between them.

Can I use a different AI provider?

Yes, set the API_BASE_URL environment variable to any OpenAI‑compatible

Frequently asked questions

What AI model does it use?

It requires an OpenAI API key; the default vision model is `gpt-4.1`. You can change the model via the `VISION_MODEL` environment variable, and point to alternative providers by setting `API_BASE_URL`.

How do I see the browser during scraping?

Set the environment variable `DISABLE_HEADLESS=true` to run the browser in visible (non‑headless) mode.

What transport modes are supported?

Three modes are supported: `stdio` (default), `sse`, and `http`. Set the `TRANSPORT_TYPE` environment variable to switch between them.

Can I use a different AI provider?

Yes, set the `API_BASE_URL` environment variable to any OpenAI‑compatible

Comments

Basic information

More Browser Automation MCP servers

Apify Model Context Protocol (MCP) Server

apify

The Apify MCP server enables your AI agents to extract data from social media, search engines, maps, e-commerce sites, or any other website using thousands of ready-made scrapers, crawlers, and automation tools available on the Apify Store.

1.7K

Playwright MCP Server 🎭

executeautomation

Playwright Model Context Protocol Server - Tool to automate Browsers and APIs in Claude Desktop, Cline, Cursor IDE and More 🔌

5.6K

browser-mcp

djyde

A browser extension and MCP server that allows you to interact with the browser you are using.

Puppeteer MCP Server

merajmehrabi

This MCP server provides browser automation capabilities through Puppeteer, allowing interaction with both new browser instances and existing Chrome windows.

474

Slack Slack

microsoft

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

92.5K