> ## 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エンドポイントを選択しましょう — 1つのURL、サイト全体、URLのリスト、ウェブ検索、または調査済みの回答。

持っているものと欲しいものから始めましょう。すべてのエンドポイントはベースURL `https://api.olostep.com` とヘッダー `Authorization: Bearer <YOUR_API_KEY>` を使用します（[認証](https://docs.olostep.com/get-started/authentication.md)を参照）。

## 目的別

| 持っているもの | 欲しいもの | 使用する | エンドポイント | 同期または非同期 |
| - | - | - | - | - |
| 1つの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) | scrapesとbatchesでの`parser`オプション | コールと同じ |
| 任意のページ | あなたが記述するカスタムJSONフィールド | [LLM extraction](https://docs.olostep.com/features/structured-content/llm-extraction.md) | scrapesでの`llm_extract`オプション | コールと同じ |

## よくある決定

* **Scrape vs. Crawl:** 正確なURLがわかっている場合はscrapeを使用。1つのサイトから多くのページを取得したいが、それらを自分でリストしたくない場合は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.