> ## 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 + Raycast 集成

> 使用官方 Olostep MCP 服务器为 Raycast AI 添加网页抓取、搜索、爬虫和 AI 答案功能

Raycast 是开发者、运营人员和 AI 高级用户使用的生产力启动器。借助 Raycast 对模型上下文协议（MCP）的原生支持，**官方 Olostep MCP 服务器**直接集成到 Raycast AI 中——只需简单地提到 `@olostep`，即可在 AI 聊天、快速 AI 和 AI 命令中调用实时网页数据工具。

Olostep 是 [Raycast 的 MCP 注册表](https://www.raycast.com/)中的官方条目，因此你只需点击几下即可添加它——无需编辑配置文件。

## 功能

Olostep MCP 服务器为你的 Raycast AI 提供 Olostep 的核心网页数据功能：

<CardGroup cols={2}>
  <Card title="抓取网站" icon="file-lines">
    从任何单一 URL 提取内容为 Markdown、HTML、JSON 或文本——支持 JavaScript 渲染和国家定位。
  </Card>

  <Card title="搜索网页" icon="magnifying-glass">
    进行网页搜索并获取结构化、基于解析器的结果（标题、URL、摘要）。
  </Card>

  <Card title="答案 (AI)" icon="sparkles">
    提出自然语言问题，并获得基于网页的答案，附带引用来源和可选的结构化输出。
  </Card>

  <Card title="批量抓取 URL" icon="layer-group">
    在单个并行作业中处理最多 10,000 个 URL——非常适合大规模提取。
  </Card>

  <Card title="爬取网站" icon="spider-web">
    从一个 URL 开始，跟随链接，自动抓取整个网站或部分内容。
  </Card>

  <Card title="映射网站 URL" icon="map">
    在不抓取内容的情况下发现网站上的每个 URL——非常适合规划爬虫或批量作业。
  </Card>
</CardGroup>

## 开始之前

* **一个 Olostep API 密钥：** [免费获取一个](https://olostep.com/dashboard/api-keys)，无需信用卡。你将获得前 500 个积分。
* **安装 Raycast**，并在你的计划中启用 [Raycast AI](https://manual.raycast.com/ai)。MCP 工具通过 Raycast AI（AI 聊天、快速 AI 和 AI 命令）运行。

<Note>
  Olostep 支持两种连接模式。**托管端点** (`https://mcp.olostep.com/mcp`) 使用 `Authorization: Bearer YOUR_API_KEY` 头。**本地 stdio** 选项 (`npx -y olostep-mcp`) 使用 `OLOSTEP_API_KEY` 作为环境变量。选择一种——混合两种认证模式是最常见的设置错误。
</Note>

## 安装

<Steps>
  <Step title="获取你的 API 密钥">
    从 [Olostep 仪表板](https://olostep.com/dashboard/api-keys)复制你的密钥。你将在下一步中将其粘贴到 Raycast 中。
  </Step>

  <Step title="在 Raycast 中安装 Olostep（推荐）">
    因为 Olostep 是 Raycast 的 MCP 注册表中的官方条目，最快的方法是单击：

    1. 从 Raycast 商店安装 **模型上下文协议注册表** 扩展（搜索 "MCP" 或 "模型上下文协议"）。
    2. 运行 **搜索服务器** 命令，搜索 **Olostep**，并选择它。
    3. 选择 **安装**，然后在提示时输入你的 Olostep API 密钥。

    Raycast 保存配置，启动连接，并自动加载工具。
  </Step>

  <Step title="或者手动添加">
    想自己设置？打开 Raycast，运行 **安装 MCP 服务器**（或 **管理 MCP 服务器 → 安装新服务器**），并填写以下值：

    * **名称：** `olostep`
    * **传输：** HTTP
    * **URL：** `https://mcp.olostep.com/mcp`
    * **HTTP 头：** `Authorization` → `Bearer YOUR_API_KEY`

    按下 **安装 MCP 服务器** (`⌘` / `Ctrl` + `↵`)。

    <Accordion title="更喜欢本地安装？（stdio）">
      选择 **标准输入/输出** 作为传输方式，并使用：

      * **命令：** `npx`
      * **参数：** `-y olostep-mcp`
      * **环境：** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      需要在你的机器上安装 Node.js 18+。如果命令依赖于你的 `PATH` 中的某些内容，请在更新环境变量后重新启动 Raycast，以便获取新值。
    </Accordion>
  </Step>

  <Step title="验证并开始使用">
    打开 **管理 MCP 服务器** 命令——`olostep` 应显示为 **运行中**，并具有其 **10 个工具**。然后，在 AI 聊天或快速 AI 中，输入 `@olostep` 来限定请求范围：

    ```txt theme={null}
    @olostep 查找这三个竞争对手页面上的最新定价并总结
    ```
  </Step>
</Steps>

## 可用工具

在 Raycast 中，你可以用自然语言调用工具——`@` 提到 `olostep`，描述你想要的内容，Raycast AI 会选择合适的工具。以下示例展示了典型的提示。

### scrape\_website

从单个 URL 提取内容为 Markdown、HTML、JSON 或文本。处理 JavaScript 渲染的页面，并支持国家定位和专业解析器。

```txt theme={null}
@olostep 抓取 https://example.com/pricing 并给我干净的 markdown
```

### search\_web

进行网页搜索并返回查询的结构化结果。

```txt theme={null}
@olostep 搜索关于欧盟 AI 法规的最新新闻
```

### answers

获取基于真实网页数据生成的 AI 答案，并附带引用来源。请求特定格式以获得结构化输出。

```txt theme={null}
@olostep 什么是 Notion 的技术文档的前 5 名竞争对手？返回名称、主页和一行描述，并附来源。
```

### batch\_scrape\_urls

在一个并行作业中抓取已知的 URL 列表（最多 10,000 个）。异步运行，并返回一个作业，你可以在完成后检索。

```txt theme={null}
@olostep 抓取这 200 个产品 URL，并以 JSON 格式返回每个的标题和价格
```

### create\_crawl

从一个 URL 开始，跟随其链接，并在整个网站或部分内容中抓取匹配的页面。异步运行。

```txt theme={null}
@olostep 爬取 https://docs.stripe.com 下的 /docs 并将每个部分总结为 markdown
```

### create\_map

列出网站上的每个 URL 而不抓取内容——在爬虫或批量作业前用于发现。

```txt theme={null}
@olostep 映射 https://example.com/blog 下的所有 URL
```

<Note>
  **批量和爬虫是异步运行的。** 每个启动一个作业并返回一个 ID，Raycast 使用其配套工具（`get_batch_results`，`get_crawl_results`）检索。与 `get_webpage_content` 和 `get_website_urls` 一起，服务器总共提供 **10 个工具**。查看 [Olostep MCP 服务器参考](/integrations/mcp-server) 以获取完整列表和参数。
</Note>

## 示例工作流

### 快速竞争对手研究

从 AI 聊天中，在一个提示中收集和综合网页数据：

```txt theme={null}
@olostep 搜索 2026 年的顶级项目管理工具，然后使用答案总结提到最多的 3 个工具及其定价和每个的来源。
```

### 将页面转换为干净的笔记

```txt theme={null}
@olostep 抓取 https://example.com/blog/post 并给我一个 5 点总结加上关键引用。
```

### 将其保存为可重用的 AI 命令

一旦 Olostep 连接，你可以将提示嵌入到一个一键 [AI 命令](https://manual.raycast.com/ai) 中。例如，创建一个名为 **"总结 URL"** 的命令，指令为：

```txt theme={null}
使用 @olostep，抓取 {argument} 为 markdown 并返回一个 3 段的总结，涵盖页面内容、关键细节和任何定价。
```

现在你可以在 Raycast 中的任何地方运行它，并获得即时总结。

## 故障排除

<AccordionGroup>
  <Accordion title="服务器显示为运行中但列出 0 个工具">
    你的 API 密钥无效或已达到速率限制。在 [Olostep 仪表板](https://olostep.com/dashboard/api-keys)中验证它。对于托管端点，头必须正好是 `Authorization: Bearer YOUR_API_KEY`——值周围没有引号，也没有额外的空格。
  </Accordion>

  <Accordion title="安装后 Olostep 未出现">
    打开 **管理 MCP 服务器** 并检查服务器状态。如果处于 **错误** 状态，详细信息窗格会显示来自服务器或传输的完整输出。重新检查 URL/头（HTTP）或命令/环境（stdio），然后使用 **重启** 操作。
  </Accordion>

  <Accordion title="本地（stdio）安装无法启动">
    确保已安装 Node.js 18+ 并在你的 `PATH` 中。安装或更改环境变量后，完全重启 Raycast 以便获取新值。在 Windows 上，确保 `npx` 在 Raycast 启动的 shell 中解析。
  </Accordion>

  <Accordion title="托管端点无法连接">
    确认 `https://mcp.olostep.com/mcp` 可从你的网络访问（企业代理和防火墙可能会阻止它）。如果被阻止，切换到本地 stdio 安装，它连接到 `api.olostep.com`。
  </Accordion>

  <Accordion title="工具未在响应中使用">
    确保你在消息中 `@` 提到 `olostep`（在 AI 聊天或快速 AI 中），并且请求明确需要网页数据。你可以通过输入 `@` 并选择服务器来限定问题范围。
  </Accordion>
</AccordionGroup>

## 了解更多

<CardGroup cols={2}>
  <Card title="Raycast" icon="link" href="https://www.raycast.com">
    Raycast 启动器
  </Card>

  <Card title="Raycast MCP 手册" icon="book" href="https://manual.raycast.com/ai/model-context-protocol">
    Raycast 如何连接和管理 MCP 服务器
  </Card>

  <Card title="Olostep MCP 服务器" icon="server" href="/integrations/mcp-server">
    完整的 MCP 设置、工具参考和参数
  </Card>

  <Card title="MCP 服务器仓库" icon="github" href="https://github.com/olostep/olostep-mcp-server">
    源代码、问题和发布说明
  </Card>
</CardGroup>

## 相关

<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>

## 开始使用

准备好将实时网页数据引入 Raycast？

<CardGroup cols={2}>
  <Card title="获取免费 API 密钥" icon="key" href="https://olostep.com/dashboard/api-keys">
    注册并获取你的 Olostep API 密钥——包括 500 积分
  </Card>

  <Card title="浏览 Raycast MCP 服务器" icon="store" href="https://www.raycast.com">
    在 Raycast MCP 注册表中找到 Olostep 和其他服务器
  </Card>
</CardGroup>

将 Olostep 与 Raycast 连接，只需一个 `@olostep` 提到即可进行网页抓取、搜索和爬虫。