Olostep

🚀 Olostep MCP サーバー

Olostep MCP サーバーは、Olostep と統合された Model Context Protocol (MCP) サーバーの実装です。このサーバーは、ウェブクローリング、コンテンツ抽出、および検索機能を提供します。

Olostep MCP サーバーを設定するには、API キーが必要です。API キーは、Olostep ウェブサイト で登録することで取得できます。

✨ 主な機能

• クリーンな Markdown 形式でウェブページのコンテンツを抽出する
• Google 検索結果から構造化データを抽出する
• ウェブサイトの URL を発見し、マッピングする
• 地理的なターゲットコンテンツを取得するために、国/地域別のリクエストをルーティングする
• JavaScript が多いウェブサイトに対応するため、待機時間を設定可能にする
• 包括的なエラー処理とレポート機能を提供する
• シンプルな API キーの設定方法を提供する

📦 インストール

npx を使用して実行する

env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

手動でインストールする

npm install -g olostep-mcp

Claude Desktop で実行する

以下の内容を claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

または、Smithery CLI を使用して以下のコマンドを実行することもできます。

npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

Windsurf で実行する

以下の内容を ./codeium/windsurf/model_config.json に追加します。

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor で実行する

Cursor で Olostep MCP を設定するには、以下の手順を実行します。

1. Cursor の設定を開く
2. 機能 > MCP サーバーに移動する
3. "+ 新しい MCP サーバーを追加" をクリックする
4. 以下の情報を入力する
   • 名前： "olostep-mcp"（または好きな名前）
   • タイプ： "command"
   • コマンド： env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

📚 ドキュメント

サーバーのエラー処理機能

サーバーは強力なエラー処理機構を備えています。

• 詳細な API エラーメッセージを提供する
• ネットワークエラーのレポートを行う
• 認証失敗の処理を行う
• レート制限の情報を提供する

エラーレスポンスの例：

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Olostep API Error: 401 Unauthorized. Details: {\"error\":\"Invalid API key\"}"
    }
  ]
}

📄 ライセンス

このプロジェクトは ISC ライセンスの下で提供されています。