メインコンテンツへスキップ
Olostep MCPサーバーは、MCP互換のAIクライアント(Claude、Cursor、Windsurf、VS Code、Claude Codeなど)に、ライブウェブ用の10個のすぐに使えるツールを提供します。これには、スクレイピング、検索、引用付きAI回答、バッチジョブ、サイトクロール、URL発見が含まれます。

スクレイプ&抽出

任意のURLからMarkdown、HTML、JSON、またはテキストをオプションのJSレンダリングと共に取得

AI回答

ソースと構造化された出力を伴うウェブに基づいた回答

バッチ&クロール

最大10万のURLを並行して処理、または自律的にサイト全体を発見

マップ&検索

サイト上のすべてのURLを見つけるか、パーサーベースのウェブ検索を実行

始める前に

Olostep APIキーが必要です。Olostepダッシュボードから取得できます。無料プランは個人利用をカバーしています。

セットアップパスを選ぶ

すべてのクライアントにとって最速のパスは、https://mcp.olostep.com/mcpのホステッドエンドポイントです。インストール不要、Node不要、Docker不要—URLとAPIキーを貼り付けるだけです。 完全にローカルで実行する必要がある場合(オフライン利用、企業プロキシ、エアギャップ)、すべてのクライアントはnpxを介したローカルstdioインストールもサポートしています。以下の各セクションで両方を示しています。
ホステッドエンドポイントはAuthorization: Bearer <YOUR_API_KEY>を使用します。ローカルstdioは環境変数としてOLOSTEP_API_KEYを使用します。混同しないでください—誤った認証モードはオンボーディングエラーの第1位です。

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

ワンクリックインストール(推奨):CursorにOlostep MCPサーバーを追加結果の設定で<YOUR_API_KEY>を実際のキーに置き換えてください。手動セットアップ:プロジェクトルートに.cursor/mcp.jsonを作成または編集します(グローバルには~/.cursor/mcp.json):
マシンにNode.js 18+が必要です。
確認: Cursorを開く → 設定 → MCP。olostepがscrape_websiteを含む8つのツールと共にリストされているはずです。「接続済み、0ツール」と表示された場合、APIキーが間違っています。

適切なツールの選択

MCPサーバーは8つのツールを公開しています。この意思決定ツリーを使用して適切なツールを選択してください—エージェントも同じ理由付けを使用します:
サイト全体をスクレイプしますか? create_crawlを使用し、batch_scrape_urlsではありません。クロールは発見とスクレイプを行います。バッチは既に持っている既知のURLリスト用です。

ツールの詳細

単一のURLからコンテンツを抽出します。markdown、html、json、textをサポートします。地理的ターゲットリクエスト用のオプションのcountry、JSが多いサイト用のwait_before_scraping(0–10000 ms)、構造化抽出用のparser(例: @olostep/amazon-product)をサポートします。ページコンテンツはmax_characters(デフォルト20,000)で制限され、長いページはカットされ、結果にその旨が表示されます。
まだURLがない場合のウェブ検索。最大limit(1–25、デフォルト10)結果を返し、それぞれにURL、タイトル、説明が含まれます。include_domains / exclude_domainsを使用して検索範囲を設定します。scrape_results: trueを設定すると、同じ呼び出しで各結果ページのコンテンツをMarkdownとして取得できます(max_charactersで制限、デフォルト20,000; 各スクレイプされたページは追加クレジットを使用します)。
ソースと引用を伴うtaskへのAI駆動の回答。特定の形状で回答を取得するためにjson引数を渡します—JSONスキーマまたは短い自然言語の説明のいずれか。
既に持っている2–100kのURLの非同期スクレイプ。batch_idを返し、その後get_batch_resultsを呼び出してコンテンツを取得します。ポーリングの代わりに単一のブロッキング呼び出しを希望する場合は、wait_for_completion_seconds(最大900)を設定します。推奨: 50 URL未満のバッチには60、50–1kには300–600、より大きなバッチには0(別途ポーリング)を設定します。
batch_idのステータスとスクレイプされたコンテンツを取得します。完了するまでprocessingを返し、その後completedとアイテム配列を返します。
start_urlからリンクをたどる非同期クロール。include_url_patterns / exclude_url_patterns(/blog/**のようなグロブ構文)を使用してスコープを設定します。crawl_idを返し、その後get_crawl_resultsを呼び出します。
crawl_idのステータスとページを取得します。cursorとitems_limit(最大100/呼び出し)を使用してページネーションをサポートします。完了するまでin_progressを返します。
サイト上のURLリストを取得します。URL発見のみ—スクレイプしません。候補URLを表示したい場合に使用します(例: ユーザーにサブセットを選ばせる)。include_url_patterns / exclude_url_patternsとsearch_queryをサポートします。

トラブルシューティング

APIキーが無効またはレート制限されています。APIキーのダッシュボードを開いてキーを確認してください。ホステッドエンドポイントを使用している場合、ヘッダーは正確にAuthorization: Bearer sk_...でなければなりません—値の周りに引用符はなく、余分なスペースもありません。
Node.jsがインストールされていない(またはPATHにない)可能性があります。nodejs.orgからNode 18+をインストールし、その後ターミナルとMCPクライアントを再起動します。Windowsでは、NodeがPATHにあるCMD/PowerShellに切り替えます。
企業プロキシまたはファイアウォールがホストをブロックしている可能性があります。ローカルstdioインストール(npx -y olostep-mcp)に切り替えます—これは通常許可されているapi.olostep.comへのアウトバウンドリクエストを行います。
クライアントが古い設定をキャッシュしています。完全に終了して再起動します—ウィンドウを閉じるだけでは不十分です。特にClaude Desktopはメニューバー/システムトレイで実行され続けます。
Windowsでサーバーを起動する際にnpxがエラーを出す場合、CMDラップされた形式を使用します:
認証ヘッダーなしでホステッドエンドポイントにアクセスした(または誤った形式で)。クライアント設定にセットアップタブで示されている通りにヘッダーを追加します。

レシピ

ツールと共にうまく機能するプロンプトをコピー&ペースト:

ソースとバージョン