@endday/search-mcp 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.
Files changed (85) hide show
  1. package/dist/index.js +4724 -0
  2. package/dist/search-mcp.js +4715 -0
  3. package/package.json +14 -14
  4. package/data/blocklist.generated.js +0 -2
  5. package/envs.js +0 -129
  6. package/index.js +0 -6
  7. package/mcp/search-mcp.js +0 -8
  8. package/src/content/extract.impl.js +0 -228
  9. package/src/content/extract.js +0 -1
  10. package/src/content/fetch.impl.js +0 -400
  11. package/src/content/fetch.js +0 -1
  12. package/src/core/crypto.js +0 -7
  13. package/src/core/errors.impl.js +0 -52
  14. package/src/core/errors.js +0 -1
  15. package/src/core/html.impl.js +0 -69
  16. package/src/core/html.js +0 -1
  17. package/src/mcp/config.js +0 -75
  18. package/src/mcp/format.js +0 -44
  19. package/src/mcp/index.js +0 -10
  20. package/src/mcp/local/content.js +0 -26
  21. package/src/mcp/local/search.js +0 -233
  22. package/src/mcp/schemas.js +0 -132
  23. package/src/mcp/server.js +0 -97
  24. package/src/mcp/tools/content.js +0 -31
  25. package/src/mcp/tools/jinaContent.js +0 -38
  26. package/src/mcp/tools/newsSearch.js +0 -22
  27. package/src/mcp/tools/webSearch.js +0 -57
  28. package/src/platform/auth.impl.js +0 -166
  29. package/src/platform/auth.js +0 -1
  30. package/src/platform/cache.impl.js +0 -166
  31. package/src/platform/cache.js +0 -1
  32. package/src/platform/health.impl.js +0 -133
  33. package/src/platform/health.js +0 -1
  34. package/src/platform/http.impl.js +0 -108
  35. package/src/platform/http.js +0 -1
  36. package/src/platform/logger.impl.js +0 -51
  37. package/src/platform/logger.js +0 -1
  38. package/src/platform/metrics.impl.js +0 -43
  39. package/src/platform/metrics.js +0 -1
  40. package/src/platform/nodeHttpClient.js +0 -104
  41. package/src/platform/rateLimit.impl.js +0 -141
  42. package/src/platform/rateLimit.js +0 -1
  43. package/src/platform/requestContext.impl.js +0 -10
  44. package/src/platform/requestContext.js +0 -1
  45. package/src/platform/session.impl.js +0 -198
  46. package/src/platform/session.js +0 -1
  47. package/src/platform/stateKv.impl.js +0 -18
  48. package/src/platform/stateKv.js +0 -1
  49. package/src/platform/tasks.impl.js +0 -17
  50. package/src/platform/tasks.js +0 -1
  51. package/src/routes/requestParams.impl.js +0 -12
  52. package/src/routes/requestParams.js +0 -1
  53. package/src/search/engineRegistry.impl.js +0 -117
  54. package/src/search/engineRegistry.js +0 -1
  55. package/src/search/engineRequest.impl.js +0 -377
  56. package/src/search/engineRequest.js +0 -1
  57. package/src/search/engineUtils.impl.js +0 -227
  58. package/src/search/engineUtils.js +0 -1
  59. package/src/search/engines/baidu.impl.js +0 -145
  60. package/src/search/engines/baidu.js +0 -2
  61. package/src/search/engines/bing.impl.js +0 -509
  62. package/src/search/engines/bing.js +0 -2
  63. package/src/search/engines/brave.impl.js +0 -223
  64. package/src/search/engines/brave.js +0 -2
  65. package/src/search/engines/duckduckgo.impl.js +0 -164
  66. package/src/search/engines/duckduckgo.js +0 -2
  67. package/src/search/engines/mojeek.impl.js +0 -115
  68. package/src/search/engines/mojeek.js +0 -2
  69. package/src/search/engines/qwant.impl.js +0 -188
  70. package/src/search/engines/qwant.js +0 -2
  71. package/src/search/engines/startpage.impl.js +0 -237
  72. package/src/search/engines/startpage.js +0 -2
  73. package/src/search/engines/toutiao.impl.js +0 -265
  74. package/src/search/engines/toutiao.js +0 -2
  75. package/src/search/engines/yahoo.impl.js +0 -379
  76. package/src/search/engines/yahoo.js +0 -2
  77. package/src/search/gateway.impl.js +0 -423
  78. package/src/search/gateway.js +0 -1
  79. package/src/search/ranking.impl.js +0 -381
  80. package/src/search/ranking.js +0 -1
  81. package/src/search/requestPolicy.impl.js +0 -137
  82. package/src/search/requestPolicy.js +0 -1
  83. package/src/search/upstreamSession.impl.js +0 -148
  84. package/src/search/upstreamSession.js +0 -1
  85. /package/{index.d.ts → dist/index.d.ts} +0 -0
