diff --git a/packages/create-webclaw/README.md b/packages/create-webclaw/README.md index 6d9620c..52d4760 100644 --- a/packages/create-webclaw/README.md +++ b/packages/create-webclaw/README.md @@ -1,21 +1,96 @@ -# create-webclaw +

+ + + + webclaw + + +

-Set up [webclaw](https://webclaw.io) MCP server for AI agents in one command. +

+ One command to give your AI agent reliable web access.
+ No headless browser. No Puppeteer. No 403s. +

-## Usage +

+ npm installs + Stars + License +

+ +--- + +## Quick Start ```bash npx create-webclaw ``` -## What it does +That's it. Auto-detects your AI tools, downloads the MCP server, configures everything. -1. Detects installed AI tools (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code + Continue) -2. Downloads the `webclaw-mcp` binary for your platform -3. Asks for your API key (optional — works locally without one) -4. Configures MCP in each detected tool +Works with **Claude Desktop**, **Claude Code**, **Cursor**, **Windsurf**, **VS Code**, **OpenCode**, **Codex CLI**, and **Antigravity**. -## Supported tools +--- + +## The Problem + +Your AI agent calls `fetch()` and gets a 403. Cloudflare, Akamai, and every major CDN fingerprint the TLS handshake and block non-browser clients before the request hits the server. + +When it does work, you get 100KB+ of raw HTML — navigation, ads, cookie banners, scripts. Your agent burns 4,000+ tokens parsing noise. + +## The Fix + +webclaw impersonates Chrome 146 at the TLS protocol level. Perfect JA4 fingerprint. Perfect HTTP/2 Akamai hash. 99% bypass rate on 102 tested sites. + +Then it extracts just the content — clean markdown, 67% fewer tokens. + +``` + Raw HTML webclaw +┌──────────────────────────────────┐ ┌──────────────────────────────────┐ +│
│ │ # Breaking: AI Breakthrough │ +│