> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Olostep + n8n

> 将网页抓取、搜索、批量作业、爬取和网站地图添加到任何 n8n 工作流中，无需代码。

经过验证的 [Olostep Web Scraper 节点](https://n8n.io/integrations/olostep-web-scraper/)为你提供了 n8n 可视化构建器中的六个操作：抓取 URL、搜索网页、获取 AI 答案、批量抓取数千个 URL、爬取网站或映射其所有链接。

[在 n8n 上查看 →](https://n8n.io/integrations/olostep-web-scraper/)

## 开始之前

* **拥有带有 API 密钥的 Olostep 账户：** [免费获取](https://olostep.com/dashboard)，无需信用卡。你的前 500 个积分已包含在内。
* **n8n 正在运行：** 可以是 [n8n Cloud](https://n8n.io/cloud/) 或自托管实例。社区节点必须启用（在大多数设置中默认启用）。
* **无需编码：** 本指南中的所有操作均通过 n8n 的可视化编辑器完成。

***

## 设置

<Steps>
  <Step title="搜索 Olostep 节点">
    打开任意工作流，点击 **+**，搜索 **Olostep**。从结果中选择 **Olostep Web Scraper**。

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-1.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=dee8769fcd2a85836d8fb16c12f577ba" alt="在 n8n 节点选择器中搜索 Olostep" width="1602" height="1114" data-path="images/integrations/n8n/step-1.png" />
  </Step>

  <Step title="安装节点">
    点击结果以打开节点详情面板，然后点击 **安装节点**。n8n 将安装 `n8n-nodes-olostep` 并提示你重启。请在继续之前执行此操作。

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-2.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=2721be5e49905b7428c6a082ed73dd18" alt="Olostep Web Scraper 节点详情，带有安装节点按钮" width="1602" height="1114" data-path="images/integrations/n8n/step-2.png" />

    <Note>
      如果你的工作空间禁用了 **社区节点**，管理员需要先启用它。请参阅 [n8n 社区节点指南](https://docs.n8n.io/integrations/community-nodes/installation/)。
    </Note>
  </Step>

  <Step title="添加你的 API 密钥">
    在工作流中打开 Olostep 节点，点击 **设置凭证**（在参数选项卡中），添加你的 API 密钥，然后点击 **保存**。

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-3.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=ce6d9f0d70ee4f4a8f167bf1909b7c8d" alt="n8n 中的 Olostep 凭证表单，带有 API 密钥字段" width="1742" height="1114" data-path="images/integrations/n8n/step-3.png" />

    从 [Olostep 仪表板获取你的密钥 →](https://olostep.com/dashboard)
  </Step>

  <Step title="连接并运行">
    将 Olostep 节点连接到触发器和任何下游步骤，然后执行你的工作流。

    <img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/step-4.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=bf0a711ca890d85ed1b8915c50035697" alt="n8n 工作流画布，计划触发器连接到 Olostep 节点" width="1742" height="1114" data-path="images/integrations/n8n/step-4.png" />
  </Step>
</Steps>

***

## 操作

<CardGroup cols={2}>
  <Card title="抓取网站" icon="file-lines">
    从任何 URL 提取内容为 Markdown、HTML、JSON 或纯文本。处理 JS 渲染页面，支持可选等待时间和国家目标。
  </Card>

  <Card title="搜索" icon="magnifying-glass">
    运行网页搜索并以 JSON 格式获取结构化结果（标题、URL 和摘要）。
  </Card>

  <Card title="答案（AI）" icon="sparkles">
    提出自然语言问题并获得带有引用来源的答案。在需要有依据的回答时，适合在 LLM 节点之前使用。
  </Card>

  <Card title="批量抓取 URL" icon="layer-group">
    在一个作业中提交最多 10,000 个 URL，并行处理。返回一个 `batch_id`；异步检索结果。
  </Card>

  <Card title="创建爬取" icon="spider-web">
    从一个 URL 开始，跟随链接并抓取所有子页面。适用于文档网站、博客或全站点摄取。返回一个 `crawl_id`。
  </Card>

  <Card title="创建地图" icon="map">
    获取网站上的每个 URL 而不抓取内容。在批量作业之前用于发现。返回一个 `map_id`。
  </Card>
</CardGroup>

<Note>
  **批量、爬取和地图是异步的。** 存储返回的 ID，并使用等待节点或第二个工作流在处理完成后检索结果。
</Note>

***

## 示例工作流：从 Google Sheets 丰富潜在客户信息

**它的作用：** 当你将公司 URL 粘贴到 Google 表格中时，此工作流会自动抓取公司网站，使用 AI 节点提取关键信息，并将结果写回同一行，将空白电子表格变成填充的潜在客户数据库。

**使用的节点：** Google Sheets 触发器 → Olostep 抓取网站 → OpenAI → 代码 → Google Sheets 更新

<img src="https://mintcdn.com/olostep-58/dxAYTC_H6gJN108B/images/integrations/n8n/workflow-example.png?fit=max&auto=format&n=dxAYTC_H6gJN108B&q=85&s=60e725c70903c2b3cf6918f2ca486e70" alt="n8n 中的潜在客户信息丰富工作流：Google Sheets 触发器连接到 Olostep、OpenAI、代码和 Google Sheets 更新节点" width="868" height="558" data-path="images/integrations/n8n/workflow-example.png" />

***

### 步骤 1：设置你的 Google 表格

创建一个包含以下列的表格：`Company URL`、`Industry`、`Description`、`Company Size`、`Enriched`。工作流从 `Company URL` 读取并填充其余部分。

### 步骤 2：添加 Google Sheets 触发器

在 n8n 中，添加一个 **Google Sheets** 触发器节点。将事件设置为 **Row Added**，指向你的表格，并设置为监视 `Company URL` 列。现在每次你将新 URL 粘贴到表格中时，此工作流都会触发。

### 步骤 3：添加 Olostep 抓取网站

在触发器之后连接一个 **Olostep Web Scraper** 节点。设置：

* **Action：** 抓取网站
* **URL：** `{{ $json["Company URL"] }}`（从新行中提取 URL）
* **Output Format：** Markdown

Markdown 在这里效果最佳，因为它去除了导航、广告和样板。下一步中的 AI 节点将获得关于公司的干净文本，而不是原始 HTML 噪音。

### 步骤 4：添加 OpenAI 节点

连接一个 **OpenAI** 节点。将模型设置为 `gpt-4o-mini`（快速且适合提取任务），并使用以下提示：

```
你是一名销售研究员。根据以下公司网站内容，提取：
1. 行业（一个短语，例如 "B2B SaaS"，"电子商务"，"医疗保健"）
2. 一句话公司描述（最多 20 个字）
3. 估计公司规模（初创公司 / 中小企业 / 中型市场 / 企业）

仅返回一个带有键的 JSON 对象：industry, description, company_size。

网站内容：
{{ $json.markdownContent }}
```

`markdownContent` 字段是 Olostep 从抓取中返回的，作为干净的纯文本。

### 步骤 5：解析 AI 响应并写回

添加一个 **代码** 节点以解析来自 OpenAI 的 JSON：

```js theme={null}
const parsed = JSON.parse($input.first().json.message.content);
return [{ json: parsed }];
```

然后连接一个 **Google Sheets** 节点设置为 **更新行**。映射列：

* `Industry` → `{{ $json.industry }}`
* `Description` → `{{ $json.description }}`
* `Company Size` → `{{ $json.company_size }}`
* `Enriched` → `Yes`

### 你得到什么

将像 `https://notion.so` 这样的 URL 粘贴到你的表格中，约 10 秒内该行会填充：

| Company URL                            | Industry          | Description                                         | Company Size | Enriched |
| -------------------------------------- | ----------------- | --------------------------------------------------- | ------------ | -------- |
| [https://notion.so](https://notion.so) | Productivity SaaS | All-in-one workspace for notes, docs, and databases | Mid-market   | Yes      |

从这里你可以扩展此工作流：在丰富完成时添加 Slack 通知，在写回之前按行业过滤，或用 HubSpot 替换 Google Sheets 以直接更新联系人。

***

## 模板

准备导入的 n8n 工作流，使用 Olostep 构建：

<CardGroup cols={2}>
  <Card title="爬取文档 → AI 知识库" icon="book" href="https://www.n8n.io/workflows/13436-crawl-documentation-sites-and-build-an-ai-knowledge-base-with-olostep/">
    使用 Olostep 爬取文档网站，并将输出结构化为 AI 准备好的知识库。
  </Card>

  <Card title="Google Maps 潜在客户 → 决策者丰富" icon="map-location-dot" href="https://n8n.io/workflows/11086-scrape-business-leads-from-google-maps-and-extract-decision-maker-info-with-olostep/">
    从 Google Maps 抓取商业潜在客户，并用决策者详细信息丰富它们。
  </Card>

  <Card title="挖掘用户投诉 → 洞察报告" icon="chart-line" href="https://www.n8n.io/workflows/13435-mine-user-complaints-and-generate-insight-reports-with-olostep-gemini-and-google-docs/">
    使用 Olostep + Gemini 分析投诉，并在 Google Docs 中生成结构化的洞察报告。
  </Card>

  <Card title="Amazon 产品提取 → Google Sheets" icon="table" href="https://n8n.io/workflows/11158-extract-amazon-product-data-to-sheets-with-olostep-api/">
    使用 Olostep 提取 Amazon 产品 URL 和元数据，然后将结果同步到 Sheets。
  </Card>
</CardGroup>

[在 n8n.io 上浏览所有 Olostep 工作流 →](https://n8n.io/workflows/?q=olostep)

***

## 解析器

在任何抓取或批量操作的 **Parser** 字段中添加解析器 ID，以获取结构化数据而不是原始内容：

| 解析器                          | 提取内容                        |
| ---------------------------- | --------------------------- |
| `@olostep/amazon-product`    | 标题、价格、评分、评论、图片、变体           |
| `@olostep/google-search`     | 结果标题、URL、摘要                 |
| `@olostep/google-maps`       | 商业名称、地址、评分、评论               |
| `@olostep/extract-emails`    | 从任何页面提取电子邮件地址               |
| `@olostep/extract-socials`   | 社交资料链接（X、GitHub、LinkedIn 等） |
| `@olostep/extract-calendars` | Google Calendar 和 ICS 链接    |

在 [Olostep 解析器商店 →](https://www.olostep.com/store) 查看完整列表

***

## 故障排除

<AccordionGroup>
  <Accordion title="API 密钥被拒绝">
    直接从 [olostep.com/dashboard](https://olostep.com/dashboard) 复制密钥，确保没有尾随空格。如果错误仍然存在，请在 n8n 中删除并重新创建凭证。
  </Accordion>

  <Accordion title="抓取的内容为空">
    增加 **抓取前等待**（对于 JS 密集页面，尝试 2000–5000ms）。确认 URL 可以在不登录的情况下公开访问。如果某个特定域名持续失败，请联系 [info@olostep.com](mailto:info@olostep.com)。
  </Accordion>

  <Accordion title="批量 URL 格式错误">
    **要抓取的 URL** 字段需要一个 JSON 数组：

    ```json theme={null}
    [
      { "url": "https://example.com/page-1", "custom_id": "p1" },
      { "url": "https://example.com/page-2", "custom_id": "p2" }
    ]
    ```

    如果需要，可以在上游使用代码节点从你的数据构建此数组。
  </Accordion>

  <Accordion title="达到速率限制">
    在抓取步骤之间添加一个 **等待** 节点，或者改用 **批量抓取 URL** 而不是循环单个抓取。在 [仪表板](https://olostep.com/dashboard) 中查看当前使用情况。
  </Accordion>

  <Accordion title="设置中看不到社区节点">
    在 n8n Cloud 上，社区节点必须由工作空间所有者启用。在自托管中，确保环境中设置了 `N8N_COMMUNITY_PACKAGES_ENABLED=true`。请参阅 [n8n 的安装指南](https://docs.n8n.io/integrations/community-nodes/installation/)。
  </Accordion>
</AccordionGroup>

***

## 相关

<CardGroup cols={2}>
  <Card title="抓取 API" icon="file-lines" href="/features/scrapes">
    抓取端点的完整参考
  </Card>

  <Card title="批量 API" icon="layer-group" href="/features/batches">
    批量作业的工作原理及如何检索结果
  </Card>

  <Card title="爬取 API" icon="spider-web" href="/features/crawls">
    爬取配置和结果检索
  </Card>

  <Card title="地图 API" icon="map" href="/features/maps">
    URL 发现和过滤选项
  </Card>
</CardGroup>

## 开始使用

准备好自动化你的网页搜索、抓取和爬取工作流了吗？

<CardGroup cols={2}>
  <Card title="n8n 网站" icon="link" href="https://n8n.io">
    n8n 平台
  </Card>

  <Card title="安装节点" icon="workflow" href="https://www.npmjs.com/package/n8n-nodes-olostep">
    安装 n8n-nodes-olostep 并开始构建自动化工作流
  </Card>
</CardGroup>

立即连接 Olostep 与 n8n，自动化你的网页数据提取！