olostep-mcp

by olostep
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides structured data from Google search results through the google_search tool, including organic search results, knowledge graph data, and related questions

  • Supports waiting for JavaScript-heavy websites to render before scraping content, with configurable wait times

  • Retrieves webpage content in clean markdown format for easier consumption and formatting

Olostep MCP 服务器

一个模型上下文协议 (MCP) 服务器实现,与Olostep集成,提供网页抓取、内容提取和搜索功能。要设置 Olostep MCP 服务器,您需要一个 API 密钥。您可以在Olostep 网站上注册以获取 API 密钥。

特征

  • 使用干净的 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

在风帆冲浪中奔跑

将其添加到您的./codeium/windsurf/model_config.json

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

在光标上运行

要在 Cursor 中配置 Olostep MCP:

  1. 打开游标设置
  2. 前往“功能”>“MCP 服务器”
  3. 点击“+ 添加新的 MCP 服务器”
  4. 输入以下内容:
    • 名称:“olostep-mcp”(或您喜欢的名称)
    • 类型:“命令”
    • 命令: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

用您的 Olostep API 密钥替换your-api-key

配置

环境变量

  • OLOSTEP_API_KEY :您的 Olostep API 密钥(必需)

可用工具

1.获取网页内容( get_webpage_content

以干净的 markdown 格式检索网页内容,并支持 JavaScript 渲染。

{ "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 :加载请求的居住国家/地区(例如,美国、加拿大、英国)(可选)

回复:

{ "content": [ { "type": "text", "text": "# Example Website\n\nThis is the markdown content of the webpage..." } ] }

2. 获取网站 URL( 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..." } ] }

从 Google 搜索结果中检索结构化数据。

{ "name": "google_search", "arguments": { "query": "your search query", "country": "US" } }

参数:

  • query :要执行的搜索查询(必需)
  • country :本地化结果的国家代码(例如,美国、英国)(默认值:“US”)

响应包括:

  • 包含标题、链接和摘要的有机搜索结果
  • 知识图谱数据(可用时)
  • 相关问题(人们也问)
  • 相关搜索
  • 丰富的摘要和其他结构化数据

错误处理

服务器提供了强大的错误处理:

  • API 问题的详细错误消息
  • 网络错误报告
  • 身份验证失败处理
  • 速率限制信息

错误响应示例:

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

执照

ISC 许可证

ID: ur5ulf3b8e