用途
Crawleo-MCP 是 Crawleo 的模型上下文协议（MCP）服务器，为 AI 助手提供实时网络搜索与爬取能力。通过原生工具集成，Claude 等 AI 助手可以直接访问实时网页数据。
主要能力
- 实时网络搜索：支持任意国家/语言。
- 多种输出格式：增强 HTML、原始 HTML、Markdown、纯文本。
- 设备特定结果：桌面、移动或平板视图。
- 深度内容提取：支持 JavaScript 渲染。
- 零数据保留：完全隐私保护。
- 自动爬取：可选择自动爬取搜索结果。
使用方式
安装选项
- NPM（本地使用推荐）：全局安装或使用 npx，无需安装。
- 克隆仓库。
- Docker：使用 Docker 构建和运行，并配置 MCP 客户端。
- 远程服务器（无需安装）：使用托管版本 https://api.crawleo.dev/mcp。
获取 API 密钥
访问 crawleo.dev，注册免费账户，在仪表板中复制以 sk_ 开头的 API 密钥。
配置
- Claude Desktop / Cursor / Windsurf（本地）：在对应配置文件中添加 Crawleo MCP 配置，替换 YOUR_API_KEY_HERE 为实际密钥。
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
- Linux：~/.config/Claude/claude_desktop_config.json
- 远程服务器（托管）：同样在配置文件中配置。
- GitHub Copilot：在 VS Code 或兼容编辑器中配置 MCP 服务器。
- OpenAI 平台（直接集成）：使用 server_url、authorization、allowed_tools、require_approval 等参数。
可用工具
- web.search：实时搜索网络，可自定义参数。
- query（必填）
- max_pages（结果页数，默认 1）
- setLang（语言代码）
- cc（国家代码）
- device（设备类型：desktop、mobile、tablet，默认 desktop）
- enhanced_html（默认 true）
- raw_html（默认 false）
- markdown（默认 true）
- page_text（默认 false）
- auto_crawling（默认 false）
- web.crawl：从指定 URL 提取内容。
- urls（必填）
- rawHtml（默认 false）
- markdown（默认 false）
- screenshot（可选）
- country（地理位置）
适用场景
- 研究助理
- 内容分析
- 代码文档
- 新闻监控
- 市场研究
限制与注意事项
- API 密钥以 sk_ 开头，需放在引号中；Claude/Cursor/Windsurf 需在 Authorization 头中包含 "Bearer " 前缀，OpenAI 平台则直接使用密钥。
- 工具名称需正确：使用 web.search（非 search_web）、web.crawl（非 crawl_web）。
- 如遇问题，检查配置文件位置、JSON 语法、重启应用、验证 API 密钥及账户余额。
- 定价与 API 相同：10,000 次搜索 → $20；100,000 次搜索 → $100；250,000 次搜索 → $200。
隐私与安全
- 零数据保留：不存储搜索查询或结果。
- 安全认证：API 密钥通过 HTTPS 传输。
- 无跟踪：使用模式保持私密。
