> ## 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 MCPサーバー

> MCP互換のAIクライアントに、1分以内でウェブスクレイピング、検索、クロール、AI回答ツールを提供

Olostep MCPサーバーは、MCP互換のAIクライアント（Claude、Cursor、Windsurf、VS Code、Claude Codeなど）に、ライブウェブ用の10の即使用可能なツールを提供します。スクレイピング、検索、引用付きAI回答、バッチジョブ、サイトクロール、URL発見が含まれます。

<CardGroup cols={2}>
  <Card title="スクレイプ＆抽出" icon="file-lines">
    任意のURLからMarkdown、HTML、JSON、またはテキストを取得し、オプションでJSレンダリングを使用
  </Card>

  <Card title="AI回答" icon="sparkles">
    出典付きのウェブに基づいた回答と構造化された出力
  </Card>

  <Card title="バッチ＆クロール" icon="layer-group">
    最大10,000のURLを並列処理、または自動的にサイト全体を発見
  </Card>

  <Card title="マップ＆検索" icon="map">
    サイト上のすべてのURLを見つけるか、パーサーベースのウェブ検索を実行
  </Card>
</CardGroup>

## 始める前に

Olostep APIキーが必要です。[Olostepダッシュボード](https://www.olostep.com/dashboard/api-keys)から取得できます。無料プランは個人利用をカバーしています。

## セットアップパスを選ぶ

すべてのクライアントにとって最速のパスは、`https://mcp.olostep.com/mcp`での**ホストされたエンドポイント**です。インストール不要、Node不要、Docker不要—URLとAPIキーを貼り付けるだけです。

完全にローカルで実行する必要がある場合（オフライン利用、企業プロキシ、エアギャップ）、すべてのクライアントは`npx`を介した**ローカルstdio**インストールもサポートしています。以下の各セクションで両方を示します。

<Note>
  **ホストされたエンドポイント**は`Authorization: Bearer YOUR_API_KEY`を使用します。**ローカルstdio**は環境変数として`OLOSTEP_API_KEY`を使用します。混同しないでください—間違った認証モードはオンボーディングエラーの第1位です。
</Note>

## クライアントセットアップ

<Tabs>
  <Tab title="Cursor">
    **ワンクリックインストール（推奨）:**

    <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=olostep&config=eyJ1cmwiOiJodHRwczovL21jcC5vbG9zdGVwLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgWU9VUl9BUElfS0VZIn19">
      <img src="https://cursor.com/deeplink/mcp-install-dark.png" alt="CursorにOlostep MCPサーバーを追加" style={{ maxHeight: 32 }} />
    </a>

    結果の設定で`YOUR_API_KEY`を実際のキーに置き換えてください。

    **手動セットアップ:**

    プロジェクトのルート（またはグローバルには`~/.cursor/mcp.json`）に`.cursor/mcp.json`を作成または編集します。

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="ローカルstdioインストール（オプション）">
      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```

      マシンにNode.js 18+が必要です。
    </Accordion>

    **確認:** Cursorを開く → 設定 → MCP。`olostep`が`scrape_website`を含む**10ツール**でリストされているはずです。「接続済み、0ツール」と表示された場合、APIキーが間違っています。
  </Tab>

  <Tab title="Claude Code">
    **CLIインストール（推奨）:**

    ```bash theme={null}
    claude mcp add --transport http olostep https://mcp.olostep.com/mcp \
      --header "Authorization: Bearer YOUR_API_KEY"
    ```

    **手動セットアップ:**

    Claude Code MCP設定に追加します（プロジェクトルートの`.mcp.json`、またはグローバルには`~/.claude.json`）。

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="ローカルstdioインストール（オプション）">
      ```bash theme={null}
      claude mcp add --transport stdio --env OLOSTEP_API_KEY=YOUR_API_KEY olostep \
        -- npx -y olostep-mcp
      ```

      またはJSONとして：

      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```
    </Accordion>

    **確認:** Claude Codeで`/mcp`を実行します。`olostep`が10のツールで接続されているはずです。
  </Tab>

  <Tab title="Claude Desktop">
    **設定ファイルの場所:**

    | OS      | パス                                                                |
    | ------- | ----------------------------------------------------------------- |
    | macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
    | Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |
    | Linux   | `~/.config/Claude/claude_desktop_config.json`                     |

    **ホスト（推奨）:**

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="ローカルstdioインストール（オプション）">
      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```

      またはSmitheryを介してインストール：

      ```bash theme={null}
      npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude
      ```
    </Accordion>

    <Warning>
      Claude Desktopの設定変更を反映させるには、**完全に終了して再起動**する必要があります—ウィンドウを閉じるだけでは不十分です（メニューバー/システムトレイで実行中のままです）。
    </Warning>

    **確認:** Claude Desktopを開く → チャット入力で🔨（ハンマー）アイコンを探します。それをクリックすると、10のOlostepツールがリストされているはずです。
  </Tab>

  <Tab title="VS Code">
    VS CodeのMCPサポートはGitHub Copilot（エージェントモード）に組み込まれています。プロジェクトの`.vscode/mcp.json`またはユーザーの`settings.json`に以下を追加します：

    ```json theme={null}
    {
      "servers": {
        "olostep": {
          "type": "http",
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="ローカルstdioインストール（オプション）">
      ```json theme={null}
      {
        "servers": {
          "olostep": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```
    </Accordion>

    **確認:** Copilotチャットパネルを開く → エージェントモードに切り替える → ツールポップオーバーにOlostepツールがリストされているはずです。
  </Tab>

  <Tab title="Windsurf">
    `~/.codeium/windsurf/mcp_config.json`に追加します：

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "serverUrl": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="ローカルstdioインストール（オプション）">
      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```
    </Accordion>

    **確認:** Cascade → 設定 → MCP。`olostep`が10のツールで表示されるはずです。
  </Tab>

  <Tab title="Docker">
    サーバーをコンテナで実行したい場合（CI、隔離環境、ホストにNodeがない場合）：

    ```bash theme={null}
    docker pull olostep/mcp-server

    docker run -i --rm \
      -e OLOSTEP_API_KEY="YOUR_API_KEY" \
      olostep/mcp-server
    ```

    MCPクライアント設定（stdio）で：

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "command": "docker",
          "args": [
            "run", "-i", "--rm",
            "-e", "OLOSTEP_API_KEY=YOUR_API_KEY",
            "olostep/mcp-server"
          ]
        }
      }
    }
    ```

    `linux/amd64`と`linux/arm64`をサポートします。[GitHub](https://github.com/olostep/olostep-mcp-server)でソースを確認できます。
  </Tab>

  <Tab title="Metorial">
    1. [Metorialダッシュボード](https://metorial.com)を開く
    2. **MCPサーバー**に移動
    3. **Olostep**を検索
    4. **インストール**をクリックし、APIキーを貼り付ける

    手動設定の場合：

    ```json theme={null}
    {
      "olostep": {
        "command": "npx",
        "args": ["-y", "olostep-mcp"],
        "env": {
          "OLOSTEP_API_KEY": "YOUR_API_KEY"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## 適切なツールを選ぶ

MCPサーバーは10のツールを公開しています。この決定ツリーを使って適切なツールを選んでください—エージェントも同じ推論を使用します：

| あなたが望むもの...       | 使用するツール                                   | メモ                                       |
| ----------------- | ----------------------------------------- | ---------------------------------------- |
| 特定のページのコンテンツ      | `scrape_website`または`get_webpage_content`  | SPA用に`wait_before_scraping=2000–5000`を設定 |
| 出典付きの自然言語ウェブ回答    | `answers`                                 | AI合成+引用を返します                             |
| クエリの検索結果          | `search_web`                              | パーサーベース、非AI、構造化                          |
| サイト上のURLリスト       | `create_map`                              | URL発見のみ—スクレイプしません                        |
| クエリでフィルタリングされたURL | `get_website_urls`                        | `search_query`に関連する順にランク付け               |
| 一度に多くの既知のURL      | `batch_scrape_urls` + `get_batch_results` | 非同期—開始後にポーリング                            |
| サイト全体またはセクション     | `create_crawl` + `get_crawl_results`      | 非同期—開始URLからリンクをたどります                     |

<Tip>
  **サイト全体をスクレイピングしますか？** `create_crawl`を使用し、`batch_scrape_urls`ではありません。クロールは発見とスクレイピングを行います。バッチは既に持っている既知のURLリスト用です。
</Tip>

### ツールの詳細

<Accordion title="scrape_website">
  単一のURLからコンテンツを抽出します。`markdown`、`html`、`json`、`text`をサポート。地理ターゲットリクエスト用のオプションの`country`、JS重いサイト用の`wait_before_scraping`（0–10000 ms）、構造化抽出用の`parser`（例：`@olostep/amazon-product`）をサポート。
</Accordion>

<Accordion title="get_webpage_content">
  `scrape_website`の軽量なMarkdown専用バージョン。クリーンなMarkdownだけが欲しい場合に使用し、フォーマットオプションは不要です。
</Accordion>

<Accordion title="search_web">
  クエリのための構造化（パーサーベース）のウェブ検索結果。ローカライズされた結果のためのオプションの`country`。JSONを返し、AIの文章は返しません。
</Accordion>

<Accordion title="answers">
  出典と引用付きの`task`に対するAI駆動の回答。特定の形で回答を得るために`json`引数を渡します—JSONスキーマまたは短い自然言語の説明のいずれか。
</Accordion>

<Accordion title="batch_scrape_urls">
  既に持っている2–10kのURLの非同期スクレイプ。`batch_id`を返し、その後`get_batch_results`を呼び出してコンテンツを取得します。ポーリングの代わりに単一のブロッキングコールを希望する場合は、`wait_for_completion_seconds`（最大900）を設定します。推奨：50以下のURLのバッチには60、50–1kには300–600、より大きなバッチには0（別途ポーリング）。
</Accordion>

<Accordion title="get_batch_results">
  `batch_id`のステータスとスクレイプされたコンテンツを取得します。完了するまで`processing`を返し、その後`completed`とアイテム配列を返します。
</Accordion>

<Accordion title="create_crawl">
  `start_url`からリンクをたどる非同期クロール。スコープを設定するために`include_url_patterns` / `exclude_url_patterns`（`/blog/**`のようなグロブ構文）を使用します。`crawl_id`を返し、その後`get_crawl_results`を呼び出します。
</Accordion>

<Accordion title="get_crawl_results">
  `crawl_id`のステータスとページを取得します。`cursor`と`items_limit`（1回の呼び出しで最大100）を使用してページネーションをサポートします。完了するまで`in_progress`を返します。
</Accordion>

<Accordion title="create_map">
  サイト上のURLリストを取得します。URL発見のみ—スクレイプしません。候補URLを浮上させたい場合に使用します（例：ユーザーにサブセットを選ばせる）。`include_url_patterns` / `exclude_url_patterns`と`search_query`をサポート。
</Accordion>

<Accordion title="get_website_urls">
  `create_map`のように、ただしURLは必須の`search_query`に対する関連性でランク付けされます。サイト上のトップNの一致するリンクが欲しい場合に使用します。
</Accordion>

## トラブルシューティング

<Accordion title="サーバーは表示されるが0ツールと表示される">
  APIキーが無効またはレート制限されています。[APIキーのダッシュボード](https://www.olostep.com/dashboard/api-keys)を開いてキーを確認してください。ホストされたエンドポイントを使用している場合、ヘッダーは**正確に**`Authorization: Bearer sk_...`でなければなりません—値の周りに引用符はなく、余分なスペースもありません。
</Accordion>

<Accordion title="`npx: command not found`または`command not found: olostep-mcp`">
  Node.jsがインストールされていない（またはPATHにない）です。[nodejs.org](https://nodejs.org/)からNode 18+をインストールし、その後ターミナル**と**MCPクライアントを再起動します。Windowsでは、NodeがPATHにあるCMD/PowerShellに切り替えてください。
</Accordion>

<Accordion title="`mcp.olostep.com`で接続拒否またはDNSエラー">
  企業プロキシまたはホストをブロックするファイアウォールの背後にいる可能性があります。ローカルstdioインストール（`npx -y olostep-mcp`）に切り替えてください—通常許可されている`api.olostep.com`にアウトバウンドリクエストを行います。
</Accordion>

<Accordion title="設定を編集したがツールリストが古い">
  クライアントが古い設定をキャッシュしています。完全に終了して再起動してください—ウィンドウを閉じるだけでは不十分です。特にClaude Desktopはメニューバー/システムトレイで実行中のままです。
</Accordion>

<Accordion title="Windows特有の`npx`の失敗">
  Windowsでサーバーを起動する際に`npx`がエラーを出す場合、CMDラップされた形式を使用してください：

  ```json theme={null}
  {
    "command": "cmd",
    "args": ["/c", "npx", "-y", "olostep-mcp"],
    "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY" }
  }
  ```
</Accordion>

<Accordion title="`401 Missing Authorization: Bearer <OLOSTEP_API_KEY>`">
  認証ヘッダーなしでホストされたエンドポイントにアクセスした（または間違った形式で）。セットアップタブに示されている通りにクライアント設定にヘッダーを追加してください。
</Accordion>

## レシピ

ツールと一緒にうまく機能するプロンプトのコピーペースト：

* **製品URLのリストをスクレイプ:** *"200のAmazon製品URLのCSVがあります。`parser=@olostep/amazon-product`でバッチスクレイプし、JSONとして返してください。"*
* **ドキュメントサイトをクロール:** *"[https://stripe.com/docsを\`max\_pages=50\`と\`include\_url\_patterns=\['/docs/\*\*'\]\`でクロールしてください。各セクションをMarkdownとして要約してください。](https://stripe.com/docsを`max_pages=50`と`include_url_patterns=\['/docs/**']`でクロールしてください。各セクションをMarkdownとして要約してください。)"*
* **競合他社を見つける:** *"技術ドキュメントサイトのためにNotionのトップ5の競合他社を見つけるために`answers`を使用してください。名前、ホームページ、1行のポジショニングを返してください。"*
* **マップしてからスクレイプ:** *"[https://example.comで\`create\_map\`を実行し、\`/blog/\*\*\`にフィルタリングし、トップ20の結果で\`batch\_scrape\_urls\`を実行してください。](https://example.comで`create_map`を実行し、`/blog/**`にフィルタリングし、トップ20の結果で`batch_scrape_urls`を実行してください。)"*

## ソースとバージョン

* [GitHubリポジトリ](https://github.com/olostep/olostep-mcp-server)
* [npmパッケージ](https://www.npmjs.com/package/olostep-mcp)
* [Docker Hub](https://hub.docker.com/r/olostep/mcp-server)
* [MCPレジストリ](https://registry.modelcontextprotocol.io/)