@skills-store/rednote 0.1.7 → 0.1.9

package/README.md

@@ -1,6 +1,6 @@
 # @skills-store/rednote
 
-A Xiaohongshu (RED) automation CLI for browser session management, login, search, feed detail lookup, and profile lookup.
+A Xiaohongshu (RED) automation CLI for browser session management, login, search, feed detail lookup, profile lookup, and note interactions such as like, collect, and commenting through `interact`.
 
 ## Install
 
@@ -27,7 +27,7 @@ For most tasks, run commands in this order:
 3. browser connect
 4. login or check-login
 5. status
-6. home, search, get-feed-detail, or get-profile
+6. home, search, get-feed-detail, get-profile, or interact
 ```
 
 ## Quick start
@@ -39,6 +39,7 @@ rednote browser connect --instance seller-main
 rednote login --instance seller-main
 rednote status --instance seller-main
 rednote search --instance seller-main --keyword 护肤
+rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "写得真好"
 ```
 
 ## Commands
@@ -121,6 +122,16 @@ rednote get-profile --instance seller-main --id USER_ID
 
 Use `get-profile` when you want author or account profile information.
 
+
+### `interact`
+
+```bash
+rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect
+rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "写得真好"
+```
+
+Use `interact` when you want the single entrypoint for note operations such as like, collect, and comment in one command. Use `--comment TEXT` for replies; there is no standalone `comment` command.
+
 ## Important flags
 
 - `--instance NAME` selects the browser instance for account-scoped commands.
@@ -130,6 +141,329 @@ Use `get-profile` when you want author or account profile information.
 - `--keyword` is required for `search`.
 - `--url` is required for `get-feed-detail`.
 - `--id` is required for `get-profile`.
+- `--url` is required for `interact`; at least one of `--like`, `--collect`, or `--comment TEXT` must be provided.
+- replies are sent with `interact --comment TEXT`.
+
+## JSON success shapes
+
+Use these shapes as the success model when a command returns JSON.
+
+### Shared note item
+
+`home`, `search`, and `profile.notes` share the normalized `RednotePost` shape:
+
+```json
+{
+  "id": "string",
+  "modelType": "string",
+  "xsecToken": "string|null",
+  "url": "string",
+  "noteCard": {
+    "type": "string|null",
+    "displayTitle": "string|null",
+    "cover": {
+      "urlDefault": "string|null",
+      "urlPre": "string|null",
+      "url": "string|null",
+      "fileId": "string|null",
+      "width": "number|null",
+      "height": "number|null",
+      "infoList": [{ "imageScene": "string|null", "url": "string|null" }]
+    },
+    "user": {
+      "userId": "string|null",
+      "nickname": "string|null",
+      "nickName": "string|null",
+      "avatar": "string|null",
+      "xsecToken": "string|null"
+    },
+    "interactInfo": {
+      "liked": "boolean",
+      "likedCount": "string|null",
+      "commentCount": "string|null",
+      "collectedCount": "string|null",
+      "sharedCount": "string|null"
+    },
+    "cornerTagInfo": [{ "type": "string|null", "text": "string|null" }],
+    "imageList": [{ "width": "number|null", "height": "number|null", "infoList": [{ "imageScene": "string|null", "url": "string|null" }] }],
+    "video": { "duration": "number|null" }
+  }
+}
+```
+
+### `env --format json`
+
+`env` is the main exception: it returns a raw environment object instead of `{ "ok": true, ... }`.
+
+```json
+{
+  "packageRoot": "string",
+  "homeDir": "string",
+  "platform": "string",
+  "nodeVersion": "string",
+  "storageHome": "string",
+  "storageRoot": "string",
+  "instancesDir": "string",
+  "instanceStorePath": "string",
+  "legacyPackageInstancesDir": "string"
+}
+```
+
+### Browser commands
+
+`browser list`:
+
+```json
+{
+  "lastConnect": { "scope": "default|custom", "name": "string", "browser": "chrome|edge|chromium|brave" } | null,
+  "instances": [{
+    "type": "chrome|edge|chromium|brave",
+    "name": "string",
+    "executablePath": "string",
+    "userDataDir": "string",
+    "exists": true,
+    "inUse": false,
+    "pid": "number|null",
+    "lockFiles": ["string"],
+    "matchedProcess": { "pid": "number", "name": "string", "cmdline": "string" } | null,
+    "staleLock": false,
+    "remotePort": "number|null",
+    "scope": "default|custom",
+    "instanceName": "string",
+    "createdAt": "string|null",
+    "lastConnect": false
+  }]
+}
+```
+
+`browser create`:
+
+```json
+{
+  "ok": true,
+  "instance": {
+    "name": "string",
+    "browser": "chrome|edge|chromium|brave",
+    "userDataDir": "string",
+    "createdAt": "string",
+    "remoteDebuggingPort": "number|undefined"
+  }
+}
+```
+
+`browser connect`:
+
+```json
+{
+  "ok": true,
+  "type": "chrome|edge|chromium|brave",
+  "executablePath": "string",
+  "userDataDir": "string",
+  "remoteDebuggingPort": "number",
+  "wsUrl": "string",
+  "pid": "number|null"
+}
+```
+
+`browser remove`:
+
+```json
+{
+  "ok": true,
+  "removedInstance": {
+    "name": "string",
+    "browser": "chrome|edge|chromium|brave",
+    "userDataDir": "string",
+    "createdAt": "string",
+    "remoteDebuggingPort": "number|undefined"
+  },
+  "removedDir": true,
+  "closedPids": ["number"]
+}
+```
+
+### Session and account commands
+
+`status`:
+
+```json
+{
+  "ok": true,
+  "instance": {
+    "scope": "default|custom",
+    "name": "string",
+    "browser": "chrome|edge|chromium|brave",
+    "source": "argument|last-connect|single-instance",
+    "status": "running|stopped|missing|stale-lock",
+    "exists": true,
+    "inUse": false,
+    "pid": "number|null",
+    "remotePort": "number|null",
+    "userDataDir": "string",
+    "createdAt": "string|null",
+    "lastConnect": false
+  },
+  "rednote": {
+    "loginStatus": "logged-in|logged-out|unknown",
+    "lastLoginAt": "string|null"
+  }
+}
+```
+
+`check-login`:
+
+```json
+{
+  "ok": true,
+  "rednote": {
+    "loginStatus": "logged-in|logged-out|unknown",
+    "lastLoginAt": "string|null",
+    "needLogin": false,
+    "checkedAt": "string"
+  }
+}
+```
+
+`login`:
+
+```json
+{
+  "ok": true,
+  "rednote": {
+    "loginClicked": true,
+    "pageUrl": "string",
+    "waitingForPhoneLogin": true,
+    "message": "string"
+  }
+}
+```
+
+### Feed and profile commands
+
+`home --format json`:
+
+```json
+{
+  "ok": true,
+  "home": {
+    "pageUrl": "string",
+    "fetchedAt": "string",
+    "total": "number",
+    "posts": ["RednotePost"],
+    "savedPath": "string|undefined"
+  }
+}
+```
+
+`search --format json`:
+
+```json
+{
+  "ok": true,
+  "search": {
+    "keyword": "string",
+    "pageUrl": "string",
+    "fetchedAt": "string",
+    "total": "number",
+    "posts": ["RednotePost"],
+    "savedPath": "string|undefined"
+  }
+}
+```
+
+`get-feed-detail --format json`:
+
+```json
+{
+  "ok": true,
+  "detail": {
+    "fetchedAt": "string",
+    "total": "number",
+    "items": [{
+      "url": "string",
+      "note": {
+        "noteId": "string|null",
+        "title": "string|null",
+        "desc": "string|null",
+        "type": "string|null",
+        "interactInfo": {
+          "liked": "boolean|null",
+          "likedCount": "string|null",
+          "commentCount": "string|null",
+          "collected": "boolean|null",
+          "collectedCount": "string|null",
+          "shareCount": "string|null",
+          "followed": "boolean|null"
+        },
+        "tagList": [{ "name": "string|null" }],
+        "imageList": [{ "urlDefault": "string|null", "urlPre": "string|null", "width": "number|null", "height": "number|null" }],
+        "video": { "url": "string|null", "raw": "unknown" } | null,
+        "raw": "unknown"
+      },
+      "comments": [{
+        "id": "string|null",
+        "content": "string|null",
+        "userId": "string|null",
+        "nickname": "string|null",
+        "likedCount": "string|null",
+        "subCommentCount": "number|null",
+        "raw": "unknown"
+      }]
+    }]
+  }
+}
+```
+
+`get-profile --format json`:
+
+```json
+{
+  "ok": true,
+  "profile": {
+    "userId": "string",
+    "url": "string",
+    "fetchedAt": "string",
+    "user": {
+      "userId": "string|null",
+      "nickname": "string|null",
+      "desc": "string|null",
+      "avatar": "string|null",
+      "ipLocation": "string|null",
+      "gender": "string|null",
+      "follows": "string|number|null",
+      "fans": "string|number|null",
+      "interaction": "string|number|null",
+      "tags": ["string"],
+      "raw": "unknown"
+    },
+    "notes": ["RednotePost"],
+    "raw": {
+      "userPageData": "unknown",
+      "notes": "unknown"
+    }
+  }
+}
+```
+
+### Action commands
+
+`publish`:
+
+```json
+{
+  "ok": true,
+  "message": "string"
+}
+```
+
+`interact`:
+
+```json
+{
+  "ok": true,
+  "message": "string"
+}
+```
 
 ## Storage
 

package/dist/index.js

@@ -1,19 +1,26 @@
 #!/usr/bin/env node
+import { createRequire } from 'node:module';
 import { runCli } from './utils/browser-cli.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
 function printRootHelp() {
     process.stdout.write(`rednote
+Version:
+  ${version}
 
 Usage:
   npx -y @skills-store/rednote browser <command> [...args]
   npx -y @skills-store/rednote <command> [...args]
 
 Commands:
+  --version
   browser <list|create|remove|connect>
   env [--format md|json]
   status [--instance NAME]
   check-login [--instance NAME]
   login [--instance NAME]
   publish [--instance NAME]
+  interact [--instance NAME] --url URL [--like] [--collect] [--comment TEXT]
   home [--instance NAME] [--format md|json] [--save [PATH]]
   search [--instance NAME] --keyword TEXT [--format md|json] [--save [PATH]]
   get-feed-detail [--instance NAME] --url URL [--format md|json]
@@ -25,6 +32,7 @@ Examples:
   npx -y @skills-store/rednote browser connect --instance seller-main
   npx -y @skills-store/rednote env
   npx -y @skills-store/rednote publish --instance seller-main --type video --video ./note.mp4 --title 标题 --content 描述
+  npx -y @skills-store/rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "写得真好"
   npx -y @skills-store/rednote search --instance seller-main --keyword 护肤
 `);
 }
@@ -34,6 +42,10 @@ export async function runRootCli(argv = process.argv.slice(2)) {
         printRootHelp();
         return;
     }
+    if (command === '--version' || command === '-v' || command === 'version') {
+        process.stdout.write(`${version}\n`);
+        return;
+    }
     if (command === 'browser') {
         const { runBrowserCli } = await import('./browser/index.js');
         await runBrowserCli(restArgv);

package/dist/rednote/checkLogin.js

@@ -55,9 +55,9 @@ export async function createRednoteSession(target) {
         page
     };
 }
-export function disconnectRednoteSession(session) {
+export async function disconnectRednoteSession(session) {
     try {
-        session.browser._connection?.close();
+        await session.browser.close();
     } catch  {}
 }
 export async function checkRednoteLogin(target, session) {
@@ -91,7 +91,7 @@ export async function checkRednoteLogin(target, session) {
         };
     } finally{
         if (ownsSession) {
-            disconnectRednoteSession(activeSession);
+            await disconnectRednoteSession(activeSession);
         }
     }
 }

package/dist/rednote/getFeedDetail.js

@@ -72,6 +72,20 @@ function validateFeedDetailUrl(url) {
         throw error;
     }
 }
+function normalizeFeedDetailUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (!parsed.searchParams.has('xsec_source')) {
+            parsed.searchParams.set('xsec_source', 'pc_feed');
+        }
+        return parsed.toString();
+    } catch (error) {
+        if (error instanceof TypeError) {
+            throw new Error(`url is not valid: ${url}`);
+        }
+        throw error;
+    }
+}
 async function getOrCreateXiaohongshuPage(session) {
     return session.page;
 }
@@ -87,10 +101,13 @@ function normalizeDetailNote(note) {
         desc: note?.desc ?? null,
         type: note?.type ?? null,
         interactInfo: {
+            liked: note?.interactInfo?.liked ?? null,
             likedCount: note?.interactInfo?.likedCount ?? null,
             commentCount: note?.interactInfo?.commentCount ?? null,
+            collected: note?.interactInfo?.collected ?? null,
             collectedCount: note?.interactInfo?.collectedCount ?? null,
-            shareCount: note?.interactInfo?.shareCount ?? null
+            shareCount: note?.interactInfo?.shareCount ?? null,
+            followed: note?.interactInfo?.followed ?? null
         },
         tagList: Array.isArray(note?.tagList) ? note.tagList.map((tag)=>({
                 name: tag?.name ?? null
@@ -119,45 +136,55 @@ function normalizeComments(comments) {
             raw: comment
         }));
 }
+function formatDetailField(value) {
+    return value ?? '';
+}
 function renderDetailMarkdown(items) {
     if (items.length === 0) {
         return '没有获取到帖子详情。\n';
     }
     return `${items.map((item)=>{
-        const lines = [
-            '<note>'
-        ];
-        lines.push(`### Url: ${item.url}`);
-        lines.push(`### 标题:${item.note.title ?? ''}`);
-        lines.push(`### 内容\n${item.note.desc ?? ''}`);
-        if (item.note.interactInfo.likedCount) {
-            lines.push(`### 点赞: ${item.note.interactInfo.likedCount}`);
-        }
-        if (item.note.interactInfo.commentCount) {
-            lines.push(`### 评论: ${item.note.interactInfo.commentCount}`);
-        }
-        if (item.note.interactInfo.collectedCount) {
-            lines.push(`### 收藏: ${item.note.interactInfo.collectedCount}`);
-        }
-        if (item.note.interactInfo.shareCount) {
-            lines.push(`### 分享: ${item.note.interactInfo.shareCount}`);
-        }
-        if (item.note.tagList.length > 0) {
-            lines.push(`### 标签: ${item.note.tagList.map((tag)=>tag.name ? `#${tag.name}` : '').filter(Boolean).join(' ')}`);
-        }
-        if (item.note.imageList.length > 0) {
-            lines.push(`### 图片\n${item.note.imageList.map((image)=>image.urlDefault ? `![](${image.urlDefault})` : '').filter(Boolean).join('\n')}`);
-        }
-        if (item.note.video?.url) {
-            lines.push(`### 视频\n[](${item.note.video.url})`);
-        }
-        if (item.comments.length > 0) {
-            lines.push('### 评论:');
-            for (const comment of item.comments){
-                lines.push(`- ${comment.content ?? ''}`);
+        const lines = [];
+        lines.push('## Note');
+        lines.push('');
+        lines.push(`- Url: ${item.url}`);
+        lines.push(`- Title: ${formatDetailField(item.note.title)}`);
+        lines.push(`- Type: ${formatDetailField(item.note.type)}`);
+        lines.push(`- Liked: ${formatDetailField(item.note.interactInfo.liked)}`);
+        lines.push(`- Collected: ${formatDetailField(item.note.interactInfo.collected)}`);
+        lines.push(`- LikedCount: ${formatDetailField(item.note.interactInfo.likedCount)}`);
+        lines.push(`- CommentCount: ${formatDetailField(item.note.interactInfo.commentCount)}`);
+        lines.push(`- CollectedCount: ${formatDetailField(item.note.interactInfo.collectedCount)}`);
+        lines.push(`- ShareCount: ${formatDetailField(item.note.interactInfo.shareCount)}`);
+        lines.push(`- Tags: ${item.note.tagList.map((tag)=>tag.name ? `#${tag.name}` : '').filter(Boolean).join(' ')}`);
+        lines.push('');
+        lines.push('## Content');
+        lines.push('');
+        lines.push(item.note.desc ?? '');
+        if (item.note.imageList.length > 0 || item.note.video?.url) {
+            lines.push('');
+            lines.push('## Media');
+            lines.push('');
+            item.note.imageList.forEach((image, index)=>{
+                if (image.urlDefault) {
+                    lines.push(`- Image${index + 1}: ${image.urlDefault}`);
+                }
+            });
+            if (item.note.video?.url) {
+                lines.push(`- Video: ${item.note.video.url}`);
             }
         }
-        lines.push('</note>');
+        lines.push('');
+        lines.push('## Comments');
+        lines.push('');
+        if (item.comments.length === 0) {
+            lines.push('- Comments not found');
+        } else {
+            item.comments.forEach((comment)=>{
+                const prefix = comment.nickname ? `${comment.nickname}: ` : '';
+                lines.push(`- ${prefix}${comment.content ?? ''}`);
+            });
+        }
         return lines.join('\n');
     }).join('\n\n---\n\n')}\n`;
 }
@@ -221,8 +248,9 @@ export async function getFeedDetails(session, urls) {
     const page = await getOrCreateXiaohongshuPage(session);
     const items = [];
     for (const url of urls){
-        validateFeedDetailUrl(url);
-        items.push(await captureFeedDetail(page, url));
+        const normalizedUrl = normalizeFeedDetailUrl(url);
+        validateFeedDetailUrl(normalizedUrl);
+        items.push(await captureFeedDetail(page, normalizedUrl));
     }
     return {
         ok: true,
@@ -258,7 +286,7 @@ export async function runGetFeedDetailCommand(values = {
         const result = await getFeedDetails(session, values.urls);
         writeFeedDetailOutput(result, values.format);
     } finally{
-        disconnectRednoteSession(session);
+        await disconnectRednoteSession(session);
     }
 }
 async function main() {

package/dist/rednote/getProfile.js

@@ -317,7 +317,7 @@ export async function runGetProfileCommand(values = {
         const result = await getProfile(session, buildProfileUrl(normalizedUserId), normalizedUserId);
         writeProfileOutput(result, values.format);
     } finally{
-        disconnectRednoteSession(session);
+        await disconnectRednoteSession(session);
     }
 }
 async function main() {

package/dist/rednote/home.js

@@ -99,7 +99,7 @@ async function collectHomeFeedItems(page) {
                     return;
                 }
                 const url = new URL(response.url());
-                if (!url.href.endsWith('/explore')) {
+                if (url.pathname !== '/explore' && url.pathname !== '/explore/') {
                     return;
                 }
                 const html = await response.text();
@@ -138,12 +138,12 @@ async function collectHomeFeedItems(page) {
         }, 15_000);
         page.on('response', handleResponse);
     });
-    if (page.url().startsWith('https://www.xiaohongshu.com/explore')) {
+    if (page.url() === 'https://www.xiaohongshu.com/explore/') {
         await page.reload({
             waitUntil: 'domcontentloaded'
         });
     } else {
-        await page.goto('https://www.xiaohongshu.com/explore', {
+        await page.goto('https://www.xiaohongshu.com/explore/', {
             waitUntil: 'domcontentloaded'
         });
     }
@@ -196,7 +196,7 @@ export async function runHomeCommand(values = {
         const result = await getRednoteHomePosts(session);
         writeHomeOutput(result, values);
     } finally{
-        disconnectRednoteSession(session);
+        await disconnectRednoteSession(session);
     }
 }
 async function main() {

package/dist/rednote/index.js

@@ -11,6 +11,7 @@ Commands:
   check-login [--instance NAME]
   login [--instance NAME]
   publish [--instance NAME]
+  interact [--instance NAME] --url URL [--like] [--collect] [--comment TEXT]
   home [--instance NAME] [--format md|json] [--save [PATH]]
   search [--instance NAME] --keyword TEXT [--format md|json] [--save [PATH]]
   get-feed-detail [--instance NAME] --url URL [--url URL] [--format md|json]
@@ -23,6 +24,7 @@ Examples:
   npx -y @skills-store/rednote status --instance seller-main
   npx -y @skills-store/rednote login --instance seller-main
   npx -y @skills-store/rednote publish --instance seller-main --type video --video ./note.mp4 --title 标题 --content 描述
+  npx -y @skills-store/rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "写得真好"
   npx -y @skills-store/rednote home --instance seller-main --format md --save
   npx -y @skills-store/rednote search --instance seller-main --keyword 护肤 --format json --save ./output/search.jsonl
   npx -y @skills-store/rednote get-feed-detail --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
@@ -99,6 +101,11 @@ export async function runRednoteCli(argv = process.argv.slice(2)) {
         await runPublishCommand(parsePublishCliArgs(commandArgv));
         return;
     }
+    if (command === 'interact') {
+        const { parseInteractCliArgs, runInteractCommand } = await import('./interact.js');
+        await runInteractCommand(parseInteractCliArgs(commandArgv));
+        return;
+    }
     if (command === 'home') {
         const { parseHomeCliArgs, runHomeCommand } = await import('./home.js');
         await runHomeCommand(parseHomeCliArgs(commandArgv));

package/dist/rednote/interact.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { printJson, runCli } from '../utils/browser-cli.js';
+import { resolveStatusTarget } from './status.js';
+import { createRednoteSession, disconnectRednoteSession, ensureRednoteLoggedIn } from './checkLogin.js';
+import { getFeedDetails } from './getFeedDetail.js';
+const INTERACT_CONTAINER_SELECTOR = '.interact-container';
+const LIKE_WRAPPER_SELECTOR = `${INTERACT_CONTAINER_SELECTOR} .like-wrapper`;
+const COLLECT_WRAPPER_SELECTOR = `${INTERACT_CONTAINER_SELECTOR} .collect-wrapper, ${INTERACT_CONTAINER_SELECTOR} #note-page-collect-board-guide`;
+const COMMENT_INPUT_SELECTOR = '#content-textarea[contenteditable="true"]';
+const COMMENT_SEND_BUTTON_SELECTOR = 'button.btn.submit';
+const COMMENT_SEND_BUTTON_TEXT = '发送';
+function printInteractHelp() {
+    process.stdout.write(`rednote interact
+
+Usage:
+  npx -y @skills-store/rednote interact [--instance NAME] --url URL [--like] [--collect] [--comment TEXT]
+  node --experimental-strip-types ./scripts/rednote/interact.ts --instance NAME --url URL [--like] [--collect] [--comment TEXT]
+  bun ./scripts/rednote/interact.ts --instance NAME --url URL [--like] [--collect] [--comment TEXT]
+
+Options:
+  --instance NAME   Optional. Defaults to the saved lastConnect instance
+  --url URL         Required. Xiaohongshu explore url
+  --like            Optional. Perform like
+  --collect         Optional. Perform collect
+  --comment TEXT    Optional. Post comment content
+  -h, --help        Show this help
+`);
+}
+export function parseInteractCliArgs(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        strict: false,
+        options: {
+            instance: {
+                type: 'string'
+            },
+            url: {
+                type: 'string'
+            },
+            like: {
+                type: 'boolean'
+            },
+            collect: {
+                type: 'boolean'
+            },
+            comment: {
+                type: 'string'
+            },
+            help: {
+                type: 'boolean',
+                short: 'h'
+            }
+        }
+    });
+    if (positionals.length > 0) {
+        throw new Error(`Unexpected positional arguments: ${positionals.join(' ')}`);
+    }
+    return {
+        instance: values.instance,
+        url: values.url,
+        like: values.like,
+        collect: values.collect,
+        comment: values.comment,
+        help: values.help
+    };
+}
+function ensureNonEmpty(value, optionName) {
+    const normalized = value?.trim();
+    if (!normalized) {
+        throw new Error(`Missing required option: ${optionName}`);
+    }
+    return normalized;
+}
+function validateFeedDetailUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (!parsed.href.startsWith('https://www.xiaohongshu.com/explore/')) {
+            throw new Error(`url is not valid: ${url},must start with "https://www.xiaohongshu.com/explore/"`);
+        }
+        if (!parsed.searchParams.get('xsec_token')) {
+            throw new Error(`url is not valid: ${url},must include "xsec_token="`);
+        }
+    } catch (error) {
+        if (error instanceof TypeError) {
+            throw new Error(`url is not valid: ${url}`);
+        }
+        throw error;
+    }
+}
+function resolveInteractActions(values) {
+    const actions = [];
+    if (values.like) {
+        actions.push('like');
+    }
+    if (values.collect) {
+        actions.push('collect');
+    }
+    const commentContent = values.comment?.trim();
+    if (commentContent) {
+        actions.push('comment');
+    }
+    if (actions.length === 0) {
+        throw new Error('At least one interact option is required: --like, --collect, or --comment');
+    }
+    return {
+        actions,
+        commentContent
+    };
+}
+async function getOrCreateXiaohongshuPage(session) {
+    return session.page;
+}
+async function findVisibleLocator(locator, timeoutMs = 5_000) {
+    const deadline = Date.now() + timeoutMs;
+    while(Date.now() < deadline){
+        const count = await locator.count();
+        for(let index = 0; index < count; index += 1){
+            const candidate = locator.nth(index);
+            if (await candidate.isVisible().catch(()=>false)) {
+                return candidate;
+            }
+        }
+        await new Promise((resolve)=>setTimeout(resolve, 100));
+    }
+    return null;
+}
+async function requireVisibleLocator(locator, errorMessage, timeoutMs = 5_000) {
+    const visibleLocator = await findVisibleLocator(locator, timeoutMs);
+    if (!visibleLocator) {
+        throw new Error(errorMessage);
+    }
+    return visibleLocator;
+}
+async function typeCommentContent(page, content) {
+    const commentInput = page.locator(COMMENT_INPUT_SELECTOR);
+    const visibleCommentInput = await requireVisibleLocator(commentInput, '未找到评论输入框，请确认帖子详情页已正确加载。', 15_000);
+    await visibleCommentInput.scrollIntoViewIfNeeded();
+    await visibleCommentInput.click({
+        force: true
+    });
+    await page.keyboard.press(process.platform === 'darwin' ? 'Meta+A' : 'Control+A').catch(()=>{});
+    await page.keyboard.press('Backspace').catch(()=>{});
+    await page.keyboard.insertText(content);
+    await page.waitForFunction(({ selector, expectedContent })=>{
+        const element = document.querySelector(selector);
+        if (!(element instanceof HTMLElement)) {
+            return false;
+        }
+        return element.innerText.trim() === expectedContent;
+    }, {
+        selector: COMMENT_INPUT_SELECTOR,
+        expectedContent: content
+    }, {
+        timeout: 5_000
+    });
+}
+async function clickSendComment(page) {
+    const sendButton = page.locator(COMMENT_SEND_BUTTON_SELECTOR).filter({
+        hasText: COMMENT_SEND_BUTTON_TEXT
+    });
+    const visibleSendButton = await requireVisibleLocator(sendButton, '未找到“发送”按钮，请确认评论工具栏已正确加载。', 15_000);
+    await page.waitForFunction(({ selector, text })=>{
+        const buttons = [
+            ...document.querySelectorAll(selector)
+        ];
+        const target = buttons.find((candidate)=>candidate.textContent?.includes(text));
+        return target instanceof HTMLButtonElement && !target.disabled;
+    }, {
+        selector: COMMENT_SEND_BUTTON_SELECTOR,
+        text: COMMENT_SEND_BUTTON_TEXT
+    }, {
+        timeout: 5_000
+    });
+    await visibleSendButton.click();
+    await page.waitForFunction(({ inputSelector, buttonSelector, text })=>{
+        const input = document.querySelector(inputSelector);
+        const buttons = [
+            ...document.querySelectorAll(buttonSelector)
+        ];
+        const button = buttons.find((candidate)=>candidate.textContent?.includes(text));
+        const inputCleared = input instanceof HTMLElement ? input.innerText.trim().length === 0 : false;
+        const buttonDisabled = button instanceof HTMLButtonElement ? button.disabled : false;
+        return inputCleared || buttonDisabled;
+    }, {
+        inputSelector: COMMENT_INPUT_SELECTOR,
+        buttonSelector: COMMENT_SEND_BUTTON_SELECTOR,
+        text: COMMENT_SEND_BUTTON_TEXT
+    }, {
+        timeout: 10_000
+    });
+}
+async function commentOnCurrentFeedPage(page, content) {
+    await typeCommentContent(page, content);
+    await clickSendComment(page);
+}
+async function waitForInteractContainer(page) {
+    await page.waitForLoadState('domcontentloaded');
+    await page.waitForTimeout(500);
+    await requireVisibleLocator(page.locator(INTERACT_CONTAINER_SELECTOR), '未找到互动工具栏，请确认帖子详情页已正确加载。', 15_000);
+}
+function getActionErrorMessage(action) {
+    return action === 'like' ? '未找到点赞按钮，请确认帖子详情页已正确加载。' : '未找到收藏按钮，请确认帖子详情页已正确加载。';
+}
+async function ensureActionApplied(page, action, alreadyActive) {
+    if (alreadyActive) {
+        return true;
+    }
+    const locator = page.locator(action === 'like' ? LIKE_WRAPPER_SELECTOR : COLLECT_WRAPPER_SELECTOR);
+    const visibleLocator = await requireVisibleLocator(locator, getActionErrorMessage(action), 15_000);
+    await visibleLocator.scrollIntoViewIfNeeded();
+    await visibleLocator.click({
+        force: true
+    });
+    await page.waitForFunction(({ selector, currentAction })=>{
+        const nodes = [
+            ...document.querySelectorAll(selector)
+        ];
+        const target = nodes.find((candidate)=>candidate instanceof HTMLElement && candidate.offsetParent !== null);
+        if (!(target instanceof HTMLElement)) {
+            return false;
+        }
+        const classNames = [
+            ...target.classList
+        ].map((item)=>item.toLowerCase());
+        if (classNames.includes(`${currentAction}-active`) || classNames.includes('active') || classNames.some((item)=>item.endsWith('-active'))) {
+            return true;
+        }
+        const iconRefs = [
+            ...target.querySelectorAll('use')
+        ].map((node)=>(node.getAttribute('xlink:href') ?? node.getAttribute('href') ?? '').toLowerCase()).filter(Boolean).join(' ');
+        if (currentAction === 'like') {
+            return iconRefs.includes('liked') || iconRefs.includes('like-filled') || iconRefs.includes('like_fill');
+        }
+        return iconRefs.includes('collected') || iconRefs.includes('collect-filled') || iconRefs.includes('collect_fill');
+    }, {
+        selector: action === 'like' ? LIKE_WRAPPER_SELECTOR : COLLECT_WRAPPER_SELECTOR,
+        currentAction: action
+    }, {
+        timeout: 10_000
+    });
+    return false;
+}
+export async function interactWithFeed(session, url, actions, commentContent) {
+    validateFeedDetailUrl(url);
+    const detailResult = await getFeedDetails(session, [
+        url
+    ]);
+    const detailItem = detailResult.detail.items[0];
+    if (!detailItem) {
+        throw new Error(`Failed to load feed detail: ${url}`);
+    }
+    const page = await getOrCreateXiaohongshuPage(session);
+    await waitForInteractContainer(page);
+    let liked = detailItem.note.interactInfo.liked === true;
+    let collected = detailItem.note.interactInfo.collected === true;
+    const messages = [];
+    for (const action of actions){
+        if (action === 'like') {
+            const alreadyActive = liked;
+            await ensureActionApplied(page, 'like', alreadyActive);
+            liked = true;
+            messages.push(alreadyActive ? 'Like already active' : 'Like completed');
+            continue;
+        }
+        if (action === 'collect') {
+            const alreadyActive = collected;
+            await ensureActionApplied(page, 'collect', alreadyActive);
+            collected = true;
+            messages.push(alreadyActive ? 'Collect already active' : 'Collect completed');
+            continue;
+        }
+        const normalizedContent = ensureNonEmpty(commentContent, '--comment');
+        await commentOnCurrentFeedPage(page, normalizedContent);
+        messages.push('Comment posted');
+    }
+    return {
+        ok: true,
+        message: `${messages.join('; ')}: ${url}`
+    };
+}
+export async function runInteractCommand(values = {}) {
+    if (values.help) {
+        printInteractHelp();
+        return;
+    }
+    const url = ensureNonEmpty(values.url, '--url');
+    const { actions, commentContent } = resolveInteractActions(values);
+    const target = resolveStatusTarget(values.instance);
+    const session = await createRednoteSession(target);
+    try {
+        await ensureRednoteLoggedIn(target, `performing ${actions.join(', ')} interact`, session);
+        const result = await interactWithFeed(session, url, actions, commentContent);
+        printJson(result);
+    } finally{
+        await disconnectRednoteSession(session);
+    }
+}
+async function main() {
+    const values = parseInteractCliArgs(process.argv.slice(2));
+    await runInteractCommand(values);
+}
+runCli(import.meta.url, main);

package/dist/rednote/login.js

@@ -79,7 +79,7 @@ export async function runLoginCommand(values = {}) {
         const result = await openRednoteLogin(target, session);
         printJson(result);
     } finally{
-        disconnectRednoteSession(session);
+        await disconnectRednoteSession(session);
     }
 }
 async function main() {

package/dist/rednote/publish.js

@@ -483,7 +483,7 @@ export async function runPublishCommand(values) {
         const result = await openRednotePublish(session, payload);
         printJson(result);
     } finally{
-        disconnectRednoteSession(session);
+        await disconnectRednoteSession(session);
     }
 }
 async function main() {

package/dist/rednote/search.js

@@ -193,7 +193,7 @@ export async function runSearchCommand(values = {
         const result = await searchRednotePosts(session, keyword);
         writeSearchOutput(result, values);
     } finally{
-        disconnectRednoteSession(session);
+        await disconnectRednoteSession(session);
     }
 }
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skills-store/rednote",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "private": false,
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
     "check-login": "node --experimental-strip-types ./scripts/rednote/checkLogin.ts",
     "login": "node --experimental-strip-types ./scripts/rednote/login.ts",
     "publish": "node --experimental-strip-types ./scripts/rednote/publish.ts",
+    "interact": "node --experimental-strip-types ./scripts/rednote/interact.ts",
     "home": "node --experimental-strip-types ./scripts/rednote/home.ts",
     "search": "node --experimental-strip-types ./scripts/rednote/search.ts",
     "get-feed-detail": "node --experimental-strip-types ./scripts/rednote/getFeedDetail.ts",
@@ -27,6 +28,7 @@
     "bun:check-login": "bun ./scripts/rednote/checkLogin.ts",
     "bun:login": "bun ./scripts/rednote/login.ts",
     "bun:publish": "bun ./scripts/rednote/publish.ts",
+    "bun:interact": "bun ./scripts/rednote/interact.ts",
     "bun:home": "bun ./scripts/rednote/home.ts",
     "bun:search": "bun ./scripts/rednote/search.ts",
     "bun:get-feed-detail": "bun ./scripts/rednote/getFeedDetail.ts",