用 WebReaderAPI 在 n8n AI agent 中读取网页

为什么用 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 中，让工具返回错误，以便模型解释它或尝试其他来源；在定时工作流中，把错误路由到记录它们的分支。错误页面列出了所有代码。

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

在终端用 curl 运行同样的调用，如 curl 配方 所示。如果在终端能用而在 n8n 中失败，原因就在节点设置里，最常见的是凭证值缺少 Bearer 前缀，或 url 参数留空。