@webcrawl/mcp
Scrapes arXiv abstract and PDF pages, returning paper metadata such as title, authors, abstract, category, submission date, PDF link, and full parsed paper Markdown.
Scrapes GitHub repositories, READMEs, issues, pull requests, and releases, returning structured repository metadata and discussion content.
Extracts YouTube video metadata and timestamped transcripts, with optional spoken-audio transcription for media files.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@webcrawl/mcpcrawl https://docs.stripe.com/webhooks and summarize the key points"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Webcrawl Anything
Crawl, search, and extract structured evidence from any website, SPA, PDF, Office file, YouTube video, GitHub repo, ArXiv paper, shopping offer, travel fare, or CVE advisory — from a single CLI and MCP server.
What You Can Crawl & Search
Target | Returns | Requirements |
Websites & JS SPAs ( | Clean Markdown, semantic headings, tables, code blocks, links, OpenGraph/JSON-LD, and SHA-256 content hashes | Zero-key local ( |
PDF & Office Docs ( | Page-numbered Markdown, tables, slide notes, and automatic OCR on scanned PDF pages ( | Built-in ( |
YouTube & Media ( | Timestamped transcript Markdown, video title/channel/duration metadata, and spoken audio transcription | Built-in zero-key YouTube multi-client caption extractor; optional audio transcription provider for raw MP3/MP4 |
Shopping & Products ( | Multi-retailer price comparison, currency-normalized offers, stock status, ratings, review counts, and shipping | Zero-key local HTML/JSON-LD product extractor ( |
Flights & Hotels ( | Structured flight routes ( | Zero-key local search + schema.org extractor ( |
Real Estate & Local Business ( | Property listings ( | Zero-key local extractor ( |
Security & CVEs ( | Authoritative CVE & GHSA records with CVSS v3.1/v4.0 scores, CWEs, affected/fixed package versions, and CISA KEV flags | Built-in live NVD 2.0 + OSV.dev + CISA KEV enrichment ( |
GitHub Repos, Issues & Releases ( | Structured repo metadata (stars, forks, license, topics, language), README Markdown, or issue/PR/release discussion threads | Built-in zero-key HTML & GitHub extractor ( |
ArXiv & Academic Papers ( | Paper title, authors, abstract, primary category, submission date, direct PDF link, and full parsed paper Markdown | Built-in ArXiv abstract & PDF inspector ( |
llms.txt & Sitemaps ( | Structured documentation manifest, section hierarchy, and crawlable doc URLs | Built-in ( |
Run npx webcrawl targets at any time to inspect all registered targets from your terminal.
Quickstart
One command registers the @webcrawl/mcp server and installs the webcrawl-anything Agent Skill (SKILL.md) for Claude Code, Cursor, and Codex:
npx webcrawl setupOr target specific coding agents:
npx webcrawl setup --agent claude --agent cursor --agent codex --agent gemini --agent windsurfCheck your local engine, stealth browser, and parser readiness:
npx webcrawl doctorZero-Key CLI Usage
Webcrawl Anything runs out-of-the-box locally with zero API keys using the built-in impit TLS-impersonated fetcher, document/media parsers, BM25 + semantic ranker, and vertical extractors:
# Scrape any website, GitHub repo, ArXiv paper, PDF, or YouTube video into clean Markdown
npx webcrawl scrape https://github.com/torvalds/linux
npx webcrawl scrape https://arxiv.org/abs/1706.03762
npx webcrawl scrape https://www.youtube.com/watch?v=dQw4w9WgXcQ
# Search the live web or structured verticals
npx webcrawl search "react 19 compiler" -n 5
npx webcrawl search "sony wh-1000xm5" -c shopping
npx webcrawl search "boutique hotels in shibuya" -c hotels
npx webcrawl search "3 bedroom house in marrickville" -c real-estate --sub buy
npx webcrawl search "CVE-2024-3094 xz utils" -c security --sub cve
# Discover every URL on a domain (sitemap.xml + robots.txt + link graph)
npx webcrawl map https://docs.stripe.com --filter webhook -n 50
# Crawl up to 25 pages in parallel with target evidence
npx webcrawl crawl https://docs.stripe.com/webhooks -n 5
# Extract structured JSON from any page
npx webcrawl extract https://news.ycombinator.com --prompt "top 5 stories with points"Example Prompts (Once Connected to Your Agent)
Once npx webcrawl setup has registered the MCP server and skill, ask Claude Code, Cursor, or Codex directly:
"Search for CVE-2024-3094 in the security category and show me the CVSS score, CISA KEV status, and fixed versions."
"Scrape
https://arxiv.org/abs/2305.18290and summarize the DPO objective and experimental results.""Compare retail prices and stock availability for the Apple Mac Mini M4 across US retailers using
web_searchwithcategory: shopping.""Map
https://modelcontextprotocol.io, pick the specification pages, and crawl them into Markdown.""Parse the PDF at
https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdfand verify whether any pages required OCR."
Local Engine vs. webcrawl.app Cloud
Webcrawl Anything uses the exact same TypeScript engine (src/) locally and in the hosted webcrawl.app cloud API. You can start with zero keys locally and upgrade to cloud with one command whenever you need managed stealth browsers or sub-50ms global cache hits:
Capability | Open-Source Local ( |
|
API Key Required | None (Zero-Key) |
|
Core Engine & Target Plugins | 100% shared ( | 100% shared |
PDF, Office, YouTube & CVE Parsers | Built-in local execution | Hosted + background async workers ( |
Anti-Bot & Cloudflare Bypass | Local | Managed residential stealth browser fleet + Cloudflare rendering |
Search Fan-Out | Built-in DuckDuckGo/Bing + BYO keys | Managed multi-provider fan-out (Serper, Brave, Jina, Tavily) |
Global Content Cache | Local in-memory LRU | Sub-50ms global SHA-256 content-addressed cache |
To connect your CLI and MCP server to webcrawl.app cloud:
npx webcrawl login
npx webcrawl whoamiCompact MCP Schema Profile for Context-Constrained Agents
By default, npx webcrawl setup configures WEBCRAWL_MCP_SCHEMA_PROFILE=compact so MCP tool schemas use minimal token overhead inside Claude Code, Cursor, and local LLM context windows while keeping full server-side validation.
To switch to verbose tool parameter descriptions:
npx webcrawl setup --schema-profile fullArchitecture & Shared Engine Flywheel
webcrawl/
├── src/
│ ├── targets/ # Pluggable Target & Extractor Registry (web, pdf-office, youtube, github, arxiv, llms-txt, shopping, travel, real-estate, cve)
│ ├── engine/ # Multi-tier fetcher (impit TLS impersonation → stealth browser → HTML-to-Markdown + SHA-256 cache)
│ ├── parse/ # Native PDF inspector + OCR fallback, DOCX/XLSX/PPTX parser, YouTube caption extractor
│ ├── extract/ # Vertical structured extractors (shopping, flights, hotels, real-estate, business, CVE/NVD/OSV)
│ ├── search/ # Multi-provider search fan-out + vertical pipelines
│ ├── ranker/ # Hybrid BM25 + semantic vector + RRF + MMR diversity reranker
│ └── local-engine.ts # In-process zero-key backend powering CLI & MCP locally
├── packages/
│ ├── cli/ # `webcrawl` CLI (`npx webcrawl search|scrape|map|crawl|extract|rerank|targets|setup|doctor`)
│ ├── mcp/ # `@webcrawl/mcp` stdio & Streamable HTTP MCP server
│ └── client/ # `@webcrawl/client` zero-dependency TypeScript SDK
└── api/
└── index.ts # Production `webcrawl.app` API powered by the exact same `src/` engineEvery community improvement to a target plugin (src/targets/), vertical extractor (src/extract/), or document parser (src/parse/) immediately powers both local CLI/MCP users and the hosted webcrawl.app platform.
Contributing a New Target or Extractor
Want to add a new target (e.g., Reddit threads, Hacker News discussions, SEC EDGAR filings, npm/PyPI packages, or a regional real-estate/shopping portal)?
See CONTRIBUTING.md for the 3-step guide to registering a CrawlTargetPlugin in src/targets/ with a fixture test in src/__tests__/targets.test.ts.
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Web data for agents: YouTube transcripts, screenshots, Google News, WHOIS, jobs, tech stack, more.
Live web access for agents: scrape, SERP search, crawl/map, 100+ collectors, datasets, proxies.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search the web, read and extract content from webpages, fetch JSON from REST APIs, and collect links while bypassing anti-bot protections.22 npmISC
- AlicenseAqualityCmaintenanceEnables AI agents to fetch, crawl, extract, and search web content through a unified set of tools, with automatic routing to specialized backends.4MIT
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to retrieve verified web evidence via headless Chromium rendering, sitemap navigation, and search candidate discovery, returning clean Markdown, structured JSON, and verbatim quoted proof.1 npmMIT
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to search the web through configured providers and crawl individual pages or entire sites into clean, deduplicated Markdown or JSON, including authenticated pages.-