@skills-store/rednote 0.1.14 → 0.1.15

package/README.md

@@ -36,10 +36,10 @@ For most tasks, run commands in this order:
 rednote env
 rednote browser create --name seller-main --browser chrome --port 9222
 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 "写得真好"
+rednote login
+rednote status
+rednote search --keyword 护肤
+rednote interact --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "写得真好"
 ```
 
 ## Commands
@@ -68,7 +68,7 @@ Use `env` first when checking installation, runtime info, or storage paths.
 ### `status`
 
 ```bash
-rednote status --instance seller-main
+rednote status
 ```
 
 Use `status` to confirm whether an instance exists, is running, and appears logged in.
@@ -76,7 +76,7 @@ Use `status` to confirm whether an instance exists, is running, and appears logg
 ### `check-login`
 
 ```bash
-rednote check-login --instance seller-main
+rednote check-login
 ```
 
 Use `check-login` when you only want to verify whether the session is still valid.
@@ -84,7 +84,7 @@ Use `check-login` when you only want to verify whether the session is still vali
 ### `login`
 
 ```bash
-rednote login --instance seller-main
+rednote login
 ```
 
 Use `login` after `browser connect` if the instance is not authenticated yet.
@@ -92,7 +92,7 @@ Use `login` after `browser connect` if the instance is not authenticated yet.
 ### `home`
 
 ```bash
-rednote home --instance seller-main --format md --save
+rednote home --format md --save
 ```
 
 Use `home` when you want the current home feed and optionally want to save it to disk.
@@ -103,6 +103,10 @@ The terminal output always uses the compact summary format below, even when `--f
 id=<database nanoid>
 title=<post title>
 like=<liked count>
+
+id=...
+title=...
+like=...
 ```
 
 Captured home feed posts are upserted into `~/.skills-router/rednote/main.db` (the same path returned by `rednote env`). They are stored in the `rednote_posts` table, and the printed `id` is that table's `nanoid(16)` primary key.
@@ -110,8 +114,8 @@ Captured home feed posts are upserted into `~/.skills-router/rednote/main.db` (t
 ### `search`
 
 ```bash
-rednote search --instance seller-main --keyword 护肤
-rednote search --instance seller-main --keyword 护肤 --format json --save ./output/search.jsonl
+rednote search --keyword 护肤
+rednote search --keyword 护肤 --format json --save ./output/search.jsonl
 ```
 
 Use `search` for keyword-based note lookup.
@@ -129,8 +133,8 @@ Captured search results are also upserted into `~/.skills-router/rednote/main.db
 ### `get-feed-detail`
 
 ```bash
-rednote get-feed-detail --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
-rednote get-feed-detail --instance seller-main --id AynQ7_utnNiW1Ytk
+rednote get-feed-detail --id <nanoid>
+rednote get-feed-detail --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
 ```
 
 Use `get-feed-detail` when you already have a Xiaohongshu note URL, or when you have a database `id` returned by `home` or `search`. With `--id`, the CLI looks up the saved URL from `~/.skills-router/rednote/main.db` and then navigates with that raw URL.
@@ -140,7 +144,7 @@ Captured note details and comments are also upserted into `~/.skills-router/redn
 ### `get-profile`
 
 ```bash
-rednote get-profile --instance seller-main --id USER_ID
+rednote get-profile --id USER_ID
 ```
 
 Use `get-profile` when you want author or account profile information.
@@ -149,8 +153,8 @@ 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 "写得真好"
+rednote interact --id <nanoid> --like --collect
+rednote interact --id <nanoid> --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.
@@ -168,318 +172,6 @@ Use `interact` when you want the single entrypoint for note operations such as l
 - `--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",
-  "databasePath": "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,
-    "qrCodePath": "string|null",
-    "message": "string"
-  }
-}
-```
-
-### Feed and profile commands
-
-`home` stdout (both `md` and `json`):
-
-```text
-id=<database nanoid>
-title=<post title>
-like=<liked count>
-```
-
-`home --format json --save PATH` writes the raw `RednotePost[]` array to disk, while stdout still prints the summary list above.
-
-`search` stdout (both `md` and `json`):
-
-```text
-id=<database nanoid>
-title=<post title>
-like=<liked count>
-```
-
-`search --format json --save PATH` writes the raw `RednotePost[]` array to disk, while stdout still prints the summary list above.
-
-`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
 
 The CLI stores browser instances and metadata under:

package/dist/index.js

@@ -20,7 +20,7 @@ Commands:
   check-login [--instance NAME]
   login [--instance NAME]
   publish [--instance NAME]
