spa-reader-mcp
This server renders JavaScript Single Page Applications (SPAs) using a headless Chromium browser, enabling content extraction and screenshot capture.
Extract SPA content as Markdown: Render JavaScript-heavy pages and extract clean, LLM-ready Markdown with optional YAML frontmatter (title, author, excerpt).
Capture screenshots: Take PNG screenshots of rendered pages with configurable viewport dimensions (320–3840px width, 240–2160px height) and full-page capture support.
Wait for dynamic content: Specify CSS selectors to wait for before extraction or screenshot, ensuring content is fully rendered.
Authentication & custom requests: Inject cookies and custom HTTP headers to access protected or API-gated content.
Configure timeouts: Set navigation timeouts (1–120 seconds) to control rendering wait time.
Security: Built-in SSRF protection (blocks private/loopback IPs), HTTP/HTTPS-only scheme restriction, selector injection prevention, and 100KB content size cap.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@spa-reader-mcp extract the article content from https://react.dev/blog"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
spa-reader-mcp
MCP server that renders JavaScript SPA pages and extracts Markdown via headless Chromium.
Traditional scrapers fail on SPAs because content is rendered client-side. This tool launches Playwright, waits for JS to finish, then extracts clean Markdown using Readability + Turndown.
Install
npx playwright install chromiumClaude Desktop
{
"mcpServers": {
"spa-reader": {
"command": "npx",
"args": ["-y", "spa-reader-mcp"]
}
}
}Claude Code
claude mcp add spa-reader -- npx -y spa-reader-mcpRelated MCP server: crawl-mcp-server
Tools
spa_read
Render a page and extract content as Markdown.
Parameter | Type | Default | Description |
| string | — | URL to read (required) |
| string | — | CSS selector to wait for |
| number | 30000 | Timeout in ms |
| boolean | true | Add YAML frontmatter |
| array | — | Cookies for auth |
| object | — | Custom HTTP headers |
spa_screenshot
Capture a PNG screenshot after JS rendering.
Parameter | Type | Default | Description |
| string | — | URL to capture (required) |
| string | — | CSS selector to wait for |
| number | 30000 | Timeout in ms |
| number | 1280 | Viewport width |
| number | 720 | Viewport height |
| boolean | false | Full page capture |
| array | — | Cookies for auth |
| object | — | Custom HTTP headers |
Security
SSRF protection: blocks private/loopback IPs
Only
http:andhttps:schemes allowedSelector injection prevention
Content capped at 100KB
Dev
pnpm install && pnpm build
pnpm testLicense
MIT
Available Tools
2 toolsspa_readB
Render a JavaScript SPA page and extract its content as LLM-ready Markdown. Uses a headless browser to execute JavaScript, then extracts the main article content.
Inputs: url (required), waitForSelector, waitTimeout, includeMetadata, +2 more.
spa_screenshotB
Take a screenshot of a JavaScript SPA page after rendering. Uses a headless browser to execute JavaScript and capture the visual output as PNG.
Inputs: url (required), waitForSelector, waitTimeout, width, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: spa_read extracts textual content as Markdown for LLM processing, while spa_screenshot captures visual output as PNG for screenshots. There is no overlap in functionality or ambiguity about which tool to use for a given task.
Both tools follow a consistent 'spa_' prefix pattern with descriptive suffixes (read, screenshot), indicating they belong to the same domain and operate on SPA pages. The naming is uniform, predictable, and clearly communicates each tool's function.
With only 2 tools, the server feels thin for a general-purpose SPA reader domain, as it lacks operations like navigation, interaction simulation, or performance monitoring. However, it covers the core tasks of content extraction and screenshot capture adequately for basic use.
The tools provide essential read-only capabilities for SPAs (extracting content and screenshots), but there are notable gaps: no ability to interact with pages (e.g., click buttons, fill forms), navigate beyond initial URLs, or handle dynamic content beyond rendering. This limits advanced agent workflows.
Related MCP Connectors
Web scraping MCP server: any URL to Markdown or JSON, with JavaScript rendering and batch jobs.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Web scraping MCP server — scrape, extract structured data, screenshot any site with anti-bot bypass.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- AlicenseBqualityCmaintenanceAn MCP server that retrieves web page content using Playwright headless browser, capable of extracting main content and converting to Markdown format.35,605 npm1,088MIT
- FlicenseNot gradedqualityNot gradedmaintenanceAn MCP server for web content extraction that converts HTML pages into clean, LLM-optimized Markdown using Mozilla's Readability. It supports batch processing, intelligent multi-page crawling, and configurable caching while respecting robots.txt standards.48 npm-
- AlicenseAqualityDmaintenanceAn MCP server that fetches web pages and extracts clean, AI-friendly Markdown content using Mozilla Readability. It provides secure web access for LLMs with built-in SSRF protection and automated content cleaning for improved context retrieval and summarization.198 npmMIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that scrapes content from web pages, including JavaScript-heavy sites, and converts it into high-quality Markdown. It leverages Playwright for headless browser automation and Pypandoc for clean content conversion.Apache 2.0