# n8n

> 通过已验证的 n8n-nodes-search1api 社区节点，为 n8n 工作流添加网页搜索、智能搜索、新闻、页面读取、站点地图发现和热门话题。

Canonical URL: https://s1.dev/zh/docs/integrations/n8n

`n8n-nodes-search1api` 是一个[已验证的 n8n 社区节点](https://n8n.io/integrations/)，通过 Search1API 为 n8n 工作流提供实时网络访问——网页搜索、智能搜索、新闻搜索、可读页面获取、站点地图发现和热门话题，全部通过 n8n 原生节点界面使用。

> **info:** **验证状态：**`n8n-nodes-search1api` 已通过 n8n 的自动和人工审核，并收录在 [n8n 官方社区节点目录](https://n8n.io/integrations/)中。

## 安装

在 n8n 中，从 **Settings → Community Nodes** 安装社区节点 `n8n-nodes-search1api`，或通过命令行安装：

```bash
npm install n8n-nodes-search1api
```

然后重启 n8n。该节点会出现在节点面板的 **Search1API** 下。

## 凭据

1. 在 [Search1API 仪表盘](https://app.s1.dev)中创建密钥。
2. 在 n8n 中创建一个 **Search1API API** 凭据并粘贴密钥。
3. 测试凭据——测试会调用只读的 `/usage` 端点，不会执行搜索。

请将 API 密钥保存在 n8n 凭据中，切勿放在工作流字段或导出的工作流 JSON 里。

## 操作

| 操作 | 作用 |
| --- | --- |
| **Web Search: Search** | 使用 Google、Bing、DuckDuckGo、Reddit、GitHub、YouTube、arXiv、Wikipedia 等来源搜索实时网页 |
| **Agentic Search: Ask** | 只用 Query 描述研究任务，由 Search1API 选择来源和过滤条件（5 积分，45 秒超时） |
| **News Search: Search** | 从 Bing、Google、DuckDuckGo、Yahoo、Hacker News 或 Reuters 搜索最新新闻 |
| **Page: Retrieve** | 从公开 URL 获取可读内容 |
| **Sitemap: Discover** | 发现网站的站点地图 URL 或全部公开链接 |
| **Trending Topic: Get Many** | 获取 GitHub 或 Hacker News 当前的热门内容 |
| **Usage: Get** | 查看 API 密钥在所选时间段内的用量 |

Search1API 节点也可以在 AI Agent 工作流中作为 n8n AI 工具使用。

Agentic Search 只发送 **Query**，即使是从已保存过滤条件的现有 Web
Search 节点切换过来也是如此。其响应会保留 `intent`、结果的 `source`
和 `relevance`，以及可选的 `errors`。参见[智能搜索](https://s1.dev/zh/docs/basic/ask)。

## 使用建议

针对性的查询可使用 **Web Search**，取 5 到 10 条结果。深入研究时，增加结果数量，并设置 **Crawl Results** 以获取最相关结果的全文。

当工作流目标明确时，使用垂直来源：

- **GitHub**：仓库和代码项目
- **Reddit**：社区讨论
- **ArXiv**：研究论文
- **YouTube**：视频
- **WeChat** 或 **Bilibili**：中文内容

所有操作都是只读的。搜索结果包含来源 URL，可以传给后续的工作流步骤。

## 积分

搜索和新闻请求每次消耗 1 积分；抓取页面时，每个成功抓取的页面额外消耗 1 积分。智能搜索每次请求消耗 5 积分。新账户无需信用卡即可获得 100 积分。当前费率参见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。

## 搜索过滤条件与结果字段

**0.2.0** 版本支持全部 19 个[搜索引擎](https://s1.dev/zh/docs/basic/search)和全部 6 个
[新闻来源](https://s1.dev/zh/docs/basic/news)，包括 Bing China、Yandex、Grokipedia 和 Reuters。
`time_range` 支持 `day`、`week`、`month` 和 `year`；`page` 支持搜索
分页。这些过滤条件适用于搜索/新闻；智能搜索只接受 `query`。

引擎特有的结果字段位于可选的 `metadata` 中：GitHub 搜索提供
`metadata.kind`、`metadata.stars`、`metadata.language` 和 `metadata.num_comments`；
Hacker News 搜索提供 `metadata.story_url`、`metadata.points` 和
`metadata.num_comments`。可选的 `published_date` 保留在结果顶层。
响应级的 `searchParameters` 描述实际执行的请求。这些路径
适用于搜索/新闻；[热门](https://s1.dev/zh/docs/advanced/trending)保持其独立的响应结构。

## 源码

[github.com/superagents-lab/n8n-nodes-search1api](https://github.com/superagents-lab/n8n-nodes-search1api)
· [npm](https://www.npmjs.com/package/n8n-nodes-search1api)
· [n8n 社区节点](https://docs.n8n.io/integrations/community-nodes/)