-  interact [--instance NAME] --url URL [--like] [--collect] [--comment TEXT]
+  interact [--instance NAME] [--id ID | --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]
@@ -32,7 +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 interact --instance seller-main --id NOTE_ID --like --collect --comment "写得真好"
   npx -y @skills-store/rednote search --instance seller-main --keyword 护肤
 `);
 }

package/dist/rednote/index.js

@@ -11,7 +11,7 @@ Commands:
   check-login [--instance NAME]
   login [--instance NAME]
   publish [--instance NAME]
-  interact [--instance NAME] --url URL [--like] [--collect] [--comment TEXT]
+  interact [--instance NAME] [--id ID | --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] [--comments [COUNT]] [--format md|json] [--save PATH]
@@ -25,7 +25,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 "Video title" --content "Video description"
-  npx -y @skills-store/rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "Great post"
+  npx -y @skills-store/rednote interact --instance seller-main --id NOTE_ID --like --collect --comment "Great post"
   npx -y @skills-store/rednote home --instance seller-main --format md --save
   npx -y @skills-store/rednote search --instance seller-main --keyword skincare --format json --save ./output/search.json
   npx -y @skills-store/rednote get-feed-detail --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --comments 100 --format json --save ./output/feed-detail.json

package/dist/rednote/interact.js

@@ -4,6 +4,7 @@ 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';
+import { findPersistedPostUrlByRecordId, initializeRednoteDatabase } from './persistence.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`;
@@ -14,13 +15,14 @@ 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]
+  npx -y @skills-store/rednote interact [--instance NAME] [--id ID | --url URL] [--like] [--collect] [--comment TEXT]
+  node --experimental-strip-types ./scripts/rednote/interact.ts [--instance NAME] [--id ID | --url URL] [--like] [--collect] [--comment TEXT]
+  bun ./scripts/rednote/interact.ts [--instance NAME] [--id ID | --url URL] [--like] [--collect] [--comment TEXT]
 
 Options:
   --instance NAME   Optional. Defaults to the saved lastConnect instance
-  --url URL         Required. Xiaohongshu explore url
+  --id ID           Optional. Database record id from home/search output
+  --url URL         Optional. Xiaohongshu explore url
   --like            Optional. Perform like
   --collect         Optional. Perform collect
   --comment TEXT    Optional. Post comment content
@@ -36,6 +38,9 @@ export function parseInteractCliArgs(argv) {
             instance: {
                 type: 'string'
             },
+            id: {
+                type: 'string'
+            },
             url: {
                 type: 'string'
             },
@@ -59,6 +64,7 @@ export function parseInteractCliArgs(argv) {
     }
     return {
         instance: values.instance,
+        id: values.id,
         url: values.url,
         like: values.like,
         collect: values.collect,
@@ -253,8 +259,8 @@ export async function interactWithFeed(session, url, actions, commentContent) {
     }
     const page = await getOrCreateXiaohongshuPage(session);
     await waitForInteractContainer(page);
-    let liked = detailItem.note.interactInfo.liked === true;
-    let collected = detailItem.note.interactInfo.collected === true;
+    let liked = detailItem.note.liked === true;
+    let collected = detailItem.note.collected === true;
     const messages = [];
     for (const action of actions){
         if (action === 'like') {
@@ -280,17 +286,34 @@ export async function interactWithFeed(session, url, actions, commentContent) {
         message: `${messages.join('; ')}: ${url}`
     };
 }
+async function resolveInteractUrl(values, instanceName) {
+    if (values.id) {
+        if (!instanceName) {
+            throw new Error('The --id option requires an instance-backed session.');
+        }
+        const url = await findPersistedPostUrlByRecordId(instanceName, ensureNonEmpty(values.id, '--id'));
+        if (!url) {
+            throw new Error(`No saved post url found for id: ${values.id}`);
+        }
+        return url;
+    }
+    if (values.url) {
+        return ensureNonEmpty(values.url, '--url');
+    }
+    throw new Error('Missing required option: --id or --url');
+}
 export async function runInteractCommand(values = {}) {
     if (values.help) {
         printInteractHelp();
         return;
     }
-    const url = ensureNonEmpty(values.url, '--url');
     const { actions, commentContent } = resolveInteractActions(values);
+    await initializeRednoteDatabase();
     const target = resolveStatusTarget(values.instance);
     const session = await createRednoteSession(target);
     try {
         await ensureRednoteLoggedIn(target, `performing ${actions.join(', ')} interact`, session);
+        const url = await resolveInteractUrl(values, target.instanceName);
         const result = await interactWithFeed(session, url, actions, commentContent);
         printJson(result);
     } finally{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skills-store/rednote",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "private": false,
   "type": "module",
   "bin": {