url-to-pdf

url-to-pdf

只需一个 API 密钥，即可将任意公开网页转换为 PDF、整页截图或简洁的 Markdown。

无需运行浏览器集群，也不用操心无头 Chrome。url-to-pdf 在 Cloudflare 的基础设施上渲染页面，并提供下载链接。你可以通过交谈，在任何兼容 MCP 的 AI 客户端（Claude Desktop、Cursor 等）中使用它，也可以直接从脚本调用 HTTP API。

---

你会喜欢它的理由

• 一个密钥，四种输出。 PDF（A4 / Letter / Legal，纵向或横向）、整页 PNG/JPEG 截图、简洁的 Markdown（已移除导航内容）和结构化 JSON（标题、描述、规范 URL、语言、正文、链接）。
• 助手能实际看到结果。 小型输出（≤1 MB）会直接内联返回——截图会以图片形式返回，供模型查看，而不只是返回一个需要大声读出的链接。
• 每次渲染都有凭据。 提供重定向后的最终 URL、HTTP 状态、截取时间、耗时、字节大小和产物的 SHA-256 值，以便之后引用和验证结果。
• 只需交谈即可使用。 将它连接为 MCP 服务，然后说 “将 https://example.com 转换成 PDF”——客户端会完成其余工作。无需使用 curl，也不用手动编写 JSON。
• 同时提供普通 HTTP API。 每个工具只需携带你的 x-api-key 发送一个 POST 请求。非常适合脚本、后端和低代码平台。
• 支持移动设备、视网膜屏幕和深色模式。 可设置任意视口（320–3840 × 240–2160）、最高 3 的设备像素比，并使用 prefers-color-scheme: dark 进行渲染。
• 防范 SSRF。 仅接受公开的 http(s) URL；内部地址和保留地址会在边缘节点被拒绝。
• 从设计上保护隐私。 输出会保留 1 小时，随后自动删除。我们不会看到你的银行卡信息（付款由 Paddle 处理），你的电子邮箱仅用于找回密钥。

---

获取 API 密钥

1. 前往 url-pdf.hammbox.com/buy 并完成结账（通过 Paddle 支付，支持主流信用卡）。
2. 付款完成后，你的密钥会立即显示在屏幕上。 请复制并妥善保管。
3. 密钥丢失了？随时前往 /portal/claim，使用结账时填写的邮箱找回。无需密码，也不用提交支持工单。

---

将其用作 MCP 服务（推荐用于 AI 客户端）

将 url-to-pdf 添加到客户端的 MCP 配置中。使用 Claude Desktop、Cursor 或任何支持 Streamable HTTP 的客户端：

{
  "mcpServers": {
    "url-to-pdf": {
      "type": "http",
      "url": "https://url-pdf.hammbox.com/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

就这么简单——无需本地安装。接着只需用自然语言向助手提出请求：

“将 https://news.ycombinator.com 转换成 PDF，并给我下载链接。”

客户端会调用工具、传入你的密钥，并显示结果。

---

将其用作 HTTP API（适用于脚本和后端）

每次渲染都会向 /tools/* 端点发送一个带密钥的 POST 请求。

# Web page → PDF
curl -X POST https://url-pdf.hammbox.com/tools/url-to-pdf \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"url":"https://example.com","format":"A4"}'

# Full-page screenshot
curl -X POST https://url-pdf.hammbox.com/tools/url-to-screenshot \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"url":"https://example.com","fullPage":true,"format":"png"}'

# Extract Markdown
curl -X POST https://url-pdf.hammbox.com/tools/url-to-markdown \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"url":"https://example.com"}'

# Structured data as JSON
curl -X POST https://url-pdf.hammbox.com/tools/url-to-extract \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"url":"https://example.com","maxLinks":50}'

# Mobile screenshot, retina, dark mode
curl -X POST https://url-pdf.hammbox.com/tools/url-to-screenshot \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"url":"https://example.com","width":390,"height":844,"deviceScaleFactor":2,"darkMode":true,"blockAds":true}'

响应中包含一个有效期为 1 小时的 downloadUrl：

{
  "downloadUrl": "https://url-pdf.hammbox.com/f/pdf/<id>.pdf",
  "contentType": "application/pdf",
  "sizeBytes": 456494,
  "title": "Example Domain",
  "ttlSeconds": 3600,
  "meta": { "format": "A4", "landscape": false },
  "receipt": {
    "renderId": "<uuid>",
    "url": "https://example.com",
    "finalUrl": "https://example.com/",
    "capturedAt": "2026-10-09T06:20:11.482Z",
    "durationMs": 2140,
    "bytes": 456494,
    "sha256": "9f2c…",
    "format": "pdf",
    "httpStatus": 200
  }
}

通过 MCP 调用时，大小不超过 1 MB 的产物还会以内联形式随上述 JSON 一并返回——截图以 image 内容块的形式返回，PDF / Markdown / JSON 则以内嵌资源的形式返回。

curl -O "<downloadUrl>"

---

工具与参数

MCP 工具	HTTP 端点	功能
list_capabilities (免费)	GET /openapi.json	列出功能、价格以及获取密钥的方式
url_to_pdf	POST /tools/url-to-pdf	将页面渲染为 PDF
url_to_screenshot	POST /tools/url-to-screenshot	截取整页屏幕截图
url_to_markdown	POST /tools/url-to-markdown	将页面提取为简洁的 Markdown
url_to_extract	POST /tools/url-to-extract	结构化 JSON：标题、描述、规范链接、语言、正文、链接

url_to_pdf — url（必填）、format（A4 / Letter / Legal，默认 A4）、landscape、printBackground、scale（0.1–2）、margin、preferCssPageSize。

url_to_screenshot — url（必填）、fullPage（默认 true）、format（png / jpeg）、quality（0–1）、selector（截取单个元素）、clip（"x,y,width,height"）。

url_to_markdown — url（必填）、removeSelectors（例如 ["nav",".ads","footer"]）、keepImages。

url_to_extract — url（必填）、maxTextChars（500–200000，默认 20000）、maxLinks（0–500，默认 100）。

每种渲染工具均可使用的选项

选项	范围 / 值	功能
width / height	320–3840 / 240–2160	视口尺寸（默认 1280 × 900）
deviceScaleFactor	0.5–3	设置为 2 可生成 Retina / HiDPI 输出
darkMode	布尔值	使用 prefers-color-scheme: dark 进行渲染
blockAds	布尔值	阻止向主要广告和分析域名发送请求
hideCookieBanners	布尔值	移除类似 Cookie 同意提示的元素
clickSelector	CSS 选择器	截取前先点击（展开、关闭模态框、切换标签页）
waitUntil	load / domcontentloaded / networkidle0 / networkidle2	页面导航等待条件（默认 networkidle2）
waitForSelector	CSS 选择器	截取前等待某个元素
waitMs	0–10000	页面加载后额外等待的时间
timeoutMs	5000–100000	页面导航超时时间（默认 45000）

---

定价

$5 / 月 — 一个订阅、一个 API 密钥，包含全部四种渲染工具。由 Paddle（我们的备案商家）计费和管理；可随时在 Paddle 客户门户中取消。

合理使用说明：渲染由 Cloudflare Browser Rendering 提供。在免费层级下，短时间内大量并发请求可能会被暂时限流（HTTP 429）——几秒后重试即可。

---

链接

• 在线演示：url-pdf.hammbox.com
• 隐私政策 · 退款政策 · 服务条款（链接位于网站页脚）
• 联系方式：[email protected]

许可证

MIT