Tap
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 costtap_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 onestap_logs— View execution historytap_reload— Push updated taps to connected runtimes without restarting
Forge New Automations
forge_inspect— Analyze a page to detect frameworks, APIs, and generate extraction strategiesforge_verify— Test extraction logic live before savingforge_save— Compile and save a.tap.jsprogram to disk; runs forever at $0 after saving
Browser Interaction
tap_nav— Navigate to a URLtap_click— Click elements by text or CSS selectortap_type— Type into inputs (supports standard, contentEditable, CodeMirror, Draft.js, ProseMirror)tap_eval— Execute arbitrary JavaScripttap_find— Find elements by visible text; returns position, selector, bounding boxtap_pressKey— Simulate key presses with optional modifierstap_upload— Upload files to file inputstap_screenshot— Capture the page as JPEG or PNGtap_cookies— Retrieve cookies for the current sitetap_wait— Pause execution for a specified duration
Page Inspection
inspect_page— Get URL, title, and meta tagsinspect_dom— Get DOM structure (optionally scoped to a selector)inspect_a11y— Get the accessibility treeinspect_element— Inspect a specific element by selectorinspect_networkStart/inspect_networkDump— Capture and dump network requests/responses including API bodiesinspect_download— Download and parse content from a URL
Tab & Network Management
tab_list— List all open browser tabsintercept_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.
Taprun is a browser automation and web scraping MCP server for AI agents. Point it at any site; your agent inspects the page once, compiles a deterministic program, and replays it forever — zero AI tokens at runtime, same result every call. Works with Claude Code, Cursor, Cline, Windsurf, and any MCP host. Runs in real Chrome (login sessions) or headless Playwright. Health contracts catch silent failures. Structural state diffs tell you exactly what changed. tap doctor detects breakage before your data goes stale — not three days later.
Forge: AI inspects the site → compiles a .tap.js program (one-time cost)
Run: The program executes instantly, same result every time ($0, zero AI)
Monitor: tap doctor checks health contracts + structural state diffs (catches breakage)
Heal: AI reads diagnostics and patches the program (only when needed)MCP is the authoring layer. tap.run is the execution layer. AI participates during forge (one-time). Execution is pure code — zero tokens, deterministic output. 140+ pre-built skills across 68+ sites — Reddit, GitHub, Hacker News, LinkedIn, Twitter, YouTube, Producthunt, and more — or forge your own from any URL. One binary, zero dependencies.
Use cases: AI agent browser automation · scheduled web scraping · structured data extraction · content monitoring · login-required site automation · multi-site data pipelines · reliability monitoring for long-running agents.
Get Started
1. Install
Zero-install via npx (any machine with Node):
npx -y @taprun/cli --versionThe first run downloads the matching platform binary (~30MB) and caches it. Subsequent calls are instant.
Permanent install via curl (macOS / Linux):
curl -fsSL https://taprun.dev/install.sh | shPlatform | Download |
macOS (Apple Silicon) | |
macOS (Intel) | |
Linux | |
Windows |
2. Connect to Your AI Agent
Works with Claude Code, Cursor, Windsurf, or any MCP-compatible agent — no extension needed:
{ "mcpServers": { "tap": { "command": "npx", "args": ["-y", "@taprun/cli", "mcp", "start"] } } }Or auto-configure all installed agents:
tap mcp connect3. Go
tap github/trending # GitHub trending repos
tap hackernews/hot # Hacker News front page
tap weibo/hot # 微博热搜
tap xiaohongshu/search --keyword "AI" # 小红书搜索Or just ask your AI agent:
You: What's trending on GitHub today?
Agent: Here are today's top repos — React compiler hit 734 stars...
You: Forge a tap for Douban top 250 movies
Agent: Done. Run `tap douban/top250` anytime — $0 per run.Optional: Chrome Extension (for login-required sites)
Most taps work without login. For sites that need your session (Xiaohongshu, Zhihu, etc.), install the Chrome Extension from the Chrome Web Store.
Related MCP server: Puppeteer MCP Server
What Can You Do?
Read — Extract data from any website
tap reddit/hot # Reddit front page
tap bilibili/trending # Bilibili trending
tap arxiv/search --keyword "LLM" # arXiv papersWrite — Operate any website
tap xiaohongshu/publish --title "My Note" --images photo.jpg
tap zhihu/publish --title "My Article" --content "..."Watch — Monitor changes
tap watch github/trending --every 5mCompose — Chain like Unix pipes
tap github/trending | tap filter --field stars --gt 500 | tap tableForge — Create new automations with AI
tap forge "get Hacker News top stories" # BYOK Claude / GPT
tap forge https://news.ycombinator.com # API detected — compiled without AIBring your own model — works with Claude, OpenAI, DeepSeek, or any OpenAI-compatible endpoint including local Ollama / LM Studio for fully offline forge:
tap config set ai.baseUrl http://localhost:11434/v1
tap config set ai.key ollama
tap config set ai.model llama3.1
tap forge "scrape arxiv recent papers" # 0 bytes leave your machineHow It Works
┌─ Chrome (your real browser sessions)
You → AI → Taprun ──────┤─ Playwright (headless, server, CI/CD)
compile └─ macOS (native desktop apps)You describe what you want (natural language or URL)
AI compiles it into a
.tap.jsprogram — plain JavaScript, version-controlledTaprun runs the program on any of three runtimes — forever, at $0
Every successful compilation makes the next one faster. 140+ community skills mean your agent already knows 68+ websites.
Community Skills
tap-skills — 140+ skills, open source.
Category | Examples |
Trending | GitHub, Hacker News, Reddit, Product Hunt, Bilibili, Zhihu, Weibo, Xiaohongshu |
Search | arXiv, Reddit, X, Zhihu, Weibo, Xiaohongshu, Bilibili, Medium |
Read | Zhihu threads, Bilibili videos, Xiaohongshu notes, WeRead books |
Write | X posts, Xiaohongshu notes, Zhihu articles, Dev.to, LinkedIn |
Monitor | Price tracking, stock data, competitor analysis |
tap doctor # Health check — catches silent failures before your data goes stale
tap update # Install / update all skills
tap list # See everything availableHow Taprun Compares
Taprun | AI Browser Agents | Traditional Scrapers | |
AI cost per run | $0 (compile once) | Tokens every run | Free |
Accuracy | Deterministic | Varies per run | Deterministic |
Silent failure detection | Health contracts + structural state diff | None | None |
Breakage diagnostics |
| None | Manual spot checks |
Detection risk | Low (real browser sessions) | High | High |
Runtimes | 3 (Chrome + Playwright + macOS) | 1 | 1 |
Code inspectable | .tap.js — git diff, debug, version | Black box / ephemeral | Fragile scripts |
MCP native | Yes (authoring layer only — execution is zero tokens) | No | No |
Security
Layer | Protection |
Sandbox | Programs run with zero permissions — no file, network, or system access |
Static Analysis | CI blocks dangerous patterns before they reach users |
Local-only | Your data, sessions, and API keys never leave your machine |
See SECURITY.md for details.
Contributing
The easiest way to contribute: forge a new tap. One .tap.js file is all it takes.
See CONTRIBUTING.md for details.
Roadmap
140+ community skills across 68+ sites
3 runtimes — Chrome, Playwright, macOS
Unix pipes —
tap A | tap BWatch mode — monitor changes over time
Doctor — health contracts, fingerprint diffs, automatic diagnostics for broken taps
One-command setup —
tap mcp connectconfigures all AI agentsAndroid runtime
iOS runtime
Concurrency control — deterministic coordination for M agents operating shared accounts in parallel
Support
GitHub Discussions — Q&A, ideas, show & tell
support@taprun.dev — licensing, private feedback, consulting
Issues — bug reports
License
Chrome Extension & docs: MIT. Community skills: MIT.
Star History
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/LeonTing1010/tap'
If you have feedback or need assistance with the MCP directory API, please join our Discord server