# 用 WebReaderAPI 在 n8n AI agent 中读取网页

> 在 n8n AI agent 中读取网页：把任意 URL 变成干净 Markdown 的 HTTP Request 工具设置，以及一个定时工作流。无需 KYC，用加密货币支付。

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

n8n 的 HTTP Request 节点可以作为其 AI Agent 节点的工具使用。把它指向 `/read`，让模型填入 URL，agent 就能以干净 Markdown 读取任意公开网页，无需安装社区节点。

**快速回答 — 如何让 n8n AI agent 读取网页？**

把 HTTP Request 节点作为工具挂到 n8n 的 AI Agent 上，设置为 `GET https://webreaderapi.com/api/v1/read`，并使用持有你 **WebReaderAPI** 密钥的 Header Auth 凭证，让模型定义 `url` 参数。开启 Optimize Response，只保留 `title`、`final_url` 和 `markdown`。每个页面消耗 1 积分，截至 2026 年 10 月，价格从 US$0.07/千页 起。无需 KYC；用加密货币支付。

## 我用哪些 HTTP Request 设置？

选项名称遵循 n8n 的 HTTP Request 节点文档，查阅于 2026-10-22。

| 设置 | 值 |
| --- | --- |
| 位置 | 作为工具挂到 **AI Agent** 节点上 |
| Method | `GET` |
| URL | `https://webreaderapi.com/api/v1/read` |
| 身份验证 | Generic credentials → **Header Auth** |
| Header Auth 凭证 | Name 填 `Authorization`，Value 填 `Bearer ` 后接你的 API 密钥 |
| Send Query Parameters | 开启，**Using Fields Below** |
| 参数 `url` | 由模型定义（见下文） |
| 参数 `max_chars` | 固定值，例如 `15000` |
| Optimize Response | 开启 · 响应类型 **JSON** · Include Fields 选 **Selected**：`title`、`final_url`、`markdown` |

## 为什么用 HTTP Request 节点作为工具？

因为它已经满足这个 API 所需的一切：一个 GET 请求、一个 header 和两个 query 参数。n8n 文档说明 HTTP Request 节点既可作普通节点运行，也可作为工具挂到 AI agent 上，且部分选项只在工具形式中存在。

我们这边没有任何东西需要安装或更新，密钥存放在 n8n 的凭证库中，而不是工作流里。给 n8n 单独一把密钥，这样它的用量能与其他脚本区分开，也能单独吊销。创建多个 API 密钥，例如每个 agent 或项目一个，并可从控制台撤销其中任意一个。

## 模型如何选择要读取的 URL？

让模型定义 `url` 参数。n8n 会在符合条件的参数字段旁显示一个按钮，把值交给模型，你也可以用 n8n 的 `$fromAI()` 函数自己写表达式。它接受一个 key、一段 description、一个 type 和一个可选的 default，例如 key 为 `url`、description 为 "The http or https address of the page to read"、type 为 `string`。

n8n 文档说明 `$fromAI()` 只在连接到 AI Agent 节点的工具中有效。工具描述也用平实的语言写，例如 "Reads a public web page and returns its main content as Markdown"，这样 agent 就知道何时调用它。

## 为什么开启 Optimize Response？

因为工具返回的一切都会进入模型的上下文。Optimize Response 是仅限工具的选项，用于减少传给模型的数据。选择 JSON 响应类型时，你可以只包含选中的字段；保留 `title`、`final_url` 和 `markdown`，去掉其余部分。

在我们这边用 `max_chars` 限制长度，它会在 Markdown 离开 API 前截断。该节点的 HTML 和 Text 响应类型有自己的 Truncate Response 选项，但对于我们的 JSON 返回，`max_chars` 是更简单的控制方式。

## 如何在定时工作流中使用 API？

在 Schedule Trigger 后面把 HTTP Request 节点当普通节点用，而不是工具。给它一个固定的 `url`，例如你关注的更新日志或定价页，并把 `markdown` 字段传给下一个节点：文件、数据库、聊天消息，或与上一次运行做比较。

每次运行按每个 URL 读取一个页面。每天监控 20 个页面，对于不需要浏览器的页面每月约消耗 600 积分，因此 10,000 个网页（US$3.75）能用一年多。预付费积分永不过期：未使用的页面数会一直保留在你的账户中，直到你使用。

## 当站点拒绝读取时会发生什么？

节点收到带 `blocked_by_robots` 或 `target_refused` 之类代码的错误响应，且不计费。我们遵守 robots.txt：我们的爬虫以 WebReaderAPI 标识自身，遵循专为其或为所有爬虫编写的规则，不读取网站禁止的页面。被拒绝的页面不扣费。在 agent 中，让工具返回错误，以便模型解释它或尝试其他来源；在定时工作流中，把错误路由到记录它们的分支。[错误页面](https://webreaderapi.com/zh/docs/errors/)列出了所有代码。

## 我能在构建工作流之前先试用这个调用吗？

在终端用 curl 运行同样的调用，如 [curl 配方](https://webreaderapi.com/zh/docs/curl/) 所示。如果在终端能用而在 n8n 中失败，原因就在节点设置里，最常见的是凭证值缺少 `Bearer ` 前缀，或 `url` 参数留空。

## n8n：常见问题

### WebReaderAPI 需要社区节点吗？

不需要。内置的 HTTP Request 节点就够了，可作为 AI Agent 的工具，也可作为任意工作流中的普通节点。

### agent 能读取 JavaScript 页面或 PDF 吗？

需要。API 会自行判断何时需要浏览器（`render=auto`），并将 PDF 作为文本读取。渲染页面消耗 2 积分；最大 20 MB、100 页的 PDF 文件可转换为 Markdown，每 10 页（不足 10 页按 10 页计）1 积分。

### 如何阻止 agent 读取过多页面？

在 agent 的 system message 中说明它可读取的页面数量，并将 `max_chars` 保持适中。每次读取都是一次工具调用，因此你对 agent 工具调用设置的限制也会同时限制页面数量。

### 如何支付积分？

在 BTC, USDT, USDC, ETH, SOL, LTC 的 US$25 中充值，然后购买 pack。WebReaderAPI 不要求 ID、自拍或公司文件。

## 来源

1. [HTTP Request 节点](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22)
2. [HTTP Request 凭据](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22)
3. [AI Agent 节点](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22)
4. [让 AI 用 $fromAI() 指定工具参数](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22)

---

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