Skip to main content
Glama

spa-reader-mcp

CI npm version

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 chromium

Claude Desktop

{
  "mcpServers": {
    "spa-reader": {
      "command": "npx",
      "args": ["-y", "spa-reader-mcp"]
    }
  }
}

Claude Code

claude mcp add spa-reader -- npx -y spa-reader-mcp

Related MCP server: crawl-mcp-server

Tools

spa_read

Render a page and extract content as Markdown.

Parameter

Type

Default

Description

url

string

—

URL to read (required)

waitForSelector

string

—

CSS selector to wait for

waitTimeout

number

30000

Timeout in ms

includeMetadata

boolean

true

Add YAML frontmatter

cookies

array

—

Cookies for auth

headers

object

—

Custom HTTP headers

spa_screenshot

Capture a PNG screenshot after JS rendering.

Parameter

Type

Default

Description

url

string

—

URL to capture (required)

waitForSelector

string

—

CSS selector to wait for

waitTimeout

number

30000

Timeout in ms

width

number

1280

Viewport width

height

number

720

Viewport height

fullPage

boolean

false

Full page capture

cookies

array

—

Cookies for auth

headers

object

—

Custom HTTP headers

Security

  • SSRF protection: blocks private/loopback IPs

  • Only http: and https: schemes allowed

  • Selector injection prevention

  • Content capped at 100KB

Dev

pnpm install && pnpm build
pnpm test

License

MIT

Available Tools

2 tools
spa_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

    A3.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      An MCP server that retrieves web page content using Playwright headless browser, capable of extracting main content and converting to Markdown format.
      3
      5,605 npm
      1,088
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      An 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      1
      98 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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