基本能力
产品定位
OneSearch MCP Server 是一个多功能网页搜索和抓取工具,旨在为用户提供灵活的网页内容获取和处理能力。
核心功能
- 网页搜索、抓取、爬取和内容提取
- 支持多种搜索引擎和网页抓取工具:SearXNG、Firecrawl、Tavily、DuckDuckGo、Bing 等
- 本地网页搜索(浏览器搜索),支持多种搜索引擎:Bing、Google、Baidu、Sogou 等
- 使用
puppeteer-core
从网站抓取内容 - 需要本地安装浏览器,如 Chromium、Google Chrome、Google Chrome Canary 等
- 免费使用,无需密钥
适用场景
- 需要从多个搜索引擎获取信息的场景
- 需要自动化抓取网页内容的场景
- 需要本地浏览器搜索功能的场景
工具列表
one_search
: 提供网页搜索功能one_scrape
: 提供网页抓取功能one_map
: 提供地图相关功能
常见问题解答
- [ReferenceError]: __name is not defined: 这是因为 Puppeteer 与
tsx
存在问题,esbuild#1031
使用教程
使用依赖
- 需要本地安装浏览器,如 Chromium、Google Chrome、Google Chrome Canary 等
安装教程
通过 Smithery 安装
bash
npx -y @smithery/cli install @yokingma/one-search --client claude
手动安装
```shell
手动安装(可选)
npm install -g one-search-mcp
```
```shell
使用 npx
env SEARCH_API_URL=http://127.0.0.1:8080 FIRECRAWL_API_URL=http://127.0.0.1:3002 npx -y one-search-mcp
```
调试方式
- 确保环境变量设置正确:
- SEARCH_PROVIDER: 使用的搜索提供商
- SEARCH_API_URL: SearxNG API 的 URL
- SEARCH_API_KEY: 搜索提供商的 API 密钥
- FIRECRAWL_API_URL: Firecrawl API 的 URL
-
FIRECRAWL_API_KEY: Firecrawl API 的密钥
-
运行配置示例(Cursor):
json
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": ["-y", "one-search-mcp"],
"env": {
"SEARCH_PROVIDER": "searxng",
"SEARCH_API_URL": "http://127.0.0.1:8080",
"SEARCH_API_KEY": "YOUR_API_KEY",
"FIRECRAWL_API_URL": "http://127.0.0.1:3002",
"FIRECRAWL_API_KEY": "YOUR_API_KEY"
}
}
}
} -
运行配置示例(Windsurf):
json
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": ["-y", "one-search-mcp"],
"env": {
"SEARCH_PROVIDER": "searxng",
"SEARCH_API_URL": "http://127.0.0.1:8080",
"SEARCH_API_KEY": "YOUR_API_KEY",
"FIRECRAWL_API_URL": "http://127.0.0.1:3002",
"FIRECRAWL_API_KEY": "YOUR_API_KEY"
}
}
}
}