@lmcc-dev/mult-fetch-mcp-server 1.1.0 → 1.2.0

package/README.md

@@ -4,7 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Version](https://img.shields.io/node/v/@lmcc-dev/mult-fetch-mcp-server)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
-[![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.6.1-brightgreen.svg)](https://github.com/modelcontextprotocol/typescript-sdk)
+[![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.7.0-brightgreen.svg)](https://github.com/modelcontextprotocol/typescript-sdk)
 [![GitHub Stars](https://img.shields.io/github/stars/lmcc-dev/mult-fetch-mcp-server)](https://github.com/lmcc-dev/mult-fetch-mcp-server/stargazers)
 [![GitHub Forks](https://img.shields.io/github/forks/lmcc-dev/mult-fetch-mcp-server)](https://github.com/lmcc-dev/mult-fetch-mcp-server/network/members)
 [![GitHub Issues](https://img.shields.io/github/issues/lmcc-dev/mult-fetch-mcp-server)](https://github.com/lmcc-dev/mult-fetch-mcp-server/issues)
@@ -91,16 +91,16 @@ npx -y @smithery/cli install @lmcc-dev/mult-fetch-mcp-server --client claude
 ### Local Installation
 
 ```bash
-npm install
+pnpm install
 ```
 
 ### Global Installation
 
 ```bash
-npm install -g @lmcc-dev/mult-fetch-mcp-server
+pnpm add -g @lmcc-dev/mult-fetch-mcp-server
 ```
 
-Or use npx to run directly (no installation required):
+Or run directly with npx (no installation required):
 
 ```bash
 npx @lmcc-dev/mult-fetch-mcp-server
@@ -175,13 +175,13 @@ After configuration, restart Claude desktop, and you can use the following tools
 ## Build
 
 ```bash
-npm run build
+pnpm run build
 ```
 
 ## Run Server
 
 ```bash
-npm run server
+pnpm run server
 # or
 node dist/index.js
 # if globally installed, you can run directly
@@ -193,9 +193,9 @@ npx @lmcc-dev/mult-fetch-mcp-server
 ## Run Client
 
 ```bash
-npm run client <method> <params_json>
+pnpm run client <method> <params_json>
 # example
-npm run client fetch_html '{"url": "https://example.com", "debug": true}'
+pnpm run client fetch_html '{"url": "https://example.com", "debug": true}'
 ```
 
 ## Run Tests

package/README.zh.md

@@ -4,7 +4,7 @@
 [![许可证: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js 版本](https://img.shields.io/node/v/@lmcc-dev/mult-fetch-mcp-server)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
-[![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.6.1-brightgreen.svg)](https://github.com/modelcontextprotocol/typescript-sdk)
+[![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.7.0-brightgreen.svg)](https://github.com/modelcontextprotocol/typescript-sdk)
 [![GitHub Stars](https://img.shields.io/github/stars/lmcc-dev/mult-fetch-mcp-server)](https://github.com/lmcc-dev/mult-fetch-mcp-server/stargazers)
 [![GitHub Forks](https://img.shields.io/github/forks/lmcc-dev/mult-fetch-mcp-server)](https://github.com/lmcc-dev/mult-fetch-mcp-server/network/members)
 [![GitHub Issues](https://img.shields.io/github/issues/lmcc-dev/mult-fetch-mcp-server)](https://github.com/lmcc-dev/mult-fetch-mcp-server/issues)
@@ -77,22 +77,30 @@ fetch-mcp/
 
 ## 安装
 
+### 通过 Smithery 安装
+
+要通过 [Smithery](https://smithery.ai/server/@lmcc-dev/mult-fetch-mcp-server) 自动为 Claude 桌面版安装 Mult Fetch MCP Server：
+
+```bash
+npx -y @smithery/cli install @lmcc-dev/mult-fetch-mcp-server --client claude
+```
+
 ### 本地安装
 
 ```bash
-npm install
+pnpm install
 ```
 
 ### 全局安装
 
 ```bash
-npm install -g mult-fetch-mcp-server
+pnpm add -g @lmcc-dev/mult-fetch-mcp-server
 ```
 
 或者直接使用 npx 运行（无需安装）：
 
 ```bash
-npx mult-fetch-mcp-server
+npx @lmcc-dev/mult-fetch-mcp-server
 ```
 
 ## 与 Claude 集成
@@ -164,13 +172,13 @@ npx mult-fetch-mcp-server
 ## 构建
 
 ```bash
-npm run build
+pnpm run build
 ```
 
 ## 运行服务器
 
 ```bash
-npm run server
+pnpm run server
 # 或者
 node dist/index.js
 # 如果全局安装，可以直接运行
@@ -182,9 +190,9 @@ npx mult-fetch-mcp-server
 ## 运行客户端
 
 ```bash
-npm run client <method> <params_json>
+pnpm run client <method> <params_json>
 # 例如
-npm run client fetch_html '{"url": "https://example.com", "debug": true}'
+pnpm run client fetch_html '{"url": "https://example.com", "debug": true}'
 ```
 
 ## 运行测试

package/dist/i18n-test-report.json

@@ -0,0 +1,8 @@
+{
+  "timestamp": "2025-03-15T11:54:45.602Z",
+  "totalKeys": 406,
+  "missingTranslations": [],
+  "emptyTranslations": [],
+  "placeholderMismatches": [],
+  "hasIssues": false
+}

package/dist/i18n-unused-keys-report.json

@@ -0,0 +1,8 @@
+{
+  "timestamp": "2025-03-15T11:54:15.658Z",
+  "totalKeys": 406,
+  "totalUsedKeys": 406,
+  "totalFiles": 195,
+  "unusedKeys": [],
+  "hasUnusedKeys": false
+}

package/dist/src/client.js

@@ -28,7 +28,7 @@ function responseRequiresBrowser(response, debug = false) {
     if (response.isError) {
         const errorText = response.content[0].text;
         if (debug) {
-            log('fetcher.fetchError', debug, { url: '', error: errorText }, COMPONENTS.CLIENT);
+            log('client.fetchError', debug, { url: '', error: errorText }, COMPONENTS.CLIENT);
             // 尝试从错误信息中提取HTTP状态码 (Try to extract HTTP status code from error message)
             const statusCodeMatch = errorText.match(/(\b[45]\d\d\b)/);
             if (statusCodeMatch) {
@@ -104,67 +104,60 @@ async function smartFetch(params) {
             // 在调试模式下打印响应结果的摘要 (Print response result summary in debug mode)
             if (debug) {
                 if (result.isError) {
-                    log('client.fetchFailed', debug, { error: result.content[0].text.substring(0, 150) + (result.content[0].text.length > 150 ? '...' : '') }, COMPONENTS.CLIENT);
+                    log('client.fetchFailed', debug, { url, error: result.content[0].text }, COMPONENTS.CLIENT);
                 }
                 else {
-                    const contentLength = result.content[0].text.length;
-                    log('client.fetchSuccess', debug, { length: contentLength }, COMPONENTS.CLIENT);
+                    log('client.fetchSuccess', debug, { url }, COMPONENTS.CLIENT);
                 }
             }
-            // 如果失败并且响应表明需要浏览器模式，且当前不是浏览器模式 (If failed and response indicates browser mode is needed, and current mode is not browser mode)
-            if (!params.useBrowser && responseRequiresBrowser(result, debug)) {
+            // 检查是否需要切换到浏览器模式 (Check if need to switch to browser mode)
+            if (result.isError && responseRequiresBrowser(result, debug) && !params.useBrowser) {
                 log('client.browserModeNeeded', debug, { url }, COMPONENTS.CLIENT);
-                // 切换到浏览器模式重试 (Switch to browser mode and retry)
-                params.useBrowser = true;
-                // 设置关闭浏览器选项，确保资源被释放 (Set close browser option to ensure resources are released)
-                params.closeBrowser = true;
                 log('client.retryingWithBrowser', debug, { url }, COMPONENTS.CLIENT);
+                // 切换到浏览器模式重试 (Switch to browser mode and retry)
                 const browserResult = await client.callTool({
                     name: method,
-                    arguments: params
-                });
-                // 在调试模式下打印浏览器模式的响应结果摘要 (Print browser mode response result summary in debug mode)
-                if (debug) {
-                    if (browserResult.isError) {
-                        log('client.browserModeFetchFailed', debug, { error: browserResult.content[0].text.substring(0, 150) + (browserResult.content[0].text.length > 150 ? '...' : '') }, COMPONENTS.CLIENT);
-                    }
-                    else {
-                        const contentLength = browserResult.content[0].text.length;
-                        log('client.browserModeFetchSuccess', debug, { length: contentLength }, COMPONENTS.CLIENT);
+                    arguments: {
+                        ...params,
+                        useBrowser: true
                     }
+                });
+                if (browserResult.isError) {
+                    log('client.browserModeFetchFailed', debug, { url, error: browserResult.content[0].text }, COMPONENTS.CLIENT);
+                }
+                else {
+                    log('client.browserModeFetchSuccess', debug, { url }, COMPONENTS.CLIENT);
                 }
                 return browserResult;
             }
+            if (result.isError) {
+                log('client.fetchFailed', debug, { url, error: result.content[0].text }, COMPONENTS.CLIENT);
+            }
+            else {
+                log('client.fetchSuccess', debug, { url }, COMPONENTS.CLIENT);
+            }
             return result;
         }
         else {
-            // 不启用自动检测，直接使用指定模式
+            // 直接使用指定的模式 (Directly use the specified mode)
             log('client.usingMode', debug, { mode: params.useBrowser ? 'browser' : 'standard', url }, COMPONENTS.CLIENT);
-            // 如果使用浏览器模式，设置关闭浏览器选项
-            if (params.useBrowser) {
-                params.closeBrowser = true;
-            }
             const result = await client.callTool({
                 name: method,
                 arguments: params
             });
-            // 在调试模式下打印响应结果的摘要
-            if (debug) {
-                if (result.isError) {
-                    log('client.fetchFailed', debug, { error: result.content[0].text.substring(0, 150) + (result.content[0].text.length > 150 ? '...' : '') }, COMPONENTS.CLIENT);
-                }
-                else {
-                    const contentLength = result.content[0].text.length;
-                    log('client.fetchSuccess', debug, { length: contentLength }, COMPONENTS.CLIENT);
-                }
+            if (result.isError) {
+                log('client.fetchFailed', debug, { url, error: result.content[0].text }, COMPONENTS.CLIENT);
+            }
+            else {
+                log('client.fetchSuccess', debug, { url }, COMPONENTS.CLIENT);
             }
             return result;
         }
     }
     finally {
         // 关闭客户端连接 (Close client connection)
-        await client.close();
         log('client.serverClosed', debug, {}, COMPONENTS.CLIENT);
+        await client.close();
     }
 }
 /**
@@ -186,6 +179,17 @@ async function main() {
     }
     catch (error) {
         log('client.invalidJson', true, {}, COMPONENTS.CLIENT);
+        // 返回标准错误结构体 (Return standard error structure)
+        const errorResult = {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Invalid JSON parameter: ${paramsJson}`
+                }
+            ]
+        };
+        process.stdout.write(JSON.stringify(errorResult, null, 2));
         process.exit(1);
     }
     const debug = params.debug === true;
@@ -270,6 +274,17 @@ async function main() {
     }
     catch (error) {
         log('client.requestFailed', debug, { error: error.message }, COMPONENTS.CLIENT);
+        // 即使在出错的情况下也输出标准结构体 (Output standard structure even in case of error)
+        const errorResult = {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Client error: ${error.message}`
+                }
+            ]
+        };
+        process.stdout.write(JSON.stringify(errorResult, null, 2));
         process.exit(1);
     }
 }

package/dist/src/lib/BrowserFetcher.js

@@ -88,7 +88,7 @@ export class BrowserFetcher {
             const heapTotal = Math.round(memoryUsage.heapTotal / 1024 / 1024);
             const rss = Math.round(memoryUsage.rss / 1024 / 1024);
             // 记录内存使用情况
-            log('browser.memoryUsage', debug, { heapUsed, heapTotal, rss }, COMPONENTS.BROWSER_FETCH);
+            log('browser.memoryUsage', debug, { usage: heapUsed }, COMPONENTS.BROWSER_FETCH);
             // 如果内存使用过高，记录警告
             if (heapUsed > 500 || rss > 1000) {
                 log('browser.memoryTooHigh', debug, { heapUsed, heapTotal, rss }, COMPONENTS.BROWSER_FETCH);
@@ -473,7 +473,7 @@ export class BrowserFetcher {
             const domain = this.getDomain(url);
             const storedCookies = this.getCookies(domain);
             if (storedCookies && saveCookies) {
-                log('browser.usingStoredCookies', debug, { domain: this.getDomain(url) }, COMPONENTS.BROWSER_FETCH);
+                log('browser.usingStoredCookies', debug, { domain }, COMPONENTS.BROWSER_FETCH);
                 await page.setExtraHTTPHeaders({
                     'Cookie': storedCookies
                 });
@@ -483,7 +483,7 @@ export class BrowserFetcher {
                 log('browser.usingProxy', debug, { proxy: effectiveProxy }, COMPONENTS.BROWSER_FETCH);
             }
             // 导航到URL
-            log('browser.navigating', debug, { debug }, COMPONENTS.BROWSER_FETCH);
+            log('browser.navigating', debug, { url }, COMPONENTS.BROWSER_FETCH);
             await page.goto(url, {
                 waitUntil: 'networkidle2',
                 timeout: timeout
@@ -491,27 +491,27 @@ export class BrowserFetcher {
             // 尝试处理Cloudflare保护
             const bypassedCloudflare = await this.handleCloudflareProtection(page, url, debug);
             if (!bypassedCloudflare) {
-                log('browser.continuingWithoutBypass', debug, { debug }, COMPONENTS.BROWSER_FETCH);
+                log('browser.continuingWithoutBypass', debug, {}, COMPONENTS.BROWSER_FETCH);
             }
             // 等待选择器
-            log('browser.waitingForSelector', debug, { selector: waitForSelector, debug }, COMPONENTS.BROWSER_FETCH);
+            log('browser.waitingForSelector', debug, { selector: waitForSelector }, COMPONENTS.BROWSER_FETCH);
             await page.waitForSelector(waitForSelector, {
                 timeout: timeout
             }).catch(() => { });
             // 等待额外时间
-            log('browser.waitingForTimeout', debug, { timeout: waitForTimeout, debug }, COMPONENTS.BROWSER_FETCH);
+            log('browser.waitingForTimeout', debug, { timeout: waitForTimeout }, COMPONENTS.BROWSER_FETCH);
             await new Promise(resolve => setTimeout(resolve, waitForTimeout));
             // 如果需要滚动到底部
             if (scrollToBottom) {
-                log('browser.scrolling', debug, { debug }, COMPONENTS.BROWSER_FETCH);
+                log('browser.scrolling', debug, {}, COMPONENTS.BROWSER_FETCH);
                 await this.autoScroll(page, debug);
             }
             // 获取页面内容
-            log('browser.gettingContent', debug, { debug }, COMPONENTS.BROWSER_FETCH);
+            log('browser.gettingContent', debug, {}, COMPONENTS.BROWSER_FETCH);
             const content = await page.content();
             // 如果需要保存cookies
             if (saveCookies) {
-                log('browser.savingCookies', debug, { debug }, COMPONENTS.BROWSER_FETCH);
+                log('browser.savingCookies', debug, { domain }, COMPONENTS.BROWSER_FETCH);
                 const cookies = await page.evaluate(() => document.cookie);
                 if (cookies) {
                     this.saveCookies(url, cookies);
@@ -519,16 +519,16 @@ export class BrowserFetcher {
             }
             // 记录内容长度
             const contentLength = content.length;
-            log('browser.contentLength', debug, { length: contentLength, debug }, COMPONENTS.BROWSER_FETCH);
+            log('browser.contentLength', debug, { length: contentLength }, COMPONENTS.BROWSER_FETCH);
             // 如果内容太长，截断它
             let finalContent = content;
             if (contentLength > 10 * 1024 * 1024) { // 10MB
                 finalContent = content.substring(0, 10 * 1024 * 1024);
-                log('browser.contentTruncated', debug, { debug }, COMPONENTS.BROWSER_FETCH);
+                log('browser.contentTruncated', debug, {}, COMPONENTS.BROWSER_FETCH);
             }
             // 关闭页面
             await page.close();
-            log('browser.pageClosed', debug, { debug }, COMPONENTS.BROWSER_FETCH);
+            log('browser.pageClosed', debug, {}, COMPONENTS.BROWSER_FETCH);
             // 如果需要关闭浏览器
             if (closeBrowser) {
                 await this.closeBrowser(debug);

package/dist/src/lib/NodeFetcher.js

@@ -55,16 +55,16 @@ export class NodeFetcher {
             return undefined;
         }
         // 检查环境变量 (Check environment variables)
-        log('fetcher.checkingProxyEnv', true, {}, COMPONENTS.NODE_FETCH);
+        log('node.checkingProxyEnv', true, {}, COMPONENTS.NODE_FETCH);
         const envVars = ['https_proxy', 'HTTPS_PROXY', 'http_proxy', 'HTTP_PROXY'];
         for (const envVar of envVars) {
-            log('fetcher.envVarValue', true, {
+            log('node.envVarValue', true, {
                 envVar,
                 value: process.env[envVar]
             }, COMPONENTS.NODE_FETCH);
             if (process.env[envVar]) {
                 const proxyUrl = process.env[envVar];
-                log('fetcher.foundSystemProxy', true, { proxy: proxyUrl }, COMPONENTS.NODE_FETCH);
+                log('node.foundSystemProxy', true, { proxy: proxyUrl }, COMPONENTS.NODE_FETCH);
                 return proxyUrl;
             }
         }
@@ -72,22 +72,22 @@ export class NodeFetcher {
         try {
             const platform = process.platform;
             let proxyUrl;
-            log('fetcher.checkingSystemEnvVars', true, { platform }, COMPONENTS.NODE_FETCH);
+            log('node.checkingSystemEnvVars', true, { platform }, COMPONENTS.NODE_FETCH);
             if (platform === 'win32') {
                 // Windows系统 - 使用set命令 (Windows - use set command)
                 try {
                     // 使用set命令获取代理环境变量 (Use set command to get proxy environment variables)
                     const setOutput = execSync('set http_proxy & set https_proxy & set HTTP_PROXY & set HTTPS_PROXY').toString();
-                    log('fetcher.windowsEnvVars', true, { output: setOutput.trim() }, COMPONENTS.NODE_FETCH);
+                    log('node.windowsEnvVars', true, { output: setOutput.trim() }, COMPONENTS.NODE_FETCH);
                     // 解析输出找到代理设置 (Parse output to find proxy settings)
                     const proxyMatch = setOutput.match(/(?:http_proxy|https_proxy|HTTP_PROXY|HTTPS_PROXY)=(https?:\/\/[^=\r\n]+)/i);
                     if (proxyMatch && proxyMatch[1]) {
                         proxyUrl = proxyMatch[1].trim();
-                        log('fetcher.foundWindowsEnvProxy', true, { proxy: proxyUrl }, COMPONENTS.NODE_FETCH);
+                        log('node.foundWindowsEnvProxy', true, { proxy: proxyUrl }, COMPONENTS.NODE_FETCH);
                     }
                 }
                 catch (winError) {
-                    log('fetcher.errorGettingWindowsEnvVars', true, { error: String(winError) }, COMPONENTS.NODE_FETCH);
+                    log('node.errorGettingWindowsEnvVars', true, { error: String(winError) }, COMPONENTS.NODE_FETCH);
                 }
             }
             else {
@@ -95,31 +95,31 @@ export class NodeFetcher {
                 try {
                     // 使用env命令获取所有环境变量 (Use env command to get all environment variables)
                     const envOutput = execSync('env').toString();
-                    log('fetcher.unixEnvVars', true, { output: envOutput.length > 200 ? envOutput.substring(0, 200) + '...' : envOutput }, COMPONENTS.NODE_FETCH);
+                    log('node.unixEnvVars', true, { output: envOutput.length > 200 ? envOutput.substring(0, 200) + '...' : envOutput }, COMPONENTS.NODE_FETCH);
                     // 解析输出找到代理设置 (Parse output to find proxy settings)
                     const proxyMatch = envOutput.match(/(?:http_proxy|https_proxy|HTTP_PROXY|HTTPS_PROXY)=(https?:\/\/[^=\n]+)/i);
                     if (proxyMatch && proxyMatch[1]) {
                         proxyUrl = proxyMatch[1].trim();
-                        log('fetcher.foundUnixEnvProxy', true, { proxy: proxyUrl }, COMPONENTS.NODE_FETCH);
+                        log('node.foundUnixEnvProxy', true, { proxy: proxyUrl }, COMPONENTS.NODE_FETCH);
                     }
                 }
                 catch (unixError) {
-                    log('fetcher.errorGettingUnixEnvVars', true, { error: String(unixError) }, COMPONENTS.NODE_FETCH);
+                    log('node.errorGettingUnixEnvVars', true, { error: String(unixError) }, COMPONENTS.NODE_FETCH);
                 }
             }
             if (proxyUrl) {
                 return proxyUrl;
             }
             // 如果没有找到代理，记录日志 (If no proxy is found, log a message)
-            log('fetcher.noSystemProxyFound', true, {}, COMPONENTS.NODE_FETCH);
+            log('node.noSystemProxyFound', true, {}, COMPONENTS.NODE_FETCH);
         }
         catch (error) {
-            log('fetcher.errorGettingSystemEnvVars', true, { error: String(error) }, COMPONENTS.NODE_FETCH);
+            log('node.errorGettingSystemEnvVars', true, { error: String(error) }, COMPONENTS.NODE_FETCH);
         }
         // 检查NO_PROXY环境变量 (Check NO_PROXY environment variable)
         const noProxy = process.env.NO_PROXY || process.env.no_proxy;
         if (noProxy) {
-            log('fetcher.foundNoProxy', true, { noProxy }, COMPONENTS.NODE_FETCH);
+            log('node.foundNoProxy', true, { noProxy }, COMPONENTS.NODE_FETCH);
         }
         return undefined;
     }
@@ -432,14 +432,14 @@ export class NodeFetcher {
      */
     static async txt(requestPayload) {
         const { debug = false } = requestPayload;
-        log('fetcher.startingTxtFetch', debug, {}, COMPONENTS.NODE_FETCH);
+        log('node.startingTxtFetch', debug, {}, COMPONENTS.NODE_FETCH);
         try {
             // 执行请求 (Execute request)
             const response = await this._fetchWithRedirects(requestPayload);
             // 读取响应文本 (Read response text)
-            log('fetcher.readingText', debug, {}, COMPONENTS.NODE_FETCH);
+            log('node.readingText', debug, {}, COMPONENTS.NODE_FETCH);
             const text = await response.text();
-            log('fetcher.textContentLength', debug, { length: text.length }, COMPONENTS.NODE_FETCH);
+            log('node.textContentLength', debug, { length: text.length }, COMPONENTS.NODE_FETCH);
             // 返回纯文本内容 (Return plain text content)
             return {
                 text,
@@ -460,21 +460,21 @@ export class NodeFetcher {
      */
     static async markdown(requestPayload) {
         const { debug = false } = requestPayload;
-        log('fetcher.startingMarkdownFetch', debug, {}, COMPONENTS.NODE_FETCH);
+        log('node.startingMarkdownFetch', debug, {}, COMPONENTS.NODE_FETCH);
         try {
             // 执行请求 (Execute request)
             const response = await this._fetchWithRedirects(requestPayload);
             // 读取响应文本 (Read response text)
-            log('fetcher.readingText', debug, {}, COMPONENTS.NODE_FETCH);
+            log('node.readingText', debug, {}, COMPONENTS.NODE_FETCH);
             const html = await response.text();
-            log('fetcher.htmlContentLength', debug, { length: html.length }, COMPONENTS.NODE_FETCH);
+            log('node.htmlContentLength', debug, { length: html.length }, COMPONENTS.NODE_FETCH);
             // 创建Turndown服务 (Create Turndown service)
-            log('fetcher.creatingTurndown', debug, {}, COMPONENTS.NODE_FETCH);
+            log('node.creatingTurndown', debug, {}, COMPONENTS.NODE_FETCH);
             const turndownService = new TurndownService();
             // 将HTML转换为Markdown (Convert HTML to Markdown)
-            log('fetcher.convertingToMarkdown', debug, {}, COMPONENTS.NODE_FETCH);
+            log('node.convertingToMarkdown', debug, {}, COMPONENTS.NODE_FETCH);
             const markdown = turndownService.turndown(html);
-            log('fetcher.markdownContentLength', debug, { length: markdown.length }, COMPONENTS.NODE_FETCH);
+            log('node.markdownContentLength', debug, { length: markdown.length }, COMPONENTS.NODE_FETCH);
             // 返回Markdown内容 (Return Markdown content)
             return {
                 markdown,

package/dist/src/lib/fetch.js

@@ -0,0 +1,40 @@
+/**
+ * Author: Martin <lmccc.dev@gmail.com>
+ * Co-Author: AI Assistant (Claude)
+ * Description: This code was collaboratively developed by Martin and AI Assistant.
+ */
+import { Fetcher } from './fetchers/index.js';
+/**
+ * 获取HTML内容 (Get HTML content)
+ * @param requestPayload 请求参数 (Request parameters)
+ * @returns HTML内容 (HTML content)
+ */
+export async function fetchHtml(requestPayload) {
+    return await Fetcher.html(requestPayload);
+}
+/**
+ * 获取JSON内容 (Get JSON content)
+ * @param requestPayload 请求参数 (Request parameters)
+ * @returns JSON内容 (JSON content)
+ */
+export async function fetchJson(requestPayload) {
+    return await Fetcher.json(requestPayload);
+}
+/**
+ * 获取纯文本内容 (Get plain text content)
+ * @param requestPayload 请求参数 (Request parameters)
+ * @returns 纯文本内容 (Plain text content)
+ */
+export async function fetchTxt(requestPayload) {
+    return await Fetcher.txt(requestPayload);
+}
+/**
+ * 获取Markdown内容 (Get Markdown content)
+ * @param requestPayload 请求参数 (Request parameters)
+ * @returns Markdown内容 (Markdown content)
+ */
+export async function fetchMarkdown(requestPayload) {
+    return await Fetcher.markdown(requestPayload);
+}
+// 导出所有类型和类 (Export all types and classes)
+export * from './fetchers/index.js';

package/dist/src/lib/fetchers/FetcherFactory.js

@@ -0,0 +1,43 @@
+/**
+ * Author: Martin <lmccc.dev@gmail.com>
+ * Co-Author: AI Assistant (Claude)
+ * Description: This code was collaboratively developed by Martin and AI Assistant.
+ */
+import { BrowserFetcher } from './browser/BrowserFetcher.js';
+import { NodeFetcher } from './node/NodeFetcher.js';
+import { log, COMPONENTS } from '../logger.js';
+/**
+ * 抓取器工厂类 (Fetcher factory class)
+ * 根据请求参数创建合适的抓取器实例 (Create appropriate fetcher instance based on request parameters)
+ */
+export class FetcherFactory {
+    /**
+     * 创建抓取器实例 (Create fetcher instance)
+     * @param requestPayload 请求参数 (Request parameters)
+     * @returns 抓取器实例 (Fetcher instance)
+     */
+    static createFetcher(requestPayload) {
+        const { useBrowser = false, useNodeFetch = false, autoDetectMode = true, debug = false } = requestPayload;
+        // 如果明确指定使用浏览器模式 (If browser mode is explicitly specified)
+        if (useBrowser) {
+            log('factory.using_browser_mode', debug, {}, COMPONENTS.FETCHER_FACTORY);
+            return new BrowserFetcher();
+        }
+        // 如果明确指定使用Node模式 (If Node mode is explicitly specified)
+        if (useNodeFetch) {
+            log('factory.using_node_mode', debug, {}, COMPONENTS.FETCHER_FACTORY);
+            return new NodeFetcher();
+        }
+        // 如果启用自动检测模式 (If auto-detect mode is enabled)
+        if (autoDetectMode) {
+            // 这里可以添加更复杂的逻辑来决定使用哪种模式
+            // 例如，根据URL特征、请求头等判断
+            // 目前简单地默认使用Node模式，因为它更轻量级
+            log('factory.auto_detecting_mode', debug, { defaultToNode: true }, COMPONENTS.FETCHER_FACTORY);
+            return new NodeFetcher();
+        }
+        // 默认使用Node模式 (Default to Node mode)
+        log('factory.defaultingToNodeMode', debug, {}, COMPONENTS.FETCHER_FACTORY);
+        return new NodeFetcher();
+    }
+}