# web2md.cutexiaoguigui.eu.org

> URL-to-Markdown conversion API for AI agents and developers.
> Converts any web page to clean, structured Markdown with support for
> JavaScript-heavy sites, Chinese platforms, and paywalled content.

## API Endpoints

### Convert URL (GET)
GET https://web2md.cutexiaoguigui.eu.org/<encoded-url>
- Returns: Markdown content
- Params: ?format=markdown|html|text|json, ?selector=<css>, ?force_browser=true, ?no_cache=true

### Streaming (GET)
GET https://web2md.cutexiaoguigui.eu.org/api/stream?url=<encoded-url>
- Returns: Server-Sent Events stream with conversion progress

### Batch Convert (POST)
POST https://web2md.cutexiaoguigui.eu.org/api/batch
- Body: { "urls": ["url1", "url2", ...], "format": "markdown" }
- Returns: Array of conversion results

### Structured Extract (POST)
POST https://web2md.cutexiaoguigui.eu.org/api/extract
- Body: { "url": "...", "schema": { "fields": [...] } }
- Returns: Structured data extracted from the page

### Deep Crawl (POST)
POST https://web2md.cutexiaoguigui.eu.org/api/deepcrawl
- Body: { "url": "...", "max_depth": 3, "max_pages": 50 }
- Returns: Crawled pages as Markdown

### Async Jobs (POST)
POST https://web2md.cutexiaoguigui.eu.org/api/jobs
- Body: { "tasks": [{ "url": "..." }] }
- Returns: Job ID for polling results

### Health Check (GET)
GET https://web2md.cutexiaoguigui.eu.org/api/health
- Returns: Service status and metrics

### Usage (GET)
GET https://web2md.cutexiaoguigui.eu.org/api/usage
- Returns: Current tier, monthly quota, credits used, daily breakdown
- Auth: Bearer API key

## Developer Portal
Sign up at https://web2md.cutexiaoguigui.eu.org/portal/ with your email (passwordless Magic Link).
Manage API keys, track usage, see tier limits in real time.

## Supported Platforms
WeChat (微信公众号), Zhihu (知乎), Yuque (语雀), Feishu/Lark (飞书),
CSDN, Juejin (掘金), 36Kr, Toutiao (头条), NetEase (网易), Weibo (微博),
Reddit, Twitter/X, Notion, and any other public URL.

## Authentication and Tiers

Request an API key at https://web2md.cutexiaoguigui.eu.org/portal/. Authenticate with:
  Authorization: Bearer mk_...

Tiers:
- anonymous (no key): cache + readability only, no browser rendering, no expensive params
- free (1,000 credits/month): full pipeline including browser rendering
- pro (50,000 credits/month): full pipeline + engine selection, proxy, no_cache, force_browser

Credit costs are fixed per endpoint: convert=1, extract=3, deepcrawl=2 per URL.

Response headers on authenticated requests:
- X-RateLimit-Limit: monthly credit quota
- X-RateLimit-Remaining: credits left this period
- X-Request-Cost: credits this request consumed
- X-Quota-Exceeded: true when cached content is served past quota

## MCP Server
Install: npm install -g @digidai/mcp-website2markdown
Provides convert_url tool for Claude Desktop, Cursor, and other MCP clients.

## Source Code
Apache-2.0 licensed: https://github.com/Digidai/website2markdown