> ## 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 端点——一个 URL、整个网站、一个 URL 列表、网络搜索或一个研究过的答案。

从你拥有的东西和你想要的结果开始。每个端点都使用基础 URL `https://api.olostep.com` 和头部 `Authorization: Bearer <YOUR_API_KEY>`（参见[身份验证](https://docs.olostep.com/get-started/authentication.md)）。

## 根据目标

| 你有 | 你想要 | 使用 | 端点 | 同步或异步 |
| - | - | - | - | - |
| 一个 URL | 其内容为 Markdown、HTML、文本或 JSON | [Scrape](https://docs.olostep.com/features/scrapes.md) | `POST /v1/scrapes` | 同步 |
| 一个查询，没有 URL | 一个相关链接和片段的列表 | [Search](https://docs.olostep.com/features/search.md) | `POST /v1/searches` | 同步 |
| 一个问题 | 一个带有来源的研究答案 | [Answers](https://docs.olostep.com/features/answers.md) | `POST /v1/answers` | 同步 |
| 一个网站 | 网站上的每个 URL，没有内容 | [Map](https://docs.olostep.com/features/maps.md) | `POST /v1/maps` | 同步 |
| 一个网站 | 每个页面的内容（或一个过滤的子集） | [Crawl](https://docs.olostep.com/features/crawls.md) | `POST /v1/crawls` | 异步 |
| 一个已知 URL 的列表 | 所有这些的内容 | [Batch](https://docs.olostep.com/features/batches.md) | `POST /v1/batches` | 异步 |
| 一个会变化的页面 | 页面变化时的提醒 | [Monitor](https://docs.olostep.com/features/monitors.md) | `POST /v1/monitors` | 按计划运行 |
| 任何 API 调用 | 定时器上的相同调用 | [Schedule](https://docs.olostep.com/features/schedules.md) | `POST /v1/schedules` | 按计划运行 |
| 一个支持的网站（Google、LinkedIn、Amazon…） | 干净的结构化 JSON 字段 | [Parsers](https://docs.olostep.com/features/structured-content/parsers.md) | `parser` 选项在 scrapes 和 batches 上 | 与调用相同 |
| 任何页面 | 你描述的自定义 JSON 字段 | [LLM extraction](https://docs.olostep.com/features/structured-content/llm-extraction.md) | `llm_extract` 选项在 scrapes 上 | 与调用相同 |

## 常见决策

* **Scrape vs. Crawl：** 当你知道确切的 URL 时使用 scrape。当你想要从一个网站获取多个页面而不想自己列出它们时使用 crawl。
* **Map vs. Crawl：** map 仅返回 URL 并且速度快。先用它选择页面，然后只 scrape 或 batch 这些页面。
* **Crawl vs. Batch：** crawl 通过跟随链接发现页面。batch 接受你已有的 URL 列表，一次最多可达数千个。
* **Search vs. Answers：** search 返回链接供你（或你的代理）阅读。answers 为你阅读页面并返回带有引用的单一答案。
* **Parsers vs. LLM extraction：** 当网站有现成的解析器时使用解析器。它更快并且每次返回相同的字段。对于其他情况，使用 LLM extraction。

## 异步端点

Crawls 和 batches 在后台运行。每个都会立即返回一个 `id`。轮询 `GET /v1/crawls/{id}` 或 `GET /v1/batches/{id}` 直到 `status` 为 `completed`，然后获取结果。如果 `status` 为 `failed`，则停止轮询。crawl 仍然可以以 0 页结束为 `completed`（检查 `pages_count`），而 batch 可以以某些项目失败结束为 `completed`（用 `?status=failed` 列出它们）。每个功能页面显示完整流程。

## 调用 Olostep 的其他方式

* **AI 代理和编码工具：** [MCP 服务器](https://docs.olostep.com/integrations/mcp-server.md) 和 [代理技能](https://docs.olostep.com/features/skills.md) 直接为代理提供这些工具。
* **终端和脚本：** [Olostep CLI](https://docs.olostep.com/cli/overview.md) 包装每个端点并返回 JSON。
* **代码：** [Python 和 Node SDKs](https://docs.olostep.com/sdks/overview.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.