Skip to main content
Glama
brainfish-ai

@webcrawl/mcp

by brainfish-ai

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.

npm version MCP Server Cloud API License: MIT


Target

Returns

Requirements

Websites & JS SPAs (web)

Clean Markdown, semantic headings, tables, code blocks, links, OpenGraph/JSON-LD, and SHA-256 content hashes

Zero-key local (impit TLS impersonation + local Chrome) or webcrawl.app cloud stealth browsers

PDF & Office Docs (pdf-office)

Page-numbered Markdown, tables, slide notes, and automatic OCR on scanned PDF pages (pagesOcr + honest pagesSkipped)

Built-in (@firecrawl/pdf-inspector, pdf-parse, mammoth, officeparser, tesseract.js)

YouTube & Media (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 (shopping)

Multi-retailer price comparison, currency-normalized offers, stock status, ratings, review counts, and shipping

Zero-key local HTML/JSON-LD product extractor (-c shopping); optional SERPER_API_KEY

Flights & Hotels (travel)

Structured flight routes (origin, destination, airline, stops, price) and hotel nightly rates, stars, and guest ratings

Zero-key local search + schema.org extractor (-c flights / -c hotels)

Real Estate & Local Business (real-estate)

Property listings (bedrooms, bathrooms, parking, suburb, portal) and local business hours, phone, address, and reviews

Zero-key local extractor (-c real-estate --sub buy|rent|sold / -c business)

Security & CVEs (cve)

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 (-c security --sub cve)

GitHub Repos, Issues & Releases (github)

Structured repo metadata (stars, forks, license, topics, language), README Markdown, or issue/PR/release discussion threads

Built-in zero-key HTML & GitHub extractor (npx webcrawl scrape https://github.com/owner/repo)

ArXiv & Academic Papers (arxiv)

Paper title, authors, abstract, primary category, submission date, direct PDF link, and full parsed paper Markdown

Built-in ArXiv abstract & PDF inspector (npx webcrawl scrape https://arxiv.org/abs/...)

llms.txt & Sitemaps (llms-txt)

Structured documentation manifest, section hierarchy, and crawlable doc URLs

Built-in (npx webcrawl scrape https://docs.example.com/llms.txt or npx webcrawl map)

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 setup

Or target specific coding agents:

npx webcrawl setup --agent claude --agent cursor --agent codex --agent gemini --agent windsurf

Check your local engine, stealth browser, and parser readiness:

npx webcrawl doctor

Zero-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.18290 and summarize the DPO objective and experimental results."

  • "Compare retail prices and stock availability for the Apple Mac Mini M4 across US retailers using web_search with category: 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.pdf and 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 (--mode local)

webcrawl.app Cloud (--mode cloud)

API Key Required

None (Zero-Key)

WEBCRAWL_API_KEY (npx webcrawl login)

Core Engine & Target Plugins

100% shared (src/engine, src/targets, src/extract)

100% shared

PDF, Office, YouTube & CVE Parsers

Built-in local execution

Hosted + background async workers (/v1/runs/:id)

Anti-Bot & Cloudflare Bypass

Local impit TLS + local Chrome

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 whoami

Compact 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 full

Architecture & 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/` engine

Every 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

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables 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 npm
    MIT
  • F
    license
    Not graded
    quality
    A
    maintenance
    Enables 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.
    -