> ## 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 の Model Context Protocol (MCP) のネイティブサポートにより、**公式の Olostep MCP サーバー**が Raycast AI に直接接続されます。AI Chat、Quick AI、AI Commands から簡単な `@olostep` メンションで呼び出せるライブウェブデータツールを提供します。

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 Chat、Quick AI、AI Commands) を通じて実行されます。

<Note>
  Olostep は 2 つの接続モードをサポートしています。**ホストされたエンドポイント** (`https://mcp.olostep.com/mcp`) は `Authorization: Bearer YOUR_API_KEY` ヘッダーを使用します。**ローカル stdio** オプション (`npx -y olostep-mcp`) は `OLOSTEP_API_KEY` を環境変数として使用します。どちらかを選択してください。2 つの認証モードを混在させることは、最も一般的な設定ミスです。
</Note>

## インストール

<Steps>
  <Step title="API キーを取得">
    [Olostep ダッシュボード](https://olostep.com/dashboard/api-keys)からキーをコピーします。次のステップで Raycast に貼り付けます。
  </Step>

  <Step title="Raycast に Olostep をインストール (推奨)">
    Olostep は Raycast の MCP レジストリに公式エントリーとして登録されているため、最速の方法はワンクリックです：

    1. Raycast ストアから **Model Context Protocol Registry** 拡張機能をインストールします（「MCP」または「Model Context Protocol」で検索）。
    2. **Search Servers** コマンドを実行し、**Olostep** を検索して選択します。
    3. **Install** を選択し、プロンプトが表示されたら Olostep API キーを入力します。

    Raycast は設定を保存し、接続を開始し、ツールを自動的にロードします。
  </Step>

  <Step title="または手動で追加する">
    自分で設定したい場合は、Raycast を開き、**Install MCP Server**（または **Manage MCP Servers → Install New Server**）を実行し、次の値でフォームを記入します：

    * **Name:** `olostep`
    * **Transport:** HTTP
    * **URL:** `https://mcp.olostep.com/mcp`
    * **HTTP Header:** `Authorization` → `Bearer YOUR_API_KEY`

    **Install MCP Server** を押します（`⌘` / `Ctrl` + `↵`）。

    <Accordion title="ローカルインストールを好む？ (stdio)">
      代わりに **Standard Input/Output** をトランスポートとして選択し、次を使用します：

      * **Command:** `npx`
      * **Arguments:** `-y olostep-mcp`
      * **Environment:** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      マシンに Node.js 18+ が必要です。コマンドが `PATH` 上の何かに依存している場合、環境変数を更新した後に Raycast を再起動して、新しい値が反映されるようにします。
    </Accordion>
  </Step>

  <Step title="確認して使用を開始する">
    **Manage MCP Servers** コマンドを開きます — `olostep` が **Running** として表示され、**10 ツール**が利用可能であることを確認します。その後、AI Chat または Quick AI で `@olostep` と入力してリクエストをスコープします：

    ```txt theme={null}
    @olostep find the latest pricing on these three competitor pages and summarize it
    ```
  </Step>
</Steps>

## 利用可能なツール

Raycast では、自然言語でツールを呼び出します — `@` メンションで `olostep` を指定し、希望する内容を記述すると、Raycast AI が適切なツールを選択します。以下の例は典型的なプロンプトを示しています。

### scrape\_website

単一の URL からコンテンツを Markdown、HTML、JSON、またはテキストとして抽出します。JavaScript レンダリングされたページを処理し、国別ターゲティングと専門のパーサーをサポートします。

```txt theme={null}
@olostep scrape https://example.com/pricing and give me the clean markdown
```

### search\_web

ウェブ検索を実行し、クエリに対する構造化された結果を返します。

```txt theme={null}
@olostep search for the latest news on EU AI regulation
```

### answers

実際のウェブデータに基づいた AI 生成の回答を取得し、引用元付きで返します。特定の形式を要求して構造化された出力を得ることができます。

```txt theme={null}
@olostep what are the top 5 competitors to Notion for technical docs? Return name, homepage, and a one-line description, with sources.
```

### batch\_scrape\_urls

既知の URL リストを 1 つの並列ジョブでスクレイプします（最大 10,000 件）。非同期で実行され、完了後に取得するジョブを返します。

```txt theme={null}
@olostep scrape these 200 product URLs and return the title and price for each as JSON
```

### create\_crawl

URL から開始し、そのリンクをたどり、サイト全体またはセクションを横断して一致するページをスクレイプします。非同期で実行されます。

```txt theme={null}
@olostep crawl https://docs.stripe.com under /docs and summarize each section as markdown
```

### create\_map

コンテンツをスクレイプせずにサイト上のすべての URL をリストします — クロールやバッチジョブの前に発見するのに便利です。

```txt theme={null}
@olostep map all the URLs under https://example.com/blog
```

<Note>
  **バッチとクロールは非同期で実行されます。** それぞれがジョブを開始し、ID を返します。Raycast はその ID を使用してコンパニオンツール（`get_batch_results`、`get_crawl_results`）で取得します。`get_webpage_content` と `get_website_urls` と共に、サーバーは合計 **10 ツール** を公開しています。完全なリストとパラメータについては、[Olostep MCP サーバーリファレンス](/integrations/mcp-server)を参照してください。
</Note>

## 例のワークフロー

### 競合調査を迅速に行う

AI Chat から、1 つのプロンプトでウェブデータを収集し、統合します：

```txt theme={null}
@olostep search for the top project management tools in 2026, then use answers
to summarize the 3 most-mentioned ones with their pricing and a source for each.
```

### ページをクリーンなノートに変換する

```txt theme={null}
@olostep scrape https://example.com/blog/post and give me a 5-bullet summary
plus the key quotes.
```

### 再利用可能な AI コマンドとして保存する

Olostep が接続されたら、プロンプトをワンプレスの [AI Command](https://manual.raycast.com/ai) に組み込むことができます。たとえば、**"Summarize URL"** という名前のコマンドを作成し、次の指示を追加します：

```txt theme={null}
Using @olostep, scrape {argument} as markdown and return a 3-paragraph summary
covering what the page is about, the key details, and any pricing.
```

これで、Raycast のどこからでも URL を使用して実行し、瞬時に要約を取得できます。

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

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

  <Accordion title="インストール後に Olostep が表示されない">
    **Manage MCP Servers** を開いてサーバーのステータスを確認してください。**Error** 状態の場合、詳細ペインにサーバーまたはトランスポートからの完全な出力が表示されます。URL/ヘッダー (HTTP) またはコマンド/環境 (stdio) を再確認し、**Restart** アクションを使用してください。
  </Accordion>

  <Accordion title="ローカル (stdio) インストールが開始されない">
    Node.js 18+ がインストールされており、`PATH` にあることを確認してください。環境変数をインストールまたは変更した後、Raycast を完全に再起動して新しい値が反映されるようにします。Windows では、Raycast が起動するシェルで `npx` が解決されることを確認してください。
  </Accordion>

  <Accordion title="ホストされたエンドポイントが接続されない">
    `https://mcp.olostep.com/mcp` がネットワークから到達可能であることを確認してください（企業のプロキシやファイアウォールがブロックすることがあります）。ブロックされている場合は、代わりにローカル stdio インストールに切り替え、`api.olostep.com` に接続します。
  </Accordion>

  <Accordion title="ツールが応答で使用されない">
    メッセージ内で `@` メンションで `olostep` を指定し、リクエストが明確にウェブデータを要求していることを確認してください。`@` を入力してサーバーを選択することで、質問をサーバーにスコープできます。
  </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="Scrapes API" icon="file-lines" href="/features/scrapes">
    スクレイプエンドポイントの完全なリファレンス
  </Card>

  <Card title="Batches API" icon="layer-group" href="/features/batches">
    バッチジョブの動作と結果の取得方法
  </Card>

  <Card title="Crawls API" icon="spider-web" href="/features/crawls">
    クロールの設定と結果の取得
  </Card>

  <Card title="Maps 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` メンションで一瞬で実行しましょう。