基本能力
产品定位
WebSearch-MCP 是一个为 AI 助手提供实时网页搜索能力的 MCP 服务器。
核心功能
- 提供网页搜索能力，支持多种搜索参数（如语言、地区、结果类型等）。
- 集成 WebSearch Crawler API 进行实际网页搜索。
- 支持通过 stdio 传输与 AI 助手通信。
适用场景
- AI 助手需要获取实时网络信息时。
- 需要定制化搜索结果的场景（如排除特定域名、限制结果数量等）。
工具列表
web_search工具：提供网页搜索功能，支持多种参数配置。
常见问题解答
- API 不可达：确保爬虫服务正在运行并可通过配置的 API_URL 访问。
- 搜索结果不可用：检查爬虫服务的日志以查看是否有错误。
- FlareSolverr 问题：某些网站使用 Cloudflare 保护，检查 FlareSolverr 是否正常工作。
使用教程
使用依赖
安装教程
通过 Smithery 安装
bash
npx -y @smithery/cli install @mnhlt/WebSearch-MCP --client claude
手动安装
bash
npm install -g websearch-mcp
或无需安装直接使用：
bash
npx websearch-mcp
调试方式
启动爬虫服务
-
创建
docker-compose.yml文件并启动服务：
bash
docker-compose up -d -
验证服务是否运行：
bash
docker-compose ps -
测试爬虫 API 健康端点：
bash
curl http://localhost:3001/health
测试爬虫 API
bash
curl -X POST http://localhost:3001/crawl \
-H "Content-Type: application/json" \
-d '{
"query": "typescript best practices",
"numResults": 2,
"language": "en",
"filters": {
"excludeDomains": ["youtube.com"],
"resultType": "all"
}
}'
测试 MCP 服务器
bash
npm run test-client
或配置 API_URL 进行测试：
bash
API_URL=https://crawler.example.com npm run test-client
