Olostep MCP Server

Olostep MCP Server

site icon
2025.03.23 0
TypeScript网页抓取内容提取搜索功能搜索工具浏览器自动化
Olostep MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,与 Olostep 平台集成,提供网页抓取、内容提取和搜索功能。它支持从网页中提取内容并以干净的 Markdown 格式返回,同时提供谷歌搜索结果的结构化数据提取、网站 URL 发现和映射等功能。该服务适用于需要自动化网页内容提取、数据抓取和搜索集成的场景。
View on GitHub

Overview

基本能力

产品定位

Olostep MCP Server 是一个用于网页抓取、内容提取和搜索的服务,旨在为开发者提供高效的网页数据获取和处理能力。

核心功能

  • 网页内容提取,支持干净的 Markdown 格式化
  • 谷歌搜索结果的结构化数据提取
  • 网站 URL 发现和映射
  • 针对特定国家的内容请求路由
  • 可配置的等待时间,适用于 JavaScript 密集型网站
  • 全面的错误处理和报告
  • 简单的 API 密钥配置

适用场景

  • 自动化网页内容提取
  • 数据抓取和分析
  • 搜索引擎结果集成
  • 网站 URL 发现和映射

工具列表

  1. Get Webpage Content (get_webpage_content)
  2. 能力:以干净的 Markdown 格式检索网页内容,支持 JavaScript 渲染。
  3. 参数:url_to_scrape(必填)、wait_before_scraping(可选)、country(可选)。

  4. Get Website URLs (get_website_urls)

  5. 能力:从网站搜索并检索相关 URL,按查询相关性排序。
  6. 参数:url(必填)、search_query(必填)。

  7. Google Search (google_search)

  8. 能力:从谷歌搜索结果中检索结构化数据。
  9. 参数:query(必填)、country(可选)。

常见问题解答

  • 错误处理:服务提供详细的错误消息,包括 API 问题、网络错误、认证失败和速率限制信息。
  • API 密钥:需要有效的 Olostep API 密钥才能使用服务。

使用教程

使用依赖

  • 需要安装 Node.js 和 npm。
  • 需要有效的 Olostep API 密钥,可从 Olostep 网站 获取。

安装教程

  1. 使用 npx 运行 bash env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

  2. 手动安装 bash npm install -g olostep-mcp

  3. 在 Claude Desktop 上运行claude_desktop_config.json 中添加以下配置: json { "mcpServers": { "mcp-server-olostep": { "command": "npx", "args": ["-y", "olostep-mcp"], "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE" } } } }

  4. 使用 Smithery CLI 安装 bash npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

  5. 在 Windsurf 上运行./codeium/windsurf/model_config.json 中添加以下配置: json { "mcpServers": { "mcp-server-olostep": { "command": "npx", "args": ["-y", "olostep-mcp"], "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE" } } } }

  6. 在 Cursor 上配置

  7. 打开 Cursor 设置。
  8. 转到 Features > MCP Servers。
  9. 点击 "+ Add New MCP Server"。
  10. 输入名称、类型和命令: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

调试方式

  • 确保 OLOSTEP_API_KEY 环境变量已正确设置。
  • 检查服务是否正常运行,可以通过调用工具并查看响应来验证。
  • 查看错误响应以诊断问题。

配置

环境变量

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。