Docker Hub npm version License: ISC
Olostepと統合し、ウェブスクレイピング、コンテンツ抽出、検索機能を提供するModel Context Protocol (MCP) サーバーの実装です。 Olostep MCPサーバーをセットアップするには、APIキーが必要です。OlostepウェブサイトでサインアップしてAPIキーを取得してください。
HTML、Markdown、JSON、またはプレーンテキスト（オプションのパーサー付き）でのウェブサイトコンテンツのスクレイピング
構造化された結果を返すパーサーベースのウェブ検索
引用元とオプションのJSON形式出力を備えたAI回答
最大10,000件のURLの一括スクレイピング
開始URLからの自律的なサイトクロール
ウェブサイトのURL発見とマッピング（含める/除外するフィルター付き）
地域限定コンテンツ向けの国別リクエストルーティング
JavaScriptを多用するウェブサイト向けの構成可能な待機時間
包括的なエラーハンドリングとレポート
シンプルなAPIキー設定
Related MCP server: Parallel Task MCP
Olostep MCPサーバーに接続する方法は複数あります。ワークフローに最適なものを選んでください。
最も簡単な方法です。ローカルへのインストールは不要です。ホストされているMCPサーバーに直接接続します：
https://mcp.olostep.com/mcp認証は、Olostep APIキーを使用したAuthorizationヘッダーのBearerトークンによって行われます。設定例については、以下のクライアントセットアップセクションを参照してください。
公式Dockerイメージをプルして実行します：
docker pull olostep/mcp-server
docker run -i --rm \
-e OLOSTEP_API_KEY="your-api-key" \
olostep/mcp-serverソースから自分でイメージをビルドしたい場合：
git clone https://github.com/olostep/olostep-mcp-server.git
cd olostep-mcp-server
npm install
npm run build
docker build -t olostep/mcp-server:local .
docker run -i --rm -e OLOSTEP_API_KEY="your-api-key" olostep/mcp-server:localnpxを使用してインストールなしで実行します：
env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcpWindows (PowerShell) の場合：
$env:OLOSTEP_API_KEY = "your-api-key"; npx -y olostep-mcpWindows (CMD) の場合：
set OLOSTEP_API_KEY=your-api-key && npx -y olostep-mcpまたはグローバルにインストールします：
npm install -g olostep-mcp最も簡単な方法はリモートエンドポイントを使用することです。プロジェクトルートに.cursor/mcp.jsonを作成または編集します：
{
"mcpServers": {
"olostep": {
"url": "https://mcp.olostep.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}代替案（ローカル）: Cursorの設定 > 機能 > MCPサーバーに移動し、「+ Add New MCP Server」をクリックします：
名前: olostep
タイプ: command
コマンド: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp
claude_desktop_config.jsonに以下を追加します：
{
"mcpServers": {
"mcp-server-olostep": {
"command": "npx",
"args": ["-y", "olostep-mcp"],
"env": {
"OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}代替案（Docker）:
{
"mcpServers": {
"olostep": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "OLOSTEP_API_KEY=YOUR_API_KEY_HERE",
"olostep/mcp-server"
]
}
}
}または、デバイスのターミナルでSmithery CLIを使用してインストールします：
npx -y @smithery/cli install @olostep/olostep-mcp-server --client claudeClaude CodeのMCP設定にリモートエンドポイントを追加します：
{
"mcpServers": {
"olostep": {
"url": "https://mcp.olostep.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}代替案（ローカル）:
{
"mcpServers": {
"olostep": {
"command": "npx",
"args": ["-y", "olostep-mcp"],
"env": {
"OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}./codeium/windsurf/model_config.jsonに以下を追加します：
{
"mcpServers": {
"olostep": {
"serverUrl": "https://mcp.olostep.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}代替案（ローカル）:
{
"mcpServers": {
"mcp-server-olostep": {
"command": "npx",
"args": ["-y", "olostep-mcp"],
"env": {
"OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}.vscode/mcp.jsonに以下を追加します：
{
"servers": {
"olostep": {
"type": "http",
"url": "https://mcp.olostep.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}代替案（ローカル）:
{
"servers": {
"olostep": {
"type": "stdio",
"command": "npx",
"args": ["-y", "olostep-mcp"],
"env": {
"OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}オプション1: ワンクリックインストール（推奨）
Metorialダッシュボードを開く
MCPサーバーディレクトリに移動
「Olostep」を検索
「Install」をクリックしてAPIキーを入力
オプション2: 手動設定
Metorial MCPサーバー設定に以下を追加します：
{
"olostep": {
"command": "npx",
"args": ["-y", "olostep-mcp"],
"env": {
"OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}これで、Metorial AIチャットでOlostepツールが利用可能になります。
OLOSTEP_API_KEY: Olostep APIキー（必須）
ORBIT_KEY: リクエストのルーティングにOrbitを使用するためのオプションキー。
scrape_website)単一のURLからコンテンツを抽出します。複数のフォーマットとJavaScriptレンダリングをサポートしています。
{
"name": "scrape_website",
"arguments": {
"url_to_scrape": "https://example.com",
"output_format": "markdown",
"country": "US",
"wait_before_scraping": 1000,
"parser": "@olostep/amazon-product"
}
}url_to_scrape: スクレイピングしたいウェブサイトのURL（必須）
output_format: フォーマットを選択 (html, markdown, json, または text) - デフォルト: markdown
country: 地域限定スクレイピング用の国コード（例: US, GB, CA）（オプション）
wait_before_scraping: スクレイピング前の待機時間（ミリ秒、0-10000）（オプション）
parser: 特殊な抽出のためのパーサーID（オプション）
{
"content": [
{
"type": "text",
"text": "{\n \"id\": \"scrp_...\",\n \"url\": \"https://example.com\",\n \"markdown_content\": \"# ...\",\n \"html_content\": null,\n \"json_content\": null,\n \"text_content\": null,\n \"status\": \"succeeded\",\n \"timestamp\": \"2025-11-14T12:34:56Z\",\n \"screenshot_hosted_url\": null,\n \"page_metadata\": { }\n}"
}
]
}search_web)指定されたクエリでウェブを検索し、構造化された結果（AIではなくパーサーベース）を取得します。
{
"name": "search_web",
"arguments": {
"query": "your search query",
"country": "US"
}
}query: 検索クエリ（必須）
country: ローカライズされた結果のための国コード（デフォルト: US）（オプション）
パーサーベースの結果を表す構造化JSON（テキストとして）
answers)ウェブを検索し、ソースと引用元を添えて、希望するJSON構造でAIによる回答を返します。
{
"name": "answers",
"arguments": {
"task": "Who are the top 5 competitors to Acme Inc. in the EU?",
"json": "Return a list of the top 5 competitors with name and homepage URL"
}
}task: ウェブデータを使用して回答する質問またはタスク（必須）
json: オプションのJSONスキーマ/オブジェクト、または希望する出力形式の短い説明
answer_id, object, task, result (JSONが提供された場合), sources, created
batch_scrape_urls)最大10,000件のURLを同時にスクレイピングします。大規模なデータ抽出に最適です。
{
"name": "batch_scrape_urls",
"arguments": {
"urls_to_scrape": [
{"url": "https://example.com/a", "custom_id": "a"},
{"url": "https://example.com/b", "custom_id": "b"}
],
"output_format": "markdown",
"country": "US",
"wait_before_scraping": 500,
"parser": "@olostep/amazon-product"
}
}batch_id, status, total_urls, created_at, formats, country, parser, urls
create_crawl)リンクをたどってウェブサイト全体を自律的に発見・スクレイピングする非同期クロールを開始します。crawl_idを返します。クロールはバックグラウンドで実行され、このレスポンスではコンテンツを返しません。その後、crawl_idを指定してget_crawl_resultsを呼び出し、ステータスのポーリングとスクレイピングされたページの取得を行う必要があります（batch_scrape_urls + get_batch_resultsと同じ2ステップパターン）。
{
"name": "create_crawl",
"arguments": {
"start_url": "https://example.com/docs",
"max_pages": 25,
"follow_links": true,
"output_format": "markdown",
"country": "US",
"parser": "@olostep/doc-parser"
}
}crawl_id, object, status, start_url, max_pages, follow_links, created, formats, country, parser
この呼び出しと
get_crawl_resultsをペアで使用してください。get_batch_resultsにcrawl_idを渡さないでください（クロールとバッチは別々のリソースです）。
create_map)ウェブサイト上のすべてのURLを取得します。発見と分析のためにすべてのURLを抽出します。
{
"name": "create_map",
"arguments": {
"website_url": "https://example.com",
"search_query": "blog",
"top_n": 200,
"include_url_patterns": ["/blog/**"],
"exclude_url_patterns": ["/admin/**"]
}
}map_id, object, url, total_urls, urls, search_query, top_n
get_webpage_content)JavaScriptレンダリングをサポートし、クリーンなMarkdown形式でウェブページコンテンツを取得します。
{
"name": "get_webpage_content",
"arguments": {
"url_to_scrape": "https://example.com",
"wait_before_scraping": 1000,
"country": "US"
}
}url_to_scrape: スクレイピングするウェブページのURL（必須）
wait_before_scraping: スクレイピング開始前に待機する時間（ミリ秒）（デフォルト: 0）
country: リクエストを送信する居住国（例: US, CA, GB）（オプション）
{
"content": [
{
"type": "text",
"text": "# Example Website\n\nThis is the markdown content of the webpage..."
}
]
}get_website_urls)ウェブサイトから関連するURLを検索・取得し、クエリへの関連度順に並べ替えます。
{
"name": "get_website_urls",
"arguments": {
"url": "https://example.com",
"search_query": "your search term"
}
}url: マッピングするウェブサイトのURL（必須）
search_query: URLを並べ替えるための検索クエリ（必須）
{
"content": [
{
"type": "text",
"text": "Found 42 URLs matching your query:\n\nhttps://example.com/page1\nhttps://example.com/page2\n..."
}
]
}get_batch_results)batch_idを使用して、以前に送信されたバッチスクレイピングジョブの結果を取得します。
{
"name": "get_batch_results",
"arguments": {
"batch_id": "batch_abc123"
}
}batch_id: batch_scrape_urlsから返されたバッチID（必須）
batch_id, status (processing または completed), total_urls, completed_urls, items (URLごとのスクレイピング結果の配列。url, custom_id, markdown_content, html_content, json_content, text_content, status, page_metadataを含む)
get_crawl_results)create_crawlで開始された非同期クロールのステータスとスクレイピングされたページを取得します。これはcreate_crawlに必須のコンパニオンツールです。create_crawlはジョブを開始してcrawl_idを返すだけです。このツールを使用して、発見されたページとそのコンテンツを実際に取得します。
{
"name": "get_crawl_results",
"arguments": {
"crawl_id": "crawl_abc123",
"formats": ["markdown"],
"items_limit": 20,
"cursor": 0
}
}crawl_id: create_crawlから返されたクロールID（必須）
formats: ページごとに取得するフォーマットの配列 — markdown, html, json, text (デフォルト: ["markdown"])
items_limit: コンテンツを取得する最大ページ数、1～100 (デフォルト: 20)
cursor: 発見されたページのリストへのページネーションカーソル (デフォルト: 0)
search_query: クエリへの関連度に基づいてページをランク付け/選択するためのオプションのフィルター
進行中: crawl_id, status (in_progress), pages_completed, pages_total, および約10秒後に再度呼び出すよう促すmessage。
完了時: crawl_id, status (completed), pages_returned, next_cursor, has_more, および各エントリにurl, custom_id, および要求されたコンテンツフィールド (markdown_content, html_content, json_content, text_content) を持つpages配列。
サーバーは堅牢なエラーハンドリングを提供します：
APIの問題に関する詳細なエラーメッセージ
ネットワークエラーのレポート
認証失敗のハンドリング
レート制限情報
エラーレスポンスの例:
{
"isError": true,
"content": [
{
"type": "text",
"text": "Olostep API Error: 401 Unauthorized. Details: {\"error\":\"Invalid API key\"}"
}
]
}MCPサーバーはDockerイメージとして利用可能です：
Docker Hub: [olostep/mcp-server](https://hub.docker.com/r/olostep/mcp-server)
公式Docker MCPレジストリ: mcp/olostep (近日公開 - 署名とSBOMによるセキュリティ強化)
GitHub Container Registry: ghcr.io/olostep/olostep-mcp-server
Olostep MCPサーバーはDocker Desktopの公式MCPツールキットに追加されており、ユーザーは以下のことが可能になります：
Docker DesktopのMCPツールキットUIでの発見
ワンクリックでのインストール
視覚的な設定
MCP互換クライアント（Claude Desktop、Cursorなど）での使用
ステータス: Docker MCPレジストリへの提出が進行中
linux/amd64
linux/arm64
# Clone the repository
git clone https://github.com/olostep/olostep-mcp-server.git
cd olostep-mcp-server
# Build the image
npm install
npm run build
docker build -t olostep/mcp-server .
# Run locally
docker run -i --rm -e OLOSTEP_API_KEY="your-key" olostep/mcp-serverISCライセンス
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Stealth scraping & search. Bypasses Cloudflare, DataDome & LinkedIn via Cyborg HITL approach.
Web search, page extraction and structured commerce, social and business data for AI agents
B2B and local lead gen: verified emails, site contacts, Maps and Yellow Pages leads.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/olostep/olostep-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
