English Français العربية

Web2MD

Registre officiel Recherche et web

Turn any web page into clean Markdown, text or token-bounded RAG chunks (via RapidAPI).

Code source Site web Documentation

Que pouvez-vous faire avec Web2MD ?

  • read_url: fetch a web page and return its main content as Markdown or plain text, without nav, ads or boilerplate.
  • chunk_url: fetch a web page and split it into heading-aware chunks sized in tokens, for RAG and embeddings.
  • convert_html: convert raw HTML you already have into Markdown or plain text.
  • page_metadata: get a page's title, author, published date, description and similar fields without the full content.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package web2md-rag-mcp
Claude Code 
claude mcp add web2md -e 'RAPIDAPI_KEY=<your rapidapi_key>' -- npx -y web2md-rag-mcp@0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "web2md": {
            "command": "npx",
            "args": [
                "-y",
                "web2md-rag-mcp@0.1.0"
            ],
            "env": {
                "RAPIDAPI_KEY": "<your rapidapi_key>"
            }
        }
    }
}

Variables d'environnement

  • RAPIDAPI_KEY obligatoire secret Your RapidAPI key, subscribed to Web2MD (free BASIC plan available).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Web2MD MCP server
  2. What it does
  3. Setup in 3 steps
  4. Tools
  5. Limits and plans
  6. Errors
  7. Privacy
  8. Development
  9. Licence

Web2MD MCP server

An MCP server that turns any web page into clean Markdown, plain text or token-bounded RAG chunks, using the Web2MD API on RapidAPI.

What it does

  • read_url: fetch a web page and return its main content as Markdown or plain text, without nav, ads or boilerplate.
  • chunk_url: fetch a web page and split it into heading-aware chunks sized in tokens, for RAG and embeddings.
  • convert_html: convert raw HTML you already have into Markdown or plain text.
  • page_metadata: get a page's title, author, published date, description and similar fields without the full content.

Setup in 3 steps

  1. Subscribe to Web2MD on RapidAPI. The BASIC plan is free and includes 500 requests per month.
  2. Copy your X-RapidAPI-Key from the Endpoints tab of the listing.
  3. Add the server to your client.

Requires Node.js 22 or newer.

Claude Code:

claude mcp add web2md -e RAPIDAPI_KEY=your-key -- npx -y web2md-rag-mcp

Claude Desktop (claude_desktop_config.json) and Cursor (~/.cursor/mcp.json) use the same JSON:

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["-y", "web2md-rag-mcp"],
      "env": { "RAPIDAPI_KEY": "your-key" }
    }
  }
}

Windsurf: put the same block in ~/.codeium/windsurf/mcp_config.json.

Tools

ToolWhat it doesArgumentsReturns
read_urlFetch a page as clean Markdown or texturl (up to 2048 chars); format: markdown, text or json; include_links, include_images, include_tablesTitle, token count and the content; format: "json" returns the full JSON document
chunk_urlSplit a page into RAG chunksurl; max_tokens 64-8192 (default 512); overlap_tokens 0-1024 (default 50); include_links, include_images, include_tablesJSON with total_tokens and chunks, each with its heading path and token count
convert_htmlConvert raw HTMLhtml (up to 5,000,000 chars); optional url to resolve relative links; format; include_links, include_images, include_tablesSame as read_url
page_metadataGet page metadataurlJSON with title, author, date, description, site name, language, canonical URL, image, word count, reading time

Limits and plans

PlanPriceRequests per month
BASIC$0500
PRO$910,000
ULTRA$2960,000
MEGA$79250,000
  • RapidAPI rate limit: 1,000 requests per hour.
  • Pages up to 5 MB.
  • robots.txt is respected.
  • JavaScript-heavy pages may return no_content. Rendering support is planned.

Errors

Tool errors look like Web2MD error [code]: message. Input-validation failures (a bad URL, out-of-range numbers) come from the MCP SDK as MCP error -32602: Input validation error ... instead.

CodeMeaning
missing_keyRAPIDAPI_KEY is not set
invalid_keyRAPIDAPI_KEY contains characters not allowed in an HTTP header, often a pasted newline
rapidapi_authRapidAPI rejected the key, or you are not subscribed
rapidapi_quotaYour plan's quota or rate limit is used up
invalid_requestThe request failed validation (HTTP 422)
invalid_url400: not http/https, has credentials, no host, bad port, or longer than 2048 chars
blocked_destination400: host resolves to a private, loopback, link-local or metadata address; port not 80/443; localhost/.local/.internal. Applies to every redirect
dns_error400: the host does not resolve
robots_disallowed403: the site's robots.txt disallows the web2md user agent for that path
page_too_large413: page larger than 5 MB
unsupported_content_type415: not HTML
no_content422: fewer than 10 words of main content, often a JavaScript-only page
host_rate_limited429: per-target-site limit that protects the sites fetched. It is not your quota
target_blocked502: the site answered 401/403/429/503, often a bot wall
target_error502: the site answered another 4xx/5xx
fetch_failed502: could not connect, or TLS failed
too_many_redirects502: more than 5 redirects
fetch_timeout504: the fetch took more than 15 s
timeoutThe Web2MD request timed out
network_errorThe request could not reach the API
bad_responseThe API returned a non-JSON success response
http_<status>Any other HTTP failure, with a short snippet of the response
internal_errorAn unexpected error inside the MCP server

Privacy

Your key is sent only to the RapidAPI gateway (web2md-webpage-to-markdown-rag-chunks.p.rapidapi.com) and is never logged.

Development

npm ci
npm test
npm run lint
npm run build
RAPIDAPI_KEY=your-key npm run smoke

Licence

MIT

Questions fréquentes

Qu'est-ce que Web2MD ?

Turn any web page into clean Markdown, text or token-bounded RAG chunks (via RapidAPI).

Comment installer Web2MD ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add web2md -e 'RAPIDAPI_KEY=<your rapidapi_key>' -- npx -y web2md-rag-mcp@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Web2MD ?

Oui. Il attend RAPIDAPI_KEY, à renseigner dans sa configuration.

Web2MD est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Web2MD ?

Il est publié par kanavsingla28. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.