Olostep MCP Server
2025.03.28
0
TypeScript网页抓取内容提取搜索功能搜索工具内容生成
Olostep MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现，与 Olostep 平台集成，专注于网页抓取、内容提取和搜索功能。它提供了多种工具来帮助用户从网页中提取结构化数据，支持多种配置选项和错误处理机制。
View on GitHub
Overview
基本能力
产品定位
Olostep MCP Server 是一个专注于网页内容提取和搜索的服务，旨在为用户提供高效、结构化的数据抓取和搜索功能。
核心功能
- 网页内容提取：支持从网页中提取内容，并以干净的 Markdown 格式返回。
- Google 搜索结果提取：提供结构化的 Google 搜索结果，包括标题、链接、摘要等。
- 网站 URL 发现与映射：能够搜索并返回与查询相关的网站 URL。
- 国家特定请求路由：支持按国家路由请求，获取地理定位内容。
- 可配置的等待时间：针对 JavaScript 密集型网站，支持配置等待时间。
- 全面的错误处理：提供详细的错误消息和报告。
- 简单的 API 密钥配置：通过环境变量轻松配置 API 密钥。
适用场景
- 数据抓取与分析：从网页中提取结构化数据用于分析。
- 搜索引擎优化 (SEO)：获取 Google 搜索结果以优化网站排名。
- 内容聚合：从多个来源提取内容并整合。
- 地理定位内容获取：根据用户地理位置获取特定内容。
工具列表
- Get Webpage Content (
get_webpage_content)： - 功能：从指定 URL 提取网页内容，支持 Markdown 格式和 JavaScript 渲染。
-
参数：
url_to_scrape（必填）、wait_before_scraping（可选）、country（可选）。 -
Get Website URLs (
get_website_urls)： - 功能：从指定网站搜索并返回相关 URL，按相关性排序。
-
参数：
url（必填）、search_query（必填）。 -
Google Search (
google_search)： - 功能：执行 Google 搜索并返回结构化结果。
- 参数：
query（必填）、country（可选）。
常见问题解答
- 如何获取 API 密钥？：需要在 Olostep 网站 注册并获取。
- 如何处理认证失败？：检查 API 密钥是否正确配置，错误消息会包含详细信息。
- 如何配置国家特定请求？：通过
country参数指定国家代码（如 "US"、"GB"）。
使用教程
使用依赖
- 需要安装 Node.js 和 npm。
- 需要从 Olostep 网站获取 API 密钥。
安装教程
- 通过 npx 运行：
bash env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp - 手动安装：
bash npm install -g olostep-mcp - 在 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" } } } } - 通过 Smithery CLI 安装：
bash npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude
调试方式
- 检查环境变量
OLOSTEP_API_KEY是否已正确设置。 - 运行服务后，可以通过工具调用测试功能是否正常。
- 查看错误日志以排查问题。
示例调试命令：
env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp