xhs-mcp 0.6.0 → 0.7.1

package/README.en.md

@@ -1,14 +1,8 @@
----
-noteId: "de25fbc0988c11f0a5c2e10de4f705bc"
-tags: []
-
----
-
 # xhs-mcp
 
 English | [简体中文](./README.md)
 
-Unified CLI `xhs-cli` with built-in MCP server subcommand. Automate XiaoHongShu (xiaohongshu.com) with Puppeteer: login, publishing, search, feed discovery, and commenting via MCP and CLI.
+Unified CLI `xhs-mcp` with built-in MCP server subcommand. Automate XiaoHongShu (xiaohongshu.com) with Puppeteer: login, publishing, search, feed discovery, and commenting via MCP and CLI.
 
 [![npm version](https://img.shields.io/npm/v/xhs-mcp.svg)](https://www.npmjs.com/package/xhs-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/xhs-mcp.svg)](https://www.npmjs.com/package/xhs-mcp)
@@ -17,8 +11,8 @@ Unified CLI `xhs-cli` with built-in MCP server subcommand. Automate XiaoHongShu
 ## 📦 NPM
 
 - Package: `xhs-mcp`
-- Run CLI: `npx xhs-cli <subcommand>`
-- Start MCP: `npx xhs-cli mcp [--mode stdio|http] [--port 3000]`
+- Run CLI: `npx xhs-mcp <subcommand>`
+- Start MCP: `npx xhs-mcp mcp [--mode stdio|http] [--port 3000]`
 
 ## ✨ Features
 
@@ -39,16 +33,16 @@ Unified CLI `xhs-cli` with built-in MCP server subcommand. Automate XiaoHongShu
 ## 🚀 Quick Start (MCP)
 
 ```bash
-npx xhs-cli mcp
+npx xhs-mcp mcp
 
 # Debug logs
-XHS_ENABLE_LOGGING=true npx xhs-cli mcp
+XHS_ENABLE_LOGGING=true npx xhs-mcp mcp
 ```
 
 > First run tip: if Puppeteer browsers are not installed yet, run
 >
 > ```bash
-> npx xhs-cli browser    # auto-check and install Chromium, shows executable path
+> npx xhs-mcp browser    # auto-check and install Chromium, shows executable path
 > # or
 > npx puppeteer browsers install chrome
 > ```
@@ -68,24 +62,24 @@ XHS_ENABLE_LOGGING=true npx xhs-cli mcp
 Verify MCP connection:
 
 ```bash
-echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx xhs-cli mcp
+echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx xhs-mcp mcp
 ```
 
 ## 🧰 CLI
 
 ```bash
-npx xhs-cli login --timeout 120
-npx xhs-cli logout
-npx xhs-cli status
- npx xhs-cli browser  # check and install Chromium, shows executable path
- npx xhs-cli feeds
- npx xhs-cli search -k keyword
- npx xhs-cli note-detail --feed-id <id> --xsec-token <token>
- npx xhs-cli comment --feed-id <id> --xsec-token <token> -n "Nice!"
- npx xhs-cli publish --type image --title Title --content Content -m path1.jpg,path2.png --tags a,b
- npx xhs-cli publish --type video --title Title --content Content -m video.mp4 --tags a,b
- npx xhs-cli tools [--detailed] [--json]
- npx xhs-cli mcp --mode http --port 3000
+npx xhs-mcp login --timeout 120
+npx xhs-mcp logout
+npx xhs-mcp status
+ npx xhs-mcp browser  # check and install Chromium, shows executable path
+ npx xhs-mcp feeds
+ npx xhs-mcp search -k keyword
+ npx xhs-mcp note-detail --feed-id <id> --xsec-token <token>
+ npx xhs-mcp comment --feed-id <id> --xsec-token <token> -n "Nice!"
+ npx xhs-mcp publish --type image --title Title --content Content -m path1.jpg,path2.png --tags a,b
+ npx xhs-mcp publish --type video --title Title --content Content -m video.mp4 --tags a,b
+ npx xhs-mcp tools [--detailed] [--json]
+ npx xhs-mcp mcp --mode http --port 3000
 ```
 
 ## 🔧 Client Integration (Cursor)
@@ -97,7 +91,7 @@ npx xhs-cli status
   "mcpServers": {
     "xhs-mcp": {
       "command": "npx",
-      "args": ["xhs-cli", "mcp"],
+      "args": ["xhs-mcp", "mcp"],
       "env": { "XHS_ENABLE_LOGGING": "true" }
     }
   }
@@ -113,10 +107,3 @@ npx xhs-cli status
 ## 🙏 Acknowledgments
 
 Based on and extended from [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (refactored to TypeScript, improved MCP implementation, log cleanup, published to NPM).
-
-## 📚 Docs
-
-- HTTP Transports: `docs/HTTP_TRANSPORTS.md`
-- Publish Features: `docs/PUBLISH_FEATURES.md`
-- Architecture Design: `docs/PUBLISH_ARCHITECTURE.md`
-

package/README.md

@@ -2,7 +2,7 @@
 
 简体中文 | [English](./README.en.md)
 
-`xhs-mcp` 提供统一的命令行入口 `xhs-cli`，并内置 MCP 服务器子命令。用于小红书（xiaohongshu.com）的 Model Context Protocol（MCP）服务器与 CLI 工具，支持登录、发布、搜索、推荐等自动化能力（基于 Puppeteer）。
+`xhs-mcp` 提供统一的命令行入口 `xhs-mcp`，并内置 MCP 服务器子命令。用于小红书（xiaohongshu.com）的 Model Context Protocol（MCP）服务器与 CLI 工具，支持登录、发布、搜索、推荐等自动化能力（基于 Puppeteer）。
 
 [![npm version](https://img.shields.io/npm/v/xhs-mcp.svg)](https://www.npmjs.com/package/xhs-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/xhs-mcp.svg)](https://www.npmjs.com/package/xhs-mcp)
@@ -11,8 +11,8 @@
 ## 📦 NPM 信息
 
 - 包名: `xhs-mcp`
-- 运行 CLI（推荐）: `npx xhs-cli <subcommand>`
-- 启动 MCP：`npx xhs-cli mcp [--mode stdio|http] [--port 3000]`
+- 运行 CLI（推荐）: `npx xhs-mcp <subcommand>`
+- 启动 MCP：`npx xhs-mcp mcp [--mode stdio|http] [--port 3000]`
 
 ## ✨ 功能
 
@@ -35,16 +35,16 @@
 ### Stdio 模式（默认）
 
 ```bash
-npx xhs-cli mcp
+npx xhs-mcp mcp
 
 # 调试日志
-XHS_ENABLE_LOGGING=true npx xhs-cli mcp
+XHS_ENABLE_LOGGING=true npx xhs-mcp mcp
 ```
 
 > 首次运行提示：如果未安装 Puppeteer 浏览器，先执行
 >
 > ```bash
-> npx xhs-cli browser    # 自动检查并安装 Chromium，显示可执行路径
+> npx xhs-mcp browser    # 自动检查并安装 Chromium，显示可执行路径
 > # 或
 > npx puppeteer browsers install chrome
 > ```
@@ -64,20 +64,20 @@ XHS_ENABLE_LOGGING=true npx xhs-cli mcp
 验证 MCP 连接：
 
 ```bash
-echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx xhs-cli mcp
+echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx xhs-mcp mcp
 ```
 
 ### HTTP 模式
 
 ```bash
 # 启动 HTTP 服务器（默认端口 3000）
-npx xhs-cli mcp --mode http
+npx xhs-mcp mcp --mode http
 
 # 指定端口
-npx xhs-cli mcp --mode http --port 8080
+npx xhs-mcp mcp --mode http --port 8080
 
 # 调试模式
-XHS_ENABLE_LOGGING=true npx xhs-cli mcp --mode http
+XHS_ENABLE_LOGGING=true npx xhs-mcp mcp --mode http
 ```
 
 HTTP 服务器支持：
@@ -91,30 +91,30 @@ HTTP 服务器支持：
 
 ```bash
 # 认证
-npx xhs-cli login --timeout 120
-npx xhs-cli logout
-npx xhs-cli status
+npx xhs-mcp login --timeout 120
+npx xhs-mcp logout
+npx xhs-mcp status
 
 # 浏览器依赖
-npx xhs-cli browser [--with-deps]  # 检查并安装 Chromium，显示可执行路径
+npx xhs-mcp browser [--with-deps]  # 检查并安装 Chromium，显示可执行路径
 
 # 发现与检索
-npx xhs-cli feeds [-b /path/to/chromium]
-npx xhs-cli search -k 关键字 [-b /path/to/chromium]
-npx xhs-cli note-detail --feed-id <id> --xsec-token <token> [-b /path/to/chromium]
+npx xhs-mcp feeds [-b /path/to/chromium]
+npx xhs-mcp search -k 关键字 [-b /path/to/chromium]
+npx xhs-mcp note-detail --feed-id <id> --xsec-token <token> [-b /path/to/chromium]
 
 # 互动
-npx xhs-cli comment --feed-id <id> --xsec-token <token> -n "Nice!" [-b /path/to/chromium]
+npx xhs-mcp comment --feed-id <id> --xsec-token <token> -n "Nice!" [-b /path/to/chromium]
 
 # 发布
-npx xhs-cli publish --type image --title 标题 --content 内容 -m path1.jpg,path2.png --tags a,b [-b /path/to/chromium]
-npx xhs-cli publish --type video --title 视频标题 --content 视频描述 -m path/to/video.mp4 --tags a,b [-b /path/to/chromium]
+npx xhs-mcp publish --type image --title 标题 --content 内容 -m path1.jpg,path2.png --tags a,b [-b /path/to/chromium]
+npx xhs-mcp publish --type video --title 视频标题 --content 视频描述 -m path/to/video.mp4 --tags a,b [-b /path/to/chromium]
 
 # 查看可用工具
-npx xhs-cli tools [--detailed] [--json]
+npx xhs-mcp tools [--detailed] [--json]
 
 # 启动 MCP
-npx xhs-cli mcp [--mode stdio|http] [--port 3000]
+npx xhs-mcp mcp [--mode stdio|http] [--port 3000]
 ```
 
 ## 🔧 客户端接入（Cursor）
@@ -128,7 +128,7 @@ npx xhs-cli mcp [--mode stdio|http] [--port 3000]
   "mcpServers": {
     "xhs-mcp": {
       "command": "npx",
-      "args": ["xhs-cli", "mcp"],
+      "args": ["xhs-mcp", "mcp"],
       "env": { "XHS_ENABLE_LOGGING": "true" }
     }
   }
@@ -144,7 +144,7 @@ npx xhs-cli mcp [--mode stdio|http] [--port 3000]
   "mcpServers": {
     "xhs-mcp-http": {
       "command": "npx",
-      "args": ["xhs-cli", "mcp", "--mode", "http", "--port", "3000"],
+      "args": ["xhs-mcp", "mcp", "--mode", "http", "--port", "3000"],
       "env": { "XHS_ENABLE_LOGGING": "true" }
     }
   }
@@ -172,9 +172,3 @@ npx xhs-cli mcp [--mode stdio|http] [--port 3000]
 ## 🙏 致谢
 
 基于 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 重构与扩展（TypeScript、Puppeteer、MCP 优化、日志清理、NPM 发布）。
-
-## 📚 文档
-
-- HTTP Transports：`docs/HTTP_TRANSPORTS.md`
-- 发布功能：`docs/PUBLISH_FEATURES.md`
-- 架构设计：`docs/PUBLISH_ARCHITECTURE.md`

package/dist/cli/{xhs-cli.d.ts → cli.d.ts}

@@ -3,4 +3,4 @@
  * Unified CLI for XiaoHongShu operations
  */
 export {};
-//# sourceMappingURL=xhs-cli.d.ts.map
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli/{xhs-cli.js → cli.js}

@@ -21,7 +21,7 @@ async function main() {
             .replace(/[\u2500-\u257F]+/g, '') // box-drawing characters
             .trim();
         if (/Executable doesn't exist|puppeteer browsers install/i.test(raw)) {
-            return 'Chromium is not installed. Run: npx puppeteer browsers install chrome or xhs-cli browser';
+            return 'Chromium is not installed. Run: npx puppeteer browsers install chrome or xhs-mcp browser';
         }
         return condensed || (error instanceof Error ? error.message : String(error));
     }
@@ -45,7 +45,7 @@ async function main() {
         writeJson(payload, 1);
     }
     program
-        .name('xhs-cli')
+        .name('xhs-mcp')
         .description('XiaoHongShu CLI with subcommands')
         .option('--compact', 'Output compact one-line JSON (no pretty print)')
         .showHelpAfterError();
@@ -113,7 +113,7 @@ async function main() {
         if (browserInfo.canLaunch) {
             printSuccess({
                 installed: true,
-                executablePath: browserInfo.executablePath
+                executablePath: browserInfo.executablePath,
             }, 'Chromium is ready');
             return;
         }
@@ -126,7 +126,7 @@ async function main() {
             printSuccess({
                 installed: true,
                 executablePath: afterInstallInfo.executablePath,
-                exitCode: result.status ?? null
+                exitCode: result.status ?? null,
             }, 'Chromium installed and ready');
         }
         else {
@@ -216,7 +216,10 @@ async function main() {
                 printError(new Error('Type must be "image" or "video"'));
                 return;
             }
-            const mediaPaths = opts.media.split(',').map(s => s.trim()).filter(Boolean);
+            const mediaPaths = opts.media
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean);
             const result = await publishService.publishContent(opts.type, opts.title, opts.content, mediaPaths, opts.tags, opts.browserPath);
             printSuccess(result);
         }
@@ -260,9 +263,9 @@ async function main() {
                     console.log(JSON.stringify(toolSchemas, null, 2));
                 }
                 else {
-                    const toolNames = toolSchemas.map(tool => ({
+                    const toolNames = toolSchemas.map((tool) => ({
                         name: tool.name,
-                        description: tool.description
+                        description: tool.description,
                     }));
                     console.log(JSON.stringify(toolNames, null, 2));
                 }
@@ -273,13 +276,14 @@ async function main() {
                     console.log(`${index + 1}. ${tool.name}`);
                     console.log(`   ${tool.description}`);
                     if (opts.detailed) {
-                        const required = tool.inputSchema.required || [];
-                        const properties = tool.inputSchema.properties || {};
+                        const required = tool.inputSchema.required ?? [];
+                        const properties = tool.inputSchema.properties ?? {};
                         if (Object.keys(properties).length > 0) {
                             console.log('   Parameters:');
                             Object.entries(properties).forEach(([key, prop]) => {
                                 const requiredMark = required.includes(key) ? ' (required)' : ' (optional)';
-                                console.log(`     - ${key}: ${prop.description || 'No description'}${requiredMark}`);
+                                const propDesc = prop.description;
+                                console.log(`     - ${key}: ${propDesc ?? 'No description'}${requiredMark}`);
                             });
                         }
                     }
@@ -297,4 +301,4 @@ async function main() {
     program.parseAsync(process.argv);
 }
 main();
-//# sourceMappingURL=xhs-cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"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"}

package/dist/lib/browser/browser-pool.service.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Browser Pool Service for XHS Operations
+ * Manages browser instance lifecycle with pooling, health monitoring, and automatic cleanup
+ */
+import { Browser, BrowserContext } from 'puppeteer';
+import { Config } from '../shared/types.js';
+export interface ManagedBrowser {
+    browser: Browser;
+    context: BrowserContext;
+    id: string;
+    createdAt: Date;
+    lastUsed: Date;
+    isAvailable: boolean;
+    isHealthy: boolean;
+    usageCount: number;
+}
+export interface BrowserPoolStats {
+    totalInstances: number;
+    availableInstances: number;
+    busyInstances: number;
+    unhealthyInstances: number;
+    totalUsage: number;
+    averageAge: number;
+    oldestInstance: Date | null;
+    newestInstance: Date | null;
+}
+export interface BrowserPoolOptions {
+    minInstances?: number;
+    maxInstances?: number;
+    idleTimeout?: number;
+    maxAge?: number;
+    healthCheckInterval?: number;
+    maxUsageCount?: number;
+}
+export declare class BrowserPoolService {
+    private config;
+    private pool;
+    private options;
+    private healthCheckTimer;
+    private cleanupTimer;
+    private isShuttingDown;
+    constructor(config?: Config, options?: BrowserPoolOptions);
+    /**
+     * Acquire a browser instance from the pool
+     */
+    acquireBrowser(options?: {
+        timeout?: number;
+    }): Promise<ManagedBrowser>;
+    /**
+     * Release a browser instance back to the pool
+     */
+    releaseBrowser(browser: ManagedBrowser): Promise<void>;
+    /**
+     * Get current pool statistics
+     */
+    getPoolStats(): BrowserPoolStats;
+    /**
+     * Cleanup and shutdown the browser pool
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Create a new browser instance
+     */
+    private createBrowserInstance;
+    /**
+     * Find an available healthy browser in the pool
+     */
+    private findAvailableBrowser;
+    /**
+     * Check if a browser should be retired
+     */
+    private shouldRetireBrowser;
+    /**
+     * Perform health check on a browser instance
+     */
+    private checkBrowserHealth;
+    /**
+     * Remove a browser from the pool
+     */
+    private removeBrowserFromPool;
+    /**
+     * Handle browser disconnection
+     */
+    private handleBrowserDisconnection;
+    /**
+     * Ensure minimum number of instances are available
+     */
+    private ensureMinimumInstances;
+    /**
+     * Get count of available browsers
+     */
+    private getAvailableCount;
+    /**
+     * Start health monitoring
+     */
+    private startHealthMonitoring;
+    /**
+     * Start cleanup monitoring for idle browsers
+     */
+    private startCleanupMonitoring;
+    /**
+     * Generate unique browser ID
+     */
+    private generateBrowserId;
+}
+export declare function getBrowserPool(): BrowserPoolService;
+export declare function cleanupBrowserPool(): Promise<void>;
+//# sourceMappingURL=browser-pool.service.d.ts.map

package/dist/lib/browser/browser-pool.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-pool.service.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/browser-pool.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAkB,EAAE,OAAO,EAAE,cAAc,EAAQ,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAM5C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,IAAI,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAA0C;IACtD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAiBzD;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IA8C7E;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC5D;;OAEG;IACH,YAAY,IAAI,gBAAgB;IAkChC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B9B;;OAEG;YACW,qBAAqB;IAqDnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;YACW,kBAAkB;IAkBhC;;OAEG;YACW,qBAAqB;IAgBnC;;OAEG;YACW,0BAA0B;IAYxC;;OAEG;YACW,sBAAsB;IAwBpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqC9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAG1B;AAKD,wBAAgB,cAAc,IAAI,kBAAkB,CAKnD;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKxD"}