# WebReaderAPI 常见问题

> WebReaderAPI 常见问题：关于网页阅读 API 的 30 个解答：每页价格、JavaScript 和 PDF、整站抓取 (crawl)、robots.txt、被拦截的网站、KYC、加密货币支付和 AI 智能体。

- URL: https://webreaderapi.com/zh/faq/
- 最后更新: 2026-10-22
- 发布者: WebReaderAPI (https://webreaderapi.com)

针对开发者、AI 构建者和网站所有者最常问的问题，解答如何用 WebReaderAPI 把网页转成 Markdown。每个解答都以结论开头。

**快速回答 — 人们最常问 WebReaderAPI 的哪些问题？**

主要是每页价格、JavaScript 页面和 PDF 如何计费，以及网站拒绝 robots 时会发生什么。简而言之：**WebReaderAPI** 每读取一页收取 1 积分，使用浏览器时收 2 积分，截至 2026 年 10 月，起价为 US$0.07/千页；被拒绝或读取失败的页面不收费；始终遵守 robots.txt。无需 KYC；用加密货币支付。

## 价格与积分

### WebReaderAPI 多少钱？

预付套餐价格为 10,000 个网页 页 US$3.75、100,000 个网页 页 US$21.75、1,000,000 个网页 页 US$74.25，截至 2026 年 10 月。5,000,000 个网页 套餐的单价降至 US$0.07/千页。[定价页面](https://webreaderapi.com/zh/pricing/) 列出了所有套餐。

### 1 积分能买什么？

读取一页，不使用浏览器。需要 JavaScript 渲染的页面消耗 2 积分，从指定国家读取再加 1 积分。响应中的 `credits_used` 会告诉你实际消耗，因此你可以在自己的日志中跟踪每页成本。

### 积分会过期吗？

不会。预付费积分永不过期：未使用的页面数会一直保留在你的账户中，直到你使用。为一次性整站抓取 (crawl) 购买的套餐，未用完的页数可以留给下一个项目。

### 页面无法读取时会被收费吗？

不会。出错不消耗积分，无论原因在我方、网络还是网站本身。这包括被 robots.txt 拒绝、被 `ai-input=no` 信号拒绝，或被网站自身响应拒绝的页面。

### 有免费套餐吗？

没有。没有免费套餐：最小的积分包是测试的途径，用最低充值额支付，仅为达到该最低额而多充的金额，可在 30 天内按要求以 USDT 或 USDC 退回，前提是尚未使用。

### 最低可以充值多少？

最低充值金额为 US$25。最小的 10,000 个网页 套餐价格为 US$3.75；充值剩余部分留在你的余额中，可用于后续套餐，若未使用可在 30 天内申请退回。

## API 读取和返回的内容

### WebReaderAPI 能读取用 JavaScript 构建的页面吗？

可以。页面需要时在无头浏览器中渲染 JavaScript（render=auto），或始终渲染，或从不渲染。使用 `render=auto` 时，只有当原始 HTML 文本太少才会启用浏览器，因此简单页面仍只消耗 1 积分。

### 能转换 PDF 文件吗？

可以。最大 20 MB、100 页的 PDF 文件可转换为 Markdown，每 10 页（不足 10 页按 10 页计）1 积分。把 PDF 的 URL 发送到同一个 `/read` endpoint；文本会以 Markdown 返回。

### 能读取整个网站吗？

可以，用整站抓取 (crawl) 任务。每个任务抓取一个网站，最多 10,000 页，遵循其 sitemap、robots.txt 和 Crawl-delay。你可以将其限制在 `/docs/*` 等路径下；每读取一页都像单个请求一样消耗积分。

### 一次可以发送多少个 URL？

每个批量任务最多 100 个 URL。批量任务以 job 形式运行：你发送列表，收到 `job_id`，任务完成后收集全部结果。

### 如何让页面不超出模型的上下文窗口？

设置 `max_chars`。Markdown 会按该长度截断，范围为 1,000 到 500,000 个字符。结合 `main_content=true`，可让长页面保持在可预测的 token 预算内。

### Markdown 会保留表格、代码块和链接吗？

会。标题、列表、表格、代码块和链接都会保留 Markdown 形式。链接为内联形式；添加 `include_links=true` 可同时以单独列表返回链接，添加 `include_images=true` 可保留图片。

### “正文”指什么？

指读者真正想要的那部分页面内容：文章、文档或产品描述。使用默认值 `main_content=true` 时，导航菜单、Cookie 横幅、广告、侧边栏和页脚会被移除。设为 `false` 可转换整个页面。

### 能读取在其他国家显示的页面吗？

可以，使用 `country` 参数和两位国家代码。选择页面的读取国家会额外增加 10 积分，因为此时页面会通过该国家的住宅连接读取。有些网站会按国家更改价格、语言或内容。

## robots.txt 与被拒绝的页面

### WebReaderAPI 会遵守 robots.txt 吗？

始终遵守。我们遵守 robots.txt：我们的爬虫以 WebReaderAPI 标识自身，遵循专为其或为所有爬虫编写的规则，不读取网站禁止的页面。被拒绝的页面不扣费。[bot 页面](https://webreaderapi.com/zh/bot/) 展示了 user agent，以及站点所有者如何允许或拒绝它。

### 对于受 Cloudflare 或其他机器人过滤保护的网站会怎样？

如果网站允许我们的爬虫通过，页面会被正常读取。如果网站拒绝或以质询页面作答，我们会将该应答作为 `target_refused` 返回，不收取任何费用。我们绝不尝试绕过质询。

### WebReaderAPI 能读取登录或付费墙后面的页面吗？

不能，绝不可以，即使使用你提供的凭据也不行。需要账户或订阅的内容不在范围内，请求这类内容违反[可接受使用政策](https://webreaderapi.com/zh/acceptable-use/)。

### ai-input=no 信号是什么？

有些站点会根据 Content Signals Policy 在 robots.txt 中添加这样一行，用以拒绝将其页面用作 AI 回答的输入。如果网站在其 robots.txt 中声明 Content-Signal: ai-input=no，我们不会为你读取其页面；API 会返回 `blocked_by_site_policy`，且不收费。

### 为 AI 读取网页合法吗？

这取决于内容、所在国家以及你如何使用文本。遵守 robots.txt 并远离个人数据和付费墙可以降低风险。我们的[规则概览](https://webreaderapi.com/zh/guides/is-reading-web-pages-for-ai-legal/) 总结了要点；这不构成法律建议。

## 账户、付款与隐私

### 我需要验证身份吗？

不需要。WebReaderAPI 不要求 ID、自拍、公司文件或银行卡。使用账号登录；邮箱为可选。[无需 KYC 页面](https://webreaderapi.com/zh/no-kyc-web-reader-api/) 说明了仍然适用的内容。

### 我可以使用哪些加密货币付款？

BTC, USDT, USDC, ETH, SOL, LTC。USDT 支持 TRC-20 或 ERC-20，USDC 支持 ERC-20。请发送显示的确切金额，点击“我已发送付款”，充值将在确认后计入余额。

### 我可以退款吗？

可以，退到你的余额。使用量低于 20% 的积分包可在购买后 72 小时内退回，从未成功使用的积分包会全额返还积分。[退款政策](https://webreaderapi.com/zh/refunds/) 有确切规则和三个示例。

### API 密钥如何运作？

创建多个 API 密钥，例如每个 agent 或项目一个，并可从控制台撤销其中任意一个。在 Authorization 请求头中以 Bearer token 形式发送你的 API 密钥，或在 api_key 查询参数中发送。每个应用或 agent 使用一个密钥，便于吊销某一个而不影响其他。

### 你们会记录我的请求的哪些信息？

每个页面的主机名，绝不记录完整 URL 或其内容，另加时间、状态和积分，保留 30 天。我们不保留你读取的页面的任何副本。[隐私政策](https://webreaderapi.com/zh/privacy/) 有详细信息。

## 开发者与 AI agent

### 有 Python 和 Node.js 的代码吗？

有。[Python](https://webreaderapi.com/zh/docs/python/) 和 [Node.js](https://webreaderapi.com/zh/docs/node/) 指南展示了单次读取、批量、整站抓取 (crawl) 和重试，[快速开始](https://webreaderapi.com/zh/docs/) 有 curl 示例。无需 SDK 包：API 就是使用 JSON 的普通 HTTPS。

### Claude、Cursor 或其他 MCP 客户端能使用 WebReaderAPI 吗？

可以，通过你自己运行的一个小型 MCP server，详见 [MCP 页面](https://webreaderapi.com/zh/docs/mcp/)。它暴露一个工具，接收 URL 并以 Markdown 返回页面。

### 它能与 LangChain 和 LlamaIndex 配合使用吗？

可以。[LangChain 和 LlamaIndex 页面](https://webreaderapi.com/zh/docs/langchain/) 展示了一个文档加载器，可将 URL 连同其元数据转换为文档，随时可用于分块和嵌入。

### 我可以同时读取多少个页面？

每个账户都有同时读取页面数的上限；你的控制台会显示该上限，支持团队可将其提高。整站抓取 (crawl) 还会遵循每个站点的 `Crawl-delay`，因此对单个域名的大规模整站抓取 (crawl) 可能比其页面数量所显示的耗时更长。

### 谁运营 WebReaderAPI？

SerpGoat LLC。有关服务如何运作以及如何联系到真人，请见[关于页面](https://webreaderapi.com/zh/about/)。支持团队每周每天 12 小时内回复，包括抓取和集成方面的帮助。

### 一次读取有多快？

这主要取决于网站以及是否需要浏览器。在通过公开样本测量出速度之前，我们不公布速度数据；一旦有了，会连同方法和日期发布在[状态页面](https://webreaderapi.com/zh/status/) 上。

---

WebReaderAPI: WebReaderAPI 是一款面向 AI agents 的网页读取 API，可将任何公开网页转换为干净的 Markdown，用加密货币支付，无需上传身份证件。预付费积分低至 US$0.07/千页，永不过期，且遵守 robots.txt。无需 KYC — 无身份证、无自拍、无证件。加密货币支付。