在 n8n AI agent 中使用 SerpCrypto SERP API 进行网页搜索

为什么用 HTTP Request 节点而不是自定义节点？

n8n 的文档指出，HTTP Request 节点可以作为普通节点运行，也可以挂接到 AI agent 上作为工具使用。这足以覆盖 SerpCrypto 这样的 REST API：只需一次 GET 请求，带一个 header 和几个查询参数。我们不需要安装或维护任何社区节点，凭证也保存在 n8n 的加密凭证存储中。

AI Agent 节点需要一个 chat model 和至少一个工具子节点。从 n8n 1.82.0 起，每个 AI Agent 都作为 Tools Agent 工作，因此 agent 会自行决定何时调用搜索工具。

如何存储 API 密钥？

创建一个 Header Auth 凭证。n8n 的凭证文档描述了 header 的 Name 和 Value 两个字段，并指出 bearer token 就是 Name 为 Authorization、Value 为 Bearer <token> 的 header auth。在 Name 中填入 Authorization，在 Value 中填入 Bearer 加上你的 SerpCrypto 密钥。

n8n 还列出了通用的 Bearer auth 类型；两者发送的 header 相同。给 n8n 单独配一个 API 密钥，这样就能把它与其他脚本的用量分开查看，必要时也可以单独吊销。你可以在 dashboard 中随时创建和撤销的 API 密钥。

模型如何填写搜索查询？

让模型定义 q。在可用的参数字段旁，n8n 会显示一个星形按钮，可将该值交给模型。你也可以自己输入 $fromAI() 表达式，它接受 key、description、type 和 default value；description 告诉模型该填什么。n8n 文档说明 $fromAI() 仅适用于连接到 AI Agent 节点的工具。

如果你的 agent 只服务一个市场，就把 gl 和 hl 固定。如果用户会询问不同国家，也让模型来设置它们，并描述预期的代码，例如 gb 或 de。

{{ $fromAI("query", "The search query, as a person would type it", "string") }}

为什么要开启 Optimize Response？

JSON 格式的完整结果页很长，而工具返回的所有内容都会进入模型的上下文。Optimize Response 是 HTTP Request 节点的一个仅用于工具的选项，它会削减传给模型的数据；n8n 指出这样可以降低成本。使用 JSON 响应类型时，把 Field Containing Data 设为 organic_results，并只选择 title、link 和 snippet。

这样 agent 每次搜索只读取约十条简短条目，而不是页面的每个区块。如果你的 agent 回答本地问题，则在第二个工具中把 Field Containing Data 指向 local_results。

如何在普通工作流中使用同一个 API？

不使用 agent 时，把 HTTP Request 节点当作普通节点，配一个固定的 q，例如用在每天早上检查关键词的 Schedule Trigger 工作流中。然后添加一个 Split Out 节点，把 Field to Split Out 设为 organic_results：它会把列表拆成每条结果一个 item，可直接交给电子表格或数据库节点。

每次运行对每个关键词执行一次搜索，所以每天 50 个关键词每月约用 1,500 积分。25,000 次搜索 积分包（US$18.75）可覆盖十倍以上，而且 预付的搜索积分永不过期：未使用的查询会一直留在你的账户中，直到你使用它们。

如何在 n8n 之外测试该请求？

在终端中运行同样的请求。如果那里能成功，n8n 中的问题就出在节点设置上；如果失败，错误正文会说明原因，如错误页面所列。错误从不计费。

# The request the HTTP Request node sends, for a test in a terminal
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=n8n self-hosted vs cloud" -d gl=us -d hl=en \
  | jq '.organic_results[]? | {title, link, snippet}'