zumerlab/snapsurf

Overview

Snapsurf is a JavaScript tool that gives AI agents a compact semantic digest of web pages, then produces a typed diff after each navigation action. It supports assertions over those diffs, and runs as an MCP server or CLI built on Playwright and SnapDOM.

Best for

Best for
AI agent builders who need lightweight web state verification in MCP or CLI pipelines

Use cases

• Give an AI agent a page digest before acting
• Verify page state changes with typed diffs after clicks or form fills
• Write assertions against navigation diffs in MCP or CLI workflows

How to use

Install

npx -y -p @zumer/snapsurf@latest snapsurf-mcp

Tools exposed

• browser_open
• browser_find
• browser_act
• browser_verify
• browser_assert

Tested with

Claude Code, Cursor, VS Code, Gemini CLI, Windsurf, OpenAI Agents SDK, Codex

Example client config

{\n  "command": "npx",\n  "args": ["-y", "-p", "@zumer/snapsurf@latest", "snapsurf-mcp"]\n}

Notes

Snapsurf is a JavaScript tool that gives AI agents a compact semantic digest of web pages, then produces a typed diff after each navigation action. It supports assertions over those diffs, and runs as an MCP server or CLI built on Playwright and SnapDOM.

0 stars on GitHub. Last updated 2026-09-08. Licensed MIT.

Use cases

• Give an AI agent a page digest before acting
• Verify page state changes with typed diffs after clicks or form fills
• Write assertions against navigation diffs in MCP or CLI workflows

Pros

• Reduces page context to a compact semantic digest, lowering token overhead
• Typed diffs make post-action changes explicit and assertable
• Works as both MCP server and CLI, integrating with agent tooling

Cons

• Zero stars and no listed adoption, so maturity is unproven
• Requires Playwright and SnapDOM setup, adding dependency weight
• Semantic digest may lose details needed for pixel-perfect verification

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.