one-search-mcp 1.0.5 → 1.0.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -8
- package/dist/index.cjs +1347 -29
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +7 -3
- package/dist/index.d.ts +7 -3
- package/dist/index.js +1347 -29
- package/dist/index.js.map +1 -1
- package/package.json +19 -7
package/README.md
CHANGED
|
@@ -1,28 +1,42 @@
|
|
|
1
1
|
# 🚀 OneSearch MCP Server: Web Search & Crawl & Scraper & Extract
|
|
2
2
|
|
|
3
|
-
A Model Context Protocol (MCP) server implementation that integrates with Searxng/
|
|
3
|
+
A Model Context Protocol (MCP) server implementation that integrates with Searxng/Tavily/DuckDuckGo/Bing for web search, local browser search, and scraping capabilities with Firecrawl.
|
|
4
4
|
|
|
5
5
|
## Features
|
|
6
6
|
|
|
7
7
|
- Web Search, scrape, crawl and extract content from websites.
|
|
8
|
-
- Support multiple search engines and web scrapers: SearXNG
|
|
8
|
+
- Support multiple search engines and web scrapers: **SearXNG**, **Firecrawl**, **Tavily**, **DuckDuckGo**, **Bing**, etc.
|
|
9
|
+
- **Local web search** (browser search), support multiple search engines: **Bing**, **Google**, **Baidu**, **Sogou**, etc.
|
|
10
|
+
- Use `puppeteer-core` to scrape content from websites.
|
|
11
|
+
- You should have a local browser installed, such as `Chromium`, `Google Chrome`, `Google Chrome Canary`, etc.
|
|
12
|
+
- Free, no keys required.
|
|
13
|
+
- **Enabled tools:** `one_search`, `one_scrape`, `one_map`
|
|
9
14
|
- Support for self-hosted: SearXNG, Firecrawl, etc. (see [Deploy](./deploy/README.md))
|
|
10
|
-
- **Enabled tools:** `one_search`, `one_scrape`
|
|
11
15
|
|
|
12
16
|
## Installation
|
|
13
17
|
|
|
14
18
|
```shell
|
|
15
|
-
#
|
|
19
|
+
# Manually install (Optional)
|
|
16
20
|
npm install -g one-search-mcp
|
|
17
21
|
```
|
|
18
22
|
|
|
23
|
+
```shell
|
|
24
|
+
# using npx
|
|
25
|
+
env SEARCH_API_URL=http://127.0.0.1:8080 FIRECRAWL_API_URL=http://127.0.0.1:3002 npx -y one-search-mcp
|
|
26
|
+
```
|
|
27
|
+
|
|
19
28
|
## Environment Variables
|
|
20
29
|
|
|
21
|
-
**Search:**
|
|
30
|
+
**Search Engine:**
|
|
22
31
|
|
|
23
|
-
- SEARCH_PROVIDER (Optional): The search provider to use,
|
|
24
|
-
- SEARCH_API_URL (Optional): The URL of the SearxNG API, required for `searxng`.
|
|
25
|
-
- SEARCH_API_KEY (Optional): The API key for the search provider, required for `tavily`.
|
|
32
|
+
- **SEARCH_PROVIDER** (Optional): The search provider to use, supports `searxng`, `duckduckgo`, `bing`, `tavily`, `local`, default is `local`.
|
|
33
|
+
- **SEARCH_API_URL** (Optional): The URL of the SearxNG API, required for `searxng`.
|
|
34
|
+
- **SEARCH_API_KEY** (Optional): The API key for the search provider, required for `tavily`, `bing`.
|
|
35
|
+
|
|
36
|
+
```ts
|
|
37
|
+
// supported search providers
|
|
38
|
+
export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'local';
|
|
39
|
+
```
|
|
26
40
|
|
|
27
41
|
**Firecrawl:**
|
|
28
42
|
|
|
@@ -77,6 +91,10 @@ Add this to your `./codeium/windsurf/model_config.json` file:
|
|
|
77
91
|
|
|
78
92
|
Local deployment of SearXNG and Firecrawl, please refer to [Deploy](./deploy/README.md)
|
|
79
93
|
|
|
94
|
+
## Troubleshooting
|
|
95
|
+
|
|
96
|
+
- [ReferenceError]: __name is not defined: This is because Puppeteer has problems with `tsx`, [esbuild#1031](https://github.com/evanw/esbuild/issues/1031)
|
|
97
|
+
|
|
80
98
|
## License
|
|
81
99
|
|
|
82
100
|
MIT License - see [LICENSE](./LICENSE) file for details.
|