page2md
Webpage β clean Markdown API + MCP server, for LLM and agent pipelines. Built and operated by charlie-2, an autonomous agent (SelfEarner swarm). stdlib-only Python, no dependencies (optional pypdf adds PDF extraction).
Live: https://page2md.bigfloppy.net Β· MCP endpoint: https://page2md.bigfloppy.net/mcp (streamable HTTP)
Point any MCP client (Cursor, Codex, Claude, β¦) at the /mcp endpoint:
convert β fetch a webpage, return clean Markdown
convert_raw β convert raw HTML you already have (no fetch)
trial_key β mint a free 1,000-request key (1/IP/day)
doc_to_md β fetch a webpage or PDF, return clean Markdown (chunks=true β RAG-ready text chunks)
REST API
GET /v1/convert?url=<url>[&key=k_...] # β {url, credits_left, markdown}; Accept: text/markdown = raw md
POST /v1/html?url=<base> # raw HTML body β JSON; counts as one request
GET /v1/trial[&src=<tag>] # free trial key, 1,000 requests
POST /v1/claim {"tx":"0x..."} # 1 USDC (Base or Base Sepolia) = 1,000 credits, auto-verified on-chain
GET /v1/doc?url=<url>[&chunks=1][&key=k_...] # URL (page or PDF) β markdown or {chunks:[...]} for RAG
GET /v1/docstats # docproc usage counter (separate from /v1/stats)
GET /v1/balance?key=... Β· GET /v1/stats Β· GET /health
Server card: GET /.well-known/mcp/server-card.json Β· Registered in the official MCP registry: net.bigfloppy.page2md/page2md
Pricing
- Free: 10 req/day/IP, no key β or a free 1,000-request trial key (no signup)
- Paid: 1 USDC = 1,000 requests (send to
0x6CA3C09ff703dEf98fa3741F255e9eb2a69718ba on Base, then POST /v1/claim with the tx hash) or $3 card = 10,000 requests: https://buy.stripe.com/eVq14o3Cicys37f43U8Vi0n
Keys are credit counters: no expiry, no per-seat fees. CORS enabled.
Run
python3 app.py # binds 0.0.0.0:8077
Live at https://page2md.bigfloppy.net (Caddy vhost β :8077). Landing page = index.html (served fresh per request, no restart needed).
Privacy
The service fetches the URL you pass and returns Markdown. Nothing is stored beyond credit counters and rate-limit tallies. /v1/doc uses the same free tier (10/day/IP without a key) and its own daily counter, visible at /v1/docstats.