apunkt/webclaw
1
0
Fork 0
mirror of https://github.com/0xMassi/webclaw.git synced 2026-07-24 07:31:01 +02:00
Code Issues Projects Releases Packages Wiki Activity
webclaw/packages/webclaw-mcp
History
Valerio 248da0abc4 fix(mcp): rename @webclaw/mcp bin to avoid npx PATH shadowing 
The published bin was named `webclaw-mcp`, which npx shadows with any existing
`webclaw-mcp` on PATH (Homebrew/cargo/create-webclaw) — so `npx @webclaw/mcp`
silently ran a stale binary instead of the launcher, for exactly our existing
CLI users. Rename the bin to the unique `webclaw-mcp-launcher`; `npx
@webclaw/mcp` still resolves the single bin. Verified end-to-end: with a stale
webclaw-mcp on PATH, npx now runs the launcher and returns 14 tools.

- bin: webclaw-mcp -> webclaw-mcp-launcher; version 0.6.15 -> 0.6.16
- mark webclaw-mcp.mjs executable
- release.yml: version the launcher INDEPENDENTLY of the core release (a
  launcher-only fix must ship without a core bump) — publish the next patch
  above the current npm version and pin RELEASE_TAG to the release tag
- server.json: sync to 0.6.16

Published + deprecated 0.6.15 (bin collision); 0.6.16 is the first good release.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-22 08:53:29 +02:00
..
package.json fix(mcp): rename @webclaw/mcp bin to avoid npx PATH shadowing 2026-07-22 08:53:29 +02:00
README.md chore(mcp): align @webclaw/mcp npm README, lockstep version, add CI publish 2026-07-22 08:27:53 +02:00
webclaw-mcp.mjs fix(mcp): rename @webclaw/mcp bin to avoid npx PATH shadowing 2026-07-22 08:53:29 +02:00

README.md

@webclaw/mcp

Clean web access for AI agents, over MCP. Turn any URL into markdown, JSON, or LLM-ready context — including pages that block bots or need JavaScript — straight from Claude, Cursor, and any MCP client.

Zero-install launcher for the webclaw MCP server. npx @webclaw/mcp downloads a prebuilt webclaw-mcp binary once (verified against the release SHA256SUMS), caches it, and runs it as an MCP stdio server. No Rust build, no global install. It runs on your machine; the hosted webclaw cloud is used only for the tools that need it, and only when you set WEBCLAW_API_KEY.

Add to your MCP client

Point any stdio MCP client at the npx command — Claude Desktop, Cursor, Windsurf, Antigravity (mcpServers JSON):

{
  "mcpServers": {
    "webclaw": {
      "command": "npx",
      "args": ["-y", "@webclaw/mcp"]
    }
  }
}

Add a key to unlock the cloud-backed tools (bot-protection bypass, JS rendering, web search, research, lead enrichment):

{
  "mcpServers": {
    "webclaw": {
      "command": "npx",
      "args": ["-y", "@webclaw/mcp"],
      "env": { "WEBCLAW_API_KEY": "wc_your_key" }
    }
  }
}

Claude Code:

claude mcp add webclaw -- npx -y @webclaw/mcp

Or run npx create-webclaw to auto-detect your AI tools and write their configs for you.

Tools (14)

scrape, search, crawl, map, batch, extract, summarize, diff, brand, research, lead, lead_batch, plus list_extractors / vertical_scrape for 30+ site-specific extractors (Amazon, GitHub, Reddit, YouTube, npm, PyPI, and more).

  • No key needed: scrape, crawl, map, batch, diff, brand, list_extractors, vertical_scrape.
  • Needs an LLM (local Ollama or a provider key): extract, summarize.
  • Needs WEBCLAW_API_KEY: search, research, lead, lead_batch — plus automatic bot-protection bypass and JS rendering for the fetch tools.

Get a key at webclaw.io.

Environment

Variable Purpose
WEBCLAW_API_KEY Enables cloud-backed tools (optional).
WEBCLAW_MCP_BIN Absolute path to a webclaw-mcp binary; skips the download.
WEBCLAW_MCP_VERSION Release tag to install (default: the pinned release).
WEBCLAW_MCP_CACHE Cache directory (default: ~/.cache/webclaw).

Links

License

AGPL-3.0-only