スクレイプ&抽出
任意の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
- Claude Code
- Claude Desktop
- VS Code
- Windsurf
- Docker
- Metorial
適切なツールの選択
MCPサーバーは8つのツールを公開しています。この意思決定ツリーを使用して適切なツールを選択してください—エージェントも同じ理由付けを使用します:ツールの詳細
scrape_website
scrape_website
単一のURLからコンテンツを抽出します。
markdown、html、json、textをサポートします。地理的ターゲットリクエスト用のオプションのcountry、JSが多いサイト用のwait_before_scraping(0–10000 ms)、構造化抽出用のparser(例: @olostep/amazon-product)をサポートします。ページコンテンツはmax_characters(デフォルト20,000)で制限され、長いページはカットされ、結果にその旨が表示されます。search_web
search_web
まだURLがない場合のウェブ検索。最大
limit(1–25、デフォルト10)結果を返し、それぞれにURL、タイトル、説明が含まれます。include_domains / exclude_domainsを使用して検索範囲を設定します。scrape_results: trueを設定すると、同じ呼び出しで各結果ページのコンテンツをMarkdownとして取得できます(max_charactersで制限、デフォルト20,000; 各スクレイプされたページは追加クレジットを使用します)。answers
answers
ソースと引用を伴う
taskへのAI駆動の回答。特定の形状で回答を取得するためにjson引数を渡します—JSONスキーマまたは短い自然言語の説明のいずれか。batch_scrape_urls
batch_scrape_urls
既に持っている2–100kのURLの非同期スクレイプ。
batch_idを返し、その後get_batch_resultsを呼び出してコンテンツを取得します。ポーリングの代わりに単一のブロッキング呼び出しを希望する場合は、wait_for_completion_seconds(最大900)を設定します。推奨: 50 URL未満のバッチには60、50–1kには300–600、より大きなバッチには0(別途ポーリング)を設定します。get_batch_results
get_batch_results
batch_idのステータスとスクレイプされたコンテンツを取得します。完了するまでprocessingを返し、その後completedとアイテム配列を返します。create_crawl
create_crawl
start_urlからリンクをたどる非同期クロール。include_url_patterns / exclude_url_patterns(/blog/**のようなグロブ構文)を使用してスコープを設定します。crawl_idを返し、その後get_crawl_resultsを呼び出します。get_crawl_results
get_crawl_results
crawl_idのステータスとページを取得します。cursorとitems_limit(最大100/呼び出し)を使用してページネーションをサポートします。完了するまでin_progressを返します。create_map
create_map
サイト上のURLリストを取得します。URL発見のみ—スクレイプしません。候補URLを表示したい場合に使用します(例: ユーザーにサブセットを選ばせる)。
include_url_patterns / exclude_url_patternsとsearch_queryをサポートします。トラブルシューティング
サーバーが表示されるが0ツールと表示される
サーバーが表示されるが0ツールと表示される
APIキーが無効またはレート制限されています。APIキーのダッシュボードを開いてキーを確認してください。ホステッドエンドポイントを使用している場合、ヘッダーは正確に
Authorization: Bearer sk_...でなければなりません—値の周りに引用符はなく、余分なスペースもありません。npx: command not foundまたはcommand not found: olostep-mcp
npx: command not foundまたはcommand not found: olostep-mcp
Node.jsがインストールされていない(またはPATHにない)可能性があります。nodejs.orgからNode 18+をインストールし、その後ターミナルとMCPクライアントを再起動します。Windowsでは、NodeがPATHにあるCMD/PowerShellに切り替えます。
mcp.olostep.comで接続拒否またはDNSエラー
mcp.olostep.comで接続拒否またはDNSエラー
企業プロキシまたはファイアウォールがホストをブロックしている可能性があります。ローカルstdioインストール(
npx -y olostep-mcp)に切り替えます—これは通常許可されているapi.olostep.comへのアウトバウンドリクエストを行います。設定を編集したがツールリストが古い
設定を編集したがツールリストが古い
クライアントが古い設定をキャッシュしています。完全に終了して再起動します—ウィンドウを閉じるだけでは不十分です。特にClaude Desktopはメニューバー/システムトレイで実行され続けます。
Windows特有のnpxエラー
Windows特有のnpxエラー
Windowsでサーバーを起動する際に
npxがエラーを出す場合、CMDラップされた形式を使用します:レシピ
ツールと共にうまく機能するプロンプトをコピー&ペースト:- 製品URLのリストをスクレイプ: “200のAmazon製品URLのCSVがあります。
parser=@olostep/amazon-productを使用してバッチスクレイプし、JSONとして返します。” - ドキュメントサイトをクロール: “https://stripe.com/docsを`max_pages=50`と`include_url_patterns=[‘/docs/**’]`でクロールします。各セクションをMarkdownとして要約します。”
- 競合他社を見つける: “Notionの技術ドキュメントサイトのトップ5の競合他社を
answersで見つけます。名前、ホームページ、1行のポジショニングを返します。” - マップしてからスクレイプ: “https://example.comを`/blog/**`にフィルタリングして`create_map`を実行し、上位20の結果で`batch_scrape_urls`を実行します。“
