基本能力
产品定位
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
是否已正确设置。 - 运行服务后,可以通过工具调用测试功能是否正常。
- 查看错误日志以排查问题。
示例调试命令:
bash
env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp