The Tap server is a browser automation platform that lets you run pre-built web automations (taps), forge new ones with AI, interact with web pages, and monitor changes — all through an MCP-compatible interface.

Run & Manage Taps

• tap_list — List available taps (start here)

• tap_run — Execute pre-built taps deterministically at zero AI runtime cost

• tap_watch — Monitor a tap for changes over time (price tracking, new listings, etc.)

• tap_doctor — Health-check taps, get root-cause diagnostics, and auto-heal broken ones

• tap_logs — View execution history

• tap_reload — Push updated taps to connected runtimes without restarting

Forge New Automations

• forge_inspect — Analyze a page to detect frameworks, APIs, and generate extraction strategies

• forge_verify — Test extraction logic live before saving

• forge_save — Compile and save a .tap.js program to disk; runs forever at $0 after saving

Browser Interaction

• tap_nav — Navigate to a URL

• tap_click — Click elements by text or CSS selector

• tap_type — Type into inputs (supports standard, contentEditable, CodeMirror, Draft.js, ProseMirror)

• tap_eval — Execute arbitrary JavaScript

• tap_find — Find elements by visible text; returns position, selector, bounding box

• tap_pressKey — Simulate key presses with optional modifiers

• tap_upload — Upload files to file inputs

• tap_screenshot — Capture the page as JPEG or PNG

• tap_cookies — Retrieve cookies for the current site

• tap_wait — Pause execution for a specified duration

Page Inspection

• inspect_page — Get URL, title, and meta tags

• inspect_dom — Get DOM structure (optionally scoped to a selector)

• inspect_a11y — Get the accessibility tree

• inspect_element — Inspect a specific element by selector

• inspect_networkStart / inspect_networkDump — Capture and dump network requests/responses including API bodies

• inspect_download — Download and parse content from a URL

Tab & Network Management

• tab_list — List all open browser tabs

• intercept_on / intercept_off — Enable or disable request interception with URL patterns

Allows searching and retrieving metadata for scientific papers from arXiv.

Enables retrieval of trending topics and hot searches from Baidu.

Allows interaction with Bilibili to access trending videos, search content, and retrieve video details and comments.

Provides access to trending content and posts on the Bluesky social network.

Enables fetching of top stories and popular technical posts from the dev.to community.

Allows access to trending content and hot topics on Douban.

Provides tools to track trending repositories and interact with GitHub content.

Enables access to trending search data via Google Trends.

Allows retrieval of popular and trending technical articles from Juejin.

Provides tools to browse hot stories and community discussions on Lobste.rs.

Enables searching for articles and fetching trending stories from Medium.

Allows access to ranking data and popular illustrations on Pixiv.

Provides tools to discover hot products and trending launches on Product Hunt.

Enables retrieval of information about top and popular Python packages on PyPI.

Allows searching content, fetching hot posts, and submitting comments on Reddit.

Provides access to hot and trending questions within the Stack Overflow community.

Enables tracking of top-selling games and trending content on the Steam store.

Allows for the programmatic publishing of articles via Telegra.ph.

Provides tools to browse hot topics and community discussions on the V2EX platform.

Enables searching for articles and accessing detailed content from the WeChat platform.

Allows retrieval of most-read articles and trending content from Wikipedia.

Provides comprehensive tools to browse hot notes, search content, view post details, and publish new notes.

Enables access to trending videos and content on YouTube.

Allows for searching, fetching hot topics, and viewing detailed question and comment data on Zhihu.

Capture: AI inspects the site → compiles a .plan.json program (one-time cost)
Run: The program executes instantly, same result every time ($0, zero AI)
Verify: tap verify checks the snapshot equivalence predicate (catches drift)
Repair: re-run capture against the same site/name; the next (only when needed)
 verify rebaselines after human review

npx -y @taprun/cli --version

curl -fsSL https://taprun.dev/install.sh | sh

brew install LeonTing1010/tap/taprun

{ "mcpServers": { "tap": { "command": "npx", "args": ["-y", "@taprun/cli", "mcp", "stdio"] } } }

tap mcp stdio # default; pipe to your MCP host
tap mcp http # streamable-HTTP on 127.0.0.1:7891 (bearer auth)

tap github/trending # GitHub trending repos
tap hackernews/hot # Hacker News front page
tap weibo/hot # 微博热搜
tap xiaohongshu/search --keyword "AI" # 小红书搜索

You: What's trending on GitHub today?
Agent: Here are today's top repos — React compiler hit 734 stars...

You: Capture a tap for Douban top 250 movies
Agent: Done. Run `tap douban/top250` anytime — $0 per run.

tap hackernews/top --args '{}' # JSON-on-stdout, exit 0 on success
tap verify hackernews/top # 4-arm verdict (equivalent / drifted / first_snapshot / unreachable)
tap capture <url> hackernews/top --intent "front-page top stories"

# Existing Playwright script (47M weekly npm downloads — most likely the one you have)
npm install @taprun/from-playwright @taprun/spec
node -e "import('@taprun/from-playwright').then(m => console.log(m.playwrightToTap(require('fs').readFileSync('tests/login.spec.ts','utf8'), {site:'example', name:'login'})))"

# Or scaffold a new starter from scratch
npx create-tap-script github/trending https://github.com/trending

tap reddit/hot # Reddit front page
tap bilibili/trending # Bilibili trending
tap arxiv/search --keyword "LLM" # arXiv papers

tap xiaohongshu/publish --title "My Note" --images photo.jpg
tap zhihu/publish --title "My Article" --content "..."

tap verify github/trending # spot drift; schedule via cron / launchd

tap github/trending | tap filter --field stars --gt 500 | tap table

tap capture https://news.ycombinator.com hackernews/hot --intent "top stories" # API detected — compiled without AI
tap capture https://example.com mysite/home --intent "..." # BYOK Claude / GPT for the long tail

tap config set ai.baseUrl http://localhost:11434/v1
tap config set ai.key ollama
tap config set ai.model llama3.1
tap capture https://arxiv.org/list/cs.AI/recent arxiv/recent --intent "recent papers" # 0 bytes leave your machine

 ┌─ Chrome extension (your real browser sessions)
You → AI → Taprun ──────┤
 capture └─ Playwright (headless, server, CI/CD)

tap verify <site>/<name> # Snapshot equivalence — catches silent failures before your data goes stale
tap list # See everything available
tap show <site>/<name> # Print the saved tap's plan as JSON