package/envs.js DELETED
@@ -1,129 +0,0 @@
1
- const createDefaultEnv = () => ({
2
- DEFAULT_TIMEOUT: "4000",
3
- SUPPORTED_ENGINES: [
4
- "baidu",
5
- "startpage",
6
- "duckduckgo",
7
- "brave",
8
- "qwant",
9
- "yahoo",
10
- "mojeek",
11
- "bing",
12
- "toutiao",
13
- ],
14
- DEFAULT_ENGINES: ["bing", "brave", "yahoo", "mojeek"],
15
- DEFAULT_ENGINES_ZH: ["baidu", "bing"],
16
- DEFAULT_ENGINES_NON_ZH: ["bing", "brave", "yahoo", "mojeek"],
17
- DEFAULT_LANGUAGE: "en",
18
- FALLBACK_MIN_RESULTS: "6",
19
- FALLBACK_MIN_CONTRIBUTING_ENGINES: "2",
20
- SEARCH_PRIMARY_TIERS: ["primary"],
21
- SEARCH_SECONDARY_TIERS: ["secondary"],
22
- SEARCH_EXPERIMENTAL_TIERS: ["experimental"],
23
- SEARCH_TIER_HEDGE_DELAY_MS: "250",
24
- EDGE_CACHE_TTL_SECONDS: "30",
25
- CACHE_TTL_SECONDS: "300",
26
- STALE_CACHE_TTL_SECONDS: "1800",
27
- RATE_LIMIT_WINDOW_SECONDS: "60",
28
- RATE_LIMIT_MAX_REQUESTS: "60",
29
- UPSTREAM_RETRY_ATTEMPTS: "1",
30
- UPSTREAM_RETRY_DELAY_MS: "200",
31
- UPSTREAM_PRIMARY_RETRY_ATTEMPTS: "1",
32
- UPSTREAM_SECONDARY_RETRY_ATTEMPTS: "0",
33
- UPSTREAM_EXPERIMENTAL_RETRY_ATTEMPTS: "0",
34
- UPSTREAM_SESSION_TTL_SECONDS: "3600",
35
- UPSTREAM_MIN_REQUEST_INTERVAL_MS: "150",
36
- UPSTREAM_PRIMARY_MIN_REQUEST_INTERVAL_MS: "100",
37
- UPSTREAM_SECONDARY_MIN_REQUEST_INTERVAL_MS: "250",
38
- UPSTREAM_EXPERIMENTAL_MIN_REQUEST_INTERVAL_MS: "500",
39
- HEALTH_FAILURE_THRESHOLD: "2",
40
- HEALTH_COOLDOWN_SECONDS: "180",
41
- HEALTH_STATE_TTL_SECONDS: "3600",
42
- CORS_ALLOWED_ORIGINS: ["*"],
43
- CORS_ALLOWED_HEADERS: ["Authorization", "Content-Type", "x-api-key"],
44
- AUTH_REQUIRED: "false",
45
- TOKEN: null,
46
- CF_BROWSER_RENDERING_ACCOUNT_ID: null,
47
- CF_BROWSER_RENDERING_API_TOKEN: null,
48
- SEARCH_KV: null,
49
- SEARCH_STATE_KV: null,
50
- });
51
-
52
- function normalizeStringArray(value, fallback) {
53
- if (Array.isArray(value)) {
54
- return value.map((item) => String(item).trim()).filter(Boolean);
55
- }
56
-
57
- if (typeof value === "string") {
58
- const trimmed = value.trim();
59
- if (!trimmed) {
60
- return [...fallback];
61
- }
62
-
63
- if (trimmed.startsWith("[")) {
64
- try {
65
- return normalizeStringArray(JSON.parse(trimmed), fallback);
66
- } catch (_) {
67
- return [...fallback];
68
- }
69
- }
70
-
71
- return trimmed
72
- .split(",")
73
- .map((item) => item.trim())
74
- .filter(Boolean);
75
- }
76
-
77
- return [...fallback];
78
- }
79
-
80
- function resetEnv(target) {
81
- const defaults = createDefaultEnv();
82
- Object.keys(target).forEach((key) => {
83
- delete target[key];
84
- });
85
- Object.assign(target, defaults);
86
- }
87
-
88
- export const env = createDefaultEnv();
89
-
90
- export const setEnv = (newEnv = {}) => {
91
- resetEnv(env);
92
- Object.assign(env, newEnv);
93
- env.SUPPORTED_ENGINES = normalizeStringArray(
94
- env.SUPPORTED_ENGINES,
95
- createDefaultEnv().SUPPORTED_ENGINES
96
- );
97
- env.DEFAULT_ENGINES = normalizeStringArray(
98
- env.DEFAULT_ENGINES,
99
- createDefaultEnv().DEFAULT_ENGINES
100
- );
101
- env.DEFAULT_ENGINES_ZH = normalizeStringArray(
102
- env.DEFAULT_ENGINES_ZH,
103
- createDefaultEnv().DEFAULT_ENGINES_ZH
104
- );
105
- env.DEFAULT_ENGINES_NON_ZH = normalizeStringArray(
106
- env.DEFAULT_ENGINES_NON_ZH,
107
- createDefaultEnv().DEFAULT_ENGINES_NON_ZH
108
- );
109
- env.CORS_ALLOWED_ORIGINS = normalizeStringArray(
110
- env.CORS_ALLOWED_ORIGINS,
111
- createDefaultEnv().CORS_ALLOWED_ORIGINS
112
- );
113
- env.CORS_ALLOWED_HEADERS = normalizeStringArray(
114
- env.CORS_ALLOWED_HEADERS,
115
- createDefaultEnv().CORS_ALLOWED_HEADERS
116
- );
117
- env.SEARCH_PRIMARY_TIERS = normalizeStringArray(
118
- env.SEARCH_PRIMARY_TIERS,
119
- createDefaultEnv().SEARCH_PRIMARY_TIERS
120
- );
121
- env.SEARCH_SECONDARY_TIERS = normalizeStringArray(
122
- env.SEARCH_SECONDARY_TIERS,
123
- createDefaultEnv().SEARCH_SECONDARY_TIERS
124
- );
125
- env.SEARCH_EXPERIMENTAL_TIERS = normalizeStringArray(
126
- env.SEARCH_EXPERIMENTAL_TIERS,
127
- createDefaultEnv().SEARCH_EXPERIMENTAL_TIERS
128
- );
129
- };
package/index.js DELETED
@@ -1,6 +0,0 @@
1
- export { env, setEnv } from "./envs.js";
2
- export { loadMcpConfig } from "./src/mcp/config.js";
3
- export { main } from "./src/mcp/index.js";
4
- export { searchLocal } from "./src/mcp/local/search.js";
5
- export { createServer, startServer } from "./src/mcp/server.js";
6
- export { searchAll, searchAllWithMeta } from "./src/search/gateway.js";
package/mcp/search-mcp.js DELETED
@@ -1,8 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- import { main } from "../src/mcp/index.js";
4
-
5
- main().catch((error) => {
6
- console.error("Fatal error:", error);
7
- process.exit(1);
8
- });
@@ -1,228 +0,0 @@
1
- import { Readability } from "@mozilla/readability";
2
- import { DOMParser } from "linkedom/worker";
3
-
4
- import { cleanText, parseHtml } from "../core/html.js";
5
-
6
- const NOISE_SELECTOR =
7
- "script, style, noscript, nav, footer, header, aside, form, iframe, svg, canvas, button, input, select, textarea";
8
- const CANDIDATE_SELECTOR =
9
- "article, main, section, div, [role=main], .article, .post, .content, .entry-content, #content";
10
- const POSITIVE_RE =
11
- /article|body|content|entry|hentry|main|page|post|story|text|正文|内容|文章/i;
12
- const NEGATIVE_RE =
13
- /ad|banner|comment|combx|contact|footer|header|menu|meta|nav|promo|related|remark|rss|share|sidebar|social|tag|tool|widget|广告|评论|导航|分享|推荐|相关阅读/i;
14
-
15
- function getNodeText(node) {
16
- return cleanText(node?.text || "");
17
- }
18
-
19
- function getMeta(root, selector) {
20
- return cleanText(root.querySelector(selector)?.getAttribute("content") || "");
21
- }
22
-
23
- function getNodeSignal(node) {
24
- return `${node.getAttribute?.("id") || ""} ${node.getAttribute?.("class") || ""}`;
25
- }
26
-
27
- function scoreCandidate(node) {
28
- const text = getNodeText(node);
29
- const textLength = text.length;
30
-
31
- if (textLength < 80) {
32
- return {
33
- node,
34
- score: 0,
35
- textLength,
36
- linkDensity: 1,
37
- paragraphCount: 0,
38
- };
39
- }
40
-
41
- const linkTextLength = node
42
- .querySelectorAll("a")
43
- .reduce((total, link) => total + getNodeText(link).length, 0);
44
- const paragraphCount = node.querySelectorAll("p").filter((p) => {
45
- return getNodeText(p).length >= 20;
46
- }).length;
47
- const commaCount = (text.match(/[,,。.!?!?;;]/g) || []).length;
48
- const signal = getNodeSignal(node);
49
- const linkDensity = textLength ? linkTextLength / textLength : 1;
50
- let score = textLength + paragraphCount * 120 + commaCount * 12;
51
-
52
- if (POSITIVE_RE.test(signal)) {
53
- score += 350;
54
- }
55
-
56
- if (NEGATIVE_RE.test(signal)) {
57
- score -= 500;
58
- }
59
-
60
- score *= Math.max(0.05, 1 - linkDensity);
61
-
62
- return {
63
- node,
64
- score,
65
- textLength,
66
- linkDensity,
67
- paragraphCount,
68
- };
69
- }
70
-
71
- function cleanTree(root) {
72
- root.querySelectorAll(NOISE_SELECTOR).forEach((node) => node.remove());
73
- root.querySelectorAll("a").forEach((link) => {
74
- const href = String(link.getAttribute("href") || "").trim();
75
- if (/^\s*javascript:/i.test(href)) {
76
- link.removeAttribute("href");
77
- }
78
- });
79
- }
80
-
81
- function stripUnsafeHtml(html) {
82
- return String(html || "")
83
- .replace(/\s+on[a-z]+\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi, "")
84
- .replace(/\s+style\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi, "")
85
- .replace(/\s+href\s*=\s*(['"])\s*javascript:[\s\S]*?\1/gi, "");
86
- }
87
-
88
- function pickBestCandidate(root) {
89
- const candidates = root
90
- .querySelectorAll(CANDIDATE_SELECTOR)
91
- .map(scoreCandidate)
92
- .sort((a, b) => b.score - a.score);
93
-
94
- const best = candidates[0];
95
- if (best?.score > 0) {
96
- return best;
97
- }
98
-
99
- const body = root.querySelector("body") || root;
100
- return scoreCandidate(body);
101
- }
102
-
103
- function getPageMetadata(html) {
104
- const root = parseHtml(html);
105
-
106
- return {
107
- title:
108
- getMeta(root, 'meta[property="og:title"]') ||
109
- getMeta(root, 'meta[name="twitter:title"]') ||
110
- cleanText(root.querySelector("title")?.text || ""),
111
- description:
112
- getMeta(root, 'meta[property="og:description"]') ||
113
- getMeta(root, 'meta[name="twitter:description"]') ||
114
- getMeta(root, 'meta[name="description"]'),
115
- site_name: getMeta(root, 'meta[property="og:site_name"]'),
116
- author: getMeta(root, 'meta[name="author"]'),
117
- published_time:
118
- getMeta(root, 'meta[property="article:published_time"]') ||
119
- getMeta(root, 'meta[name="date"]') ||
120
- getMeta(root, 'meta[name="pubdate"]'),
121
- image:
122
- getMeta(root, 'meta[property="og:image"]') ||
123
- getMeta(root, 'meta[name="twitter:image"]'),
124
- lang: root.querySelector("html")?.getAttribute("lang") || "",
125
- };
126
- }
127
-
128
- function extractWithReadability(html, url) {
129
- const document = new DOMParser().parseFromString(html, "text/html");
130
-
131
- if (url && document.head) {
132
- const base = document.createElement("base");
133
- base.setAttribute("href", url);
134
- document.head.appendChild(base);
135
- }
136
-
137
- const article = new Readability(document, {
138
- keepClasses: true,
139
- }).parse();
140
-
141
- if (!article?.content) {
142
- return null;
143
- }
144
-
145
- return article;
146
- }
147
-
148
- function normalizeReadabilityArticle(article, metadata, url) {
149
- const text = cleanText(article.textContent || article.content);
150
- const contentHtml = stripUnsafeHtml(article.content);
151
-
152
- if (text.length < 80) {
153
- return null;
154
- }
155
-
156
- return {
157
- url: article.url || url,
158
- source: "direct-fetch",
159
- extractor: "readability",
160
- title: cleanText(article.title || metadata.title || ""),
161
- description: cleanText(article.excerpt || metadata.description || ""),
162
- metadata: {
163
- ...metadata,
164
- title: cleanText(article.title || metadata.title || ""),
165
- description: cleanText(article.excerpt || metadata.description || ""),
166
- site_name: cleanText(article.siteName || metadata.site_name || ""),
167
- author: cleanText(article.byline || metadata.author || ""),
168
- lang: article.lang || metadata.lang || "",
169
- },
170
- html: contentHtml,
171
- text,
172
- excerpt: text.slice(0, 500),
173
- stats: {
174
- text_length: text.length,
175
- html_length: contentHtml.length,
176
- score: null,
177
- link_density: null,
178
- paragraph_count: (contentHtml.match(/<p\b/gi) || []).length,
179
- },
180
- };
181
- }
182
-
183
- function extractPageContentWithHeuristics(html, url) {
184
- const root = parseHtml(html);
185
- const metadata = getPageMetadata(html);
186
-
187
- cleanTree(root);
188
-
189
- const candidate = pickBestCandidate(root);
190
- const text = getNodeText(candidate.node);
191
- const contentHtml = stripUnsafeHtml(candidate.node?.toString() || "");
192
-
193
- return {
194
- url,
195
- source: "direct-fetch",
196
- extractor: "heuristic",
197
- title: metadata.title,
198
- description: metadata.description,
199
- metadata,
200
- html: contentHtml,
201
- text,
202
- excerpt: text.slice(0, 500),
203
- stats: {
204
- text_length: text.length,
205
- html_length: contentHtml.length,
206
- score: Math.round(candidate.score),
207
- link_density: Number(candidate.linkDensity.toFixed(3)),
208
- paragraph_count: candidate.paragraphCount,
209
- },
210
- };
211
- }
212
-
213
- export async function extractPageContent(html, url) {
214
- try {
215
- const metadata = getPageMetadata(html);
216
- const article = extractWithReadability(html, url);
217
- const extracted = normalizeReadabilityArticle(article, metadata, url);
218
-
219
- if (extracted) {
220
- return extracted;
221
- }
222
- } catch (_) {
223
- // Fall back to the local heuristic extractor when the library cannot parse
224
- // a page or when Worker bundling/runtime behavior differs by site.
225
- }
226
-
227
- return extractPageContentWithHeuristics(html, url);
228
- }
@@ -1 +0,0 @@
1
- export * from "./extract.impl.js";