Olostep

🚀 Olostep MCP Server

An implementation of the Model Context Protocol (MCP) server integrated with Olostep, designed for web crawling, content extraction, and search functionality.

To set up the Olostep MCP server, you need an API key. You can obtain an API key by registering on the Olostep website.

🚀 Quick Start

To use the Olostep MCP Server, first obtain an API key from the Olostep website. Then, follow the installation steps below.

✨ Features

• Extract web page content in clean Markdown format.
• Extract structured data from Google search results.
• Discover and map website URLs.
• Route requests based on country/region to obtain geographically targeted content.
• Configure waiting times for JavaScript-intensive websites.
• Provide comprehensive error handling and reporting.
• Support simple API key configuration.

📦 Installation

Run with npx

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

Manual Installation

npm install -g olostep-mcp

Run on Claude Desktop

Add the following to your claude_desktop_config.json:

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

Or run the following code more conveniently via the Smithery CLI:

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

Run on Windsurf

Add the following to your ./codeium/windsurf/model_config.json:

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

Run on Cursor

Configure Olostep MCP in Cursor:

1. Open Cursor settings.
2. Go to Features > MCP Server.
3. Click "+ Add New MCP Server".
4. Fill in the following information:
   • Name: "olostep-mcp" (or your preferred name).
   • Type: "command".
   • Command: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp.

📚 Documentation

The server provides a powerful error handling mechanism:

• Detailed API error messages.
• Network error reporting.
• Authentication failure handling.
• Rate limit information.

Example error response:

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

📄 License

This project is licensed under the ISC License.