@oevortex/ddg_search 1.0.0 → 1.0.1
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 +15 -16
- package/bin/cli.js +1 -1
- package/package.json +11 -2
package/README.md
CHANGED
|
@@ -1,10 +1,5 @@
|
|
|
1
|
-
<!--
|
|
2
|
-
DuckDuckGo Search MCP - Modern README
|
|
3
|
-
Author: @OEvortex | License: Apache 2.0
|
|
4
|
-
-->
|
|
5
|
-
|
|
6
1
|
<div align="center">
|
|
7
|
-
<img src="https://img.shields.io/npm/v/@
|
|
2
|
+
<img src="https://img.shields.io/npm/v/@oevortex/ddg_search.svg" alt="npm version" />
|
|
8
3
|
<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0" />
|
|
9
4
|
<img src="https://img.shields.io/badge/YouTube-%40OEvortex-red.svg" alt="YouTube Channel" />
|
|
10
5
|
<h1>DuckDuckGo Search MCP 🔍</h1>
|
|
@@ -28,7 +23,7 @@
|
|
|
28
23
|
|
|
29
24
|
## ✨ Features
|
|
30
25
|
|
|
31
|
-
<div style="display: flex; flex-wrap: wrap; gap: 1.5em;">
|
|
26
|
+
<div style="display: flex; flex-wrap: wrap; gap: 1.5em; margin-bottom: 1.5em;">
|
|
32
27
|
<div><b>🌐 Web search</b> using DuckDuckGo HTML</div>
|
|
33
28
|
<div><b>📄 URL content extraction</b> with smart filtering</div>
|
|
34
29
|
<div><b>📊 URL metadata extraction</b> (title, description, images)</div>
|
|
@@ -45,11 +40,11 @@
|
|
|
45
40
|
|
|
46
41
|
## 🚀 Quick Start
|
|
47
42
|
|
|
48
|
-
<div style="background: #222; color: #fff; padding:
|
|
43
|
+
<div style="background: #222; color: #fff; padding: 1.5em; border-radius: 8px; margin: 1.5em 0;">
|
|
49
44
|
<b>Run instantly with npx:</b>
|
|
50
45
|
|
|
51
46
|
```bash
|
|
52
|
-
npx -y @
|
|
47
|
+
npx -y @oevortex/ddg_search
|
|
53
48
|
```
|
|
54
49
|
</div>
|
|
55
50
|
|
|
@@ -64,7 +59,7 @@ npx -y @OEvortex/ddg_search
|
|
|
64
59
|
<summary><b>Global Installation</b></summary>
|
|
65
60
|
|
|
66
61
|
```bash
|
|
67
|
-
npm install -g @
|
|
62
|
+
npm install -g @oevortex/ddg_search
|
|
68
63
|
```
|
|
69
64
|
|
|
70
65
|
Run globally:
|
|
@@ -92,7 +87,7 @@ npm start
|
|
|
92
87
|
## 🧑💻 Command Line Options
|
|
93
88
|
|
|
94
89
|
```bash
|
|
95
|
-
npx -y @
|
|
90
|
+
npx -y @oevortex/ddg_search --help
|
|
96
91
|
```
|
|
97
92
|
|
|
98
93
|
> [!TIP]
|
|
@@ -112,7 +107,7 @@ Add the server to your MCP client configuration:
|
|
|
112
107
|
"mcpServers": {
|
|
113
108
|
"ddg-search": {
|
|
114
109
|
"command": "npx",
|
|
115
|
-
"args": ["-y", "@
|
|
110
|
+
"args": ["-y", "@oevortex/ddg_search"]
|
|
116
111
|
}
|
|
117
112
|
}
|
|
118
113
|
}
|
|
@@ -137,8 +132,8 @@ Or if installed globally:
|
|
|
137
132
|
|
|
138
133
|
## 🧰 Tools Overview
|
|
139
134
|
|
|
140
|
-
<div style="display: flex; flex-wrap: wrap; gap:
|
|
141
|
-
<div>
|
|
135
|
+
<div style="display: flex; flex-wrap: wrap; gap: 2.5em; margin: 1.5em 0;">
|
|
136
|
+
<div style="margin-bottom: 1.5em;">
|
|
142
137
|
<b>🔍 Web Search Tool</b><br/>
|
|
143
138
|
<code>web-search</code><br/>
|
|
144
139
|
<ul>
|
|
@@ -148,7 +143,7 @@ Or if installed globally:
|
|
|
148
143
|
</ul>
|
|
149
144
|
<i>Example: Search the web for "climate change solutions"</i>
|
|
150
145
|
</div>
|
|
151
|
-
<div>
|
|
146
|
+
<div style="margin-bottom: 1.5em;">
|
|
152
147
|
<b>📄 Fetch URL Tool</b><br/>
|
|
153
148
|
<code>fetch-url</code><br/>
|
|
154
149
|
<ul>
|
|
@@ -161,7 +156,7 @@ Or if installed globally:
|
|
|
161
156
|
</ul>
|
|
162
157
|
<i>Example: Fetch the content from "https://example.com"</i>
|
|
163
158
|
</div>
|
|
164
|
-
<div>
|
|
159
|
+
<div style="margin-bottom: 1.5em;">
|
|
165
160
|
<b>📊 URL Metadata Tool</b><br/>
|
|
166
161
|
<code>url-metadata</code><br/>
|
|
167
162
|
<ul>
|
|
@@ -175,6 +170,7 @@ Or if installed globally:
|
|
|
175
170
|
|
|
176
171
|
## 📁 Project Structure
|
|
177
172
|
|
|
173
|
+
|
|
178
174
|
```text
|
|
179
175
|
bin/ # Command-line interface
|
|
180
176
|
src/
|
|
@@ -193,6 +189,7 @@ README.md
|
|
|
193
189
|
|
|
194
190
|
## 🤝 Contributing
|
|
195
191
|
|
|
192
|
+
|
|
196
193
|
Contributions are welcome! Please open issues or submit pull requests.
|
|
197
194
|
|
|
198
195
|
> [!NOTE]
|
|
@@ -202,6 +199,7 @@ Contributions are welcome! Please open issues or submit pull requests.
|
|
|
202
199
|
|
|
203
200
|
## 📺 YouTube Channel
|
|
204
201
|
|
|
202
|
+
|
|
205
203
|
<div align="center">
|
|
206
204
|
<a href="https://youtube.com/@OEvortex"><img src="https://img.shields.io/badge/YouTube-%40OEvortex-red.svg" alt="YouTube Channel" /></a>
|
|
207
205
|
<br/>
|
|
@@ -212,6 +210,7 @@ Contributions are welcome! Please open issues or submit pull requests.
|
|
|
212
210
|
|
|
213
211
|
## 📄 License
|
|
214
212
|
|
|
213
|
+
|
|
215
214
|
Apache License 2.0
|
|
216
215
|
|
|
217
216
|
> [!NOTE]
|
package/bin/cli.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oevortex/ddg_search",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "A Model Context Protocol server for web search using DuckDuckGo",
|
|
5
5
|
"main": "src/index.js",
|
|
6
6
|
"bin": {
|
|
@@ -15,7 +15,16 @@
|
|
|
15
15
|
"publishConfig": {
|
|
16
16
|
"access": "public"
|
|
17
17
|
},
|
|
18
|
-
"keywords": [
|
|
18
|
+
"keywords": [
|
|
19
|
+
"mcp",
|
|
20
|
+
"model-context-protocol",
|
|
21
|
+
"duckduckgo",
|
|
22
|
+
"search",
|
|
23
|
+
"web-search",
|
|
24
|
+
"claude",
|
|
25
|
+
"ai",
|
|
26
|
+
"llm"
|
|
27
|
+
],
|
|
19
28
|
"author": "OEvortex",
|
|
20
29
|
"license": "Apache-2.0",
|
|
21
30
|
"type": "module",
|