@lucasygu/redbook 0.3.3 → 0.5.0

package/README.md

@@ -24,9 +24,12 @@ npm install -g @lucasygu/redbook
 clawhub install redbook
 ```
 
-需要 Node.js >= 22。使用 Chrome 浏览器的 Cookie —— 请先在 Chrome 中登录 xiaohongshu.com。
+需要 Node.js >= 22。支持 **macOS、Windows、Linux**。使用 Chrome 浏览器的 Cookie —— 请先在 Chrome 中登录 xiaohongshu.com。
 
-安装后运行 `redbook whoami` 验证连接。如果遇到 macOS 钥匙串弹窗，请点击"始终允许"。CLI 会自动检测所有 Chrome 配置文件，找到你的小红书登录状态。
+安装后运行 `redbook whoami` 验证连接。CLI 会自动检测所有 Chrome 配置文件，找到你的小红书登录状态。
+
+- **macOS** —— 如果遇到钥匙串弹窗，请点击"始终允许"
+- **Windows** —— Chrome 127+ 使用了 App-Bound Encryption，CLI 会自动启动 Chrome headless 模式读取 Cookie（需要先关闭 Chrome）。如果自动提取失败，可以用 `--cookie-string` 手动传入
 
 ## 能做什么
 
@@ -34,6 +37,7 @@ clawhub install redbook
 - **竞品分析** —— 找到头部博主，对比粉丝量、互动数据、内容风格
 - **爆款拆解** —— 分析爆款笔记的标题钩子、互动比例、评论主题
 - **爆款模板** —— 从多篇爆款笔记提取内容模板（标题结构、正文结构、钩子模式）
+- **收藏管理** —— 查看收藏列表、收藏/取消收藏笔记（支持自己和其他用户的公开收藏）
 - **评论管理** —— 发评论、回复评论、按策略批量回复（问题优先 / 高赞优先 / 未回复优先）
 - **图文卡片** —— Markdown 渲染为小红书风格的 PNG 图文卡片（7 种配色主题）
 - **内容策划** —— 基于数据发现内容机会，生成有数据支撑的选题建议
@@ -66,6 +70,14 @@ redbook user-posts <userId>
 # 搜索话题标签
 redbook topics "Claude Code"
 
+# 查看收藏（默认当前用户）
+redbook favorites --json
+redbook favorites <userId> --json --all
+
+# 收藏/取消收藏
+redbook collect "<noteUrl>"
+redbook uncollect "<noteUrl>"
+
 # 分析爆款笔记
 redbook analyze-viral https://www.xiaohongshu.com/explore/abc123
 
@@ -104,6 +116,9 @@ redbook post --title "测试" --body "..." --images img.png --private
 | `feed` | 获取推荐页内容 |
 | `post` | 发布图文笔记（易触发验证码，详见下方说明） |
 | `topics <关键词>` | 搜索话题/标签 |
+| `favorites [userId]` | 查看收藏笔记列表（默认当前用户） |
+| `collect <url>` | 收藏（书签）笔记 |
+| `uncollect <url>` | 取消收藏笔记 |
 | `analyze-viral <url>` | 分析爆款笔记（钩子、互动、结构） |
 | `viral-template <url...>` | 从 1-3 篇爆款笔记提取内容模板 |
 | `comment <url>` | 发表评论 |
@@ -117,6 +132,7 @@ redbook post --title "测试" --body "..." --images img.png --private
 |------|------|--------|
 | `--cookie-source <浏览器>` | Cookie 来源浏览器（chrome, safari, firefox） | `chrome` |
 | `--chrome-profile <名称>` | Chrome 配置文件目录名（如 "Profile 1"），默认自动检测 | 自动 |
+| `--cookie-string <cookies>` | 手动传入 Cookie 字符串：`"a1=值; web_session=值"`（从 Chrome DevTools 复制） | 无 |
 | `--json` | JSON 格式输出 | `false` |
 
 ### 搜索选项
@@ -180,13 +196,20 @@ npm install -g puppeteer-core marked
 | 问题 | 解决方案 |
 |------|----------|
 | `No 'a1' cookie found` | 在 Chrome 中登录 xiaohongshu.com，然后重试 |
+| Windows 上 `-101` 错误 | Chrome 127+ 的 App-Bound Encryption 导致。先**关闭 Chrome**，再运行命令（CLI 会自动启动 Chrome headless 读取 Cookie）。如仍失败，用 `--cookie-string` 手动传入 |
+| Windows `--cookie-string` 用法 | Chrome 按 F12 → Application → Cookies → xiaohongshu.com，复制 `a1` 和 `web_session` 的值：`redbook whoami --cookie-string "a1=值; web_session=值"` |
 | macOS 钥匙串弹窗 | 输入密码后点击"始终允许"，CLI 需要读取 Chrome 的加密 Cookie |
-| 多个 Chrome 配置文件 | CLI 自动扫描所有配置文件。如需指定：`--chrome-profile "Profile 1"` |
+| 多个 Chrome 配置文件 | CLI 自动扫描所有配置文件（macOS / Windows / Linux）。如需指定：`--chrome-profile "Profile 1"` |
 | 使用 Brave/Arc 等浏览器 | 尝试 `--cookie-source safari`，或在 Chrome 中登录 |
 
 ## 工作原理
 
-`redbook` 从 Chrome 读取小红书的登录 Cookie（通过 [@steipete/sweet-cookie](https://github.com/nicklockwood/sweet-cookie)），然后用 TypeScript 实现的签名算法对 API 请求签名。无需浏览器自动化，无需 headless Chrome —— 纯 HTTP 请求。
+`redbook` 从 Chrome 读取小红书的登录 Cookie，然后用 TypeScript 实现的签名算法对 API 请求签名。
+
+**三层 Cookie 提取策略：**
+1. **sweet-cookie**（快速路径）—— 直接读取 Chrome 的 SQLite 数据库，macOS 上即开即用
+2. **CDP 回退**（Windows 自动触发）—— 启动 Chrome headless，通过 DevTools Protocol 读取 Cookie，绕过 Chrome 127+ 的 App-Bound Encryption
+3. **`--cookie-string`**（手动兜底）—— 从 Chrome DevTools 复制 Cookie 字符串，任何平台通用
 
 **两套签名系统：**
 - **主 API**（`edith.xiaohongshu.com`）—— 读取：搜索、推荐页、笔记、评论、用户资料。使用 144 字节 x-s 签名（v4.3.1）
@@ -300,9 +323,12 @@ npm install -g @lucasygu/redbook
 clawhub install redbook
 ```
 
-Requires Node.js >= 22. Uses cookies from your Chrome browser session — you must be logged into xiaohongshu.com in Chrome.
+Requires Node.js >= 22. Supports **macOS, Windows, and Linux**. Uses cookies from your Chrome browser session — you must be logged into xiaohongshu.com in Chrome.
 
-After installing, run `redbook whoami` to verify the connection. If macOS shows a Keychain prompt, click "Always Allow". The CLI auto-detects all Chrome profiles to find your XHS session.
+After installing, run `redbook whoami` to verify the connection. The CLI auto-detects all Chrome profiles to find your XHS session.
+
+- **macOS** — If Keychain prompt appears, click "Always Allow"
+- **Windows** — Chrome 127+ uses App-Bound Encryption. The CLI auto-launches Chrome headless to read cookies (close Chrome first). If auto-extraction fails, use `--cookie-string` as fallback
 
 ## What You Can Do
 
@@ -310,6 +336,7 @@ After installing, run `redbook whoami` to verify the connection. If macOS shows
 - **Competitive analysis** — Find top creators, compare followers, engagement, content style
 - **Viral note breakdown** — Analyze title hooks, engagement ratios, comment themes
 - **Viral templates** — Extract content templates from multiple viral notes (hook patterns, body structure, engagement profile)
+- **Favorites management** — List collected notes, collect/uncollect notes (own and other users' public collections)
 - **Comment management** — Post comments, reply to comments, batch-reply with strategies (questions / top-engaged / unanswered)
 - **Image cards** — Render markdown to styled PNG cards for XHS posts (7 color themes)
 - **Content planning** — Discover content opportunities with data-backed topic suggestions
@@ -342,6 +369,14 @@ redbook user-posts <userId>
 # Search hashtags
 redbook topics "Claude Code"
 
+# List favorites (defaults to current user)
+redbook favorites --json
+redbook favorites <userId> --json --all
+
+# Collect/uncollect notes
+redbook collect "<noteUrl>"
+redbook uncollect "<noteUrl>"
+
 # Analyze a viral note
 redbook analyze-viral https://www.xiaohongshu.com/explore/abc123
 
@@ -380,6 +415,9 @@ redbook post --title "测试" --body "..." --images img.png --private
 | `feed` | Get homepage feed |
 | `post` | Publish an image note (captcha-prone, see below) |
 | `topics <keyword>` | Search for topics/hashtags |
+| `favorites [userId]` | List collected/favorited notes (defaults to current user) |
+| `collect <url>` | Collect (bookmark) a note |
+| `uncollect <url>` | Remove a note from your collection |
 | `analyze-viral <url>` | Analyze why a viral note works (hooks, engagement, structure) |
 | `viral-template <url...>` | Extract a content template from 1-3 viral notes |
 | `comment <url>` | Post a top-level comment |
@@ -393,6 +431,7 @@ redbook post --title "测试" --body "..." --images img.png --private
 |--------|-------------|---------|
 | `--cookie-source <browser>` | Browser to read cookies from (chrome, safari, firefox) | `chrome` |
 | `--chrome-profile <name>` | Chrome profile directory name (e.g., "Profile 1"). Auto-detected if omitted. | auto |
+| `--cookie-string <cookies>` | Manual cookie string: `"a1=VALUE; web_session=VALUE"` (from Chrome DevTools) | none |
 | `--json` | Output as JSON | `false` |
 
 ### Search Options
@@ -456,13 +495,20 @@ Publishing **frequently triggers captcha** (type=124). Image upload works, but t
 | Problem | Solution |
 |---------|----------|
 | `No 'a1' cookie found` | Log into xiaohongshu.com in Chrome, then retry |
+| Windows `-101` error | Chrome 127+ App-Bound Encryption. **Close Chrome first**, then re-run (CLI auto-launches Chrome headless to read cookies). If it still fails, use `--cookie-string` |
+| Windows `--cookie-string` | Press F12 in Chrome → Application → Cookies → xiaohongshu.com. Copy `a1` and `web_session` values: `redbook whoami --cookie-string "a1=VALUE; web_session=VALUE"` |
 | macOS Keychain prompt | Enter your password and click "Always Allow" — the CLI needs to decrypt Chrome's cookies |
-| Multiple Chrome profiles | The CLI auto-scans all profiles. To pick one: `--chrome-profile "Profile 1"` |
+| Multiple Chrome profiles | The CLI auto-scans all profiles (macOS / Windows / Linux). To pick one: `--chrome-profile "Profile 1"` |
 | Using Brave/Arc/other | Try `--cookie-source safari`, or log into xiaohongshu.com in Chrome |
 
 ## How It Works
 
-`redbook` reads your XHS session cookies from Chrome (via [@steipete/sweet-cookie](https://github.com/nicklockwood/sweet-cookie)) and signs API requests using a TypeScript port of the XHS signing algorithm. No browser automation, no headless Chrome — just HTTP requests.
+`redbook` reads your XHS session cookies from Chrome and signs API requests using a TypeScript port of the XHS signing algorithm.
+
+**Three-tier cookie extraction:**
+1. **sweet-cookie** (fast path) — reads Chrome's SQLite cookie database directly. Works instantly on macOS
+2. **CDP fallback** (auto on Windows) — launches Chrome headless and reads cookies via DevTools Protocol, bypassing Chrome 127+ App-Bound Encryption
+3. **`--cookie-string`** (manual fallback) — paste cookie values from Chrome DevTools. Works on any platform
 
 **Two signing systems:**
 - **Main API** (`edith.xiaohongshu.com`) — for reading: search, feed, notes, comments, user profiles. Uses x-s signature with 144-byte payload (v4.3.1).

package/SKILL.md

@@ -3,7 +3,7 @@ description: Search, read, analyze, and automate Xiaohongshu (小红书) content
 allowed-tools: Bash, Read, Write, Glob, Grep
 # OpenClaw / ClawHub metadata (clawhub install redbook)
 name: redbook
-version: 0.3.3
+version: 0.5.0
 metadata:
   openclaw:
     requires:
@@ -53,6 +53,9 @@ Use the `redbook` CLI to search notes, read content, analyze creators, automate
 | Post a comment | `redbook comment <url> --content "text"` |
 | Reply to comment | `redbook reply <url> --comment-id <id> --content "text"` |
 | Batch reply (preview) | `redbook batch-reply <url> --strategy questions --dry-run` |
+| List favorites | `redbook favorites --json` or `redbook favorites <userId> --json` |
+| Collect a note | `redbook collect <url>` |
+| Remove from collection | `redbook uncollect <url>` |
 | Render markdown to cards | `redbook render content.md --style xiaohongshu` |
 | Check connection | `redbook whoami` |
 
@@ -598,8 +601,8 @@ XHS enforces aggressive anti-spam (风控) that detects automated behavior throu
 ## API vs Browser Limitations
 
 The following operations work reliably via API:
-- **Reading**: search, notes, comments, user profiles, feed
-- **Writing**: top-level comments, comment replies
+- **Reading**: search, notes, comments, user profiles, feed, favorites
+- **Writing**: top-level comments, comment replies, collect/uncollect notes
 - **Analysis**: viral scoring, template extraction, batch reply planning
 
 The following operations are unreliable via API (frequently trigger captcha):
@@ -608,7 +611,7 @@ The following operations are unreliable via API (frequently trigger captcha):
 
 The following operations require browser automation (not supported by this CLI):
 - Captcha solving, real-time notifications
-- Like/collect/follow (heavy anti-automation enforcement)
+- Like/follow (heavy anti-automation enforcement)
 - DM/private messaging
 - Cover image generation (use external tools like Gemini/DALL-E)
 
@@ -685,6 +688,37 @@ Search for topic hashtags. Useful for finding trending topics to attach to posts
 redbook topics "Claude Code" --json
 ```
 
+### `redbook favorites [userId]`
+
+List a user's collected (bookmarked) notes. Defaults to the current logged-in user when no userId is provided.
+
+```bash
+redbook favorites --json                        # Your own favorites
+redbook favorites "5a1234567890abcdef" --json   # Another user's favorites
+redbook favorites --all --json                  # Fetch all pages
+```
+
+**Options:**
+- `--all`: Fetch all pages of favorites (default: first page only)
+
+**Note:** Other users' favorites are only visible if they haven't set their collection to private.
+
+### `redbook collect <url>`
+
+Collect (bookmark) a note to your favorites.
+
+```bash
+redbook collect "https://www.xiaohongshu.com/explore/abc123"
+```
+
+### `redbook uncollect <url>`
+
+Remove a note from your collection.
+
+```bash
+redbook uncollect "https://www.xiaohongshu.com/explore/abc123"
+```
+
 ### `redbook analyze-viral <url>`
 
 Analyze why a viral note works. Returns a deterministic viral score (0–100).

package/dist/cli.d.ts

@@ -12,6 +12,9 @@
  *   redbook feed --cookie-source chrome --json
  *   redbook post --title "..." --body "..." --images img1.jpg --cookie-source chrome
  *   redbook topics "keyword" --cookie-source chrome
+ *   redbook favorites --cookie-source chrome --json
+ *   redbook collect <url> --cookie-source chrome
+ *   redbook uncollect <url> --cookie-source chrome
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -12,13 +12,16 @@
  *   redbook feed --cookie-source chrome --json
  *   redbook post --title "..." --body "..." --images img1.jpg --cookie-source chrome
  *   redbook topics "keyword" --cookie-source chrome
+ *   redbook favorites --cookie-source chrome --json
+ *   redbook collect <url> --cookie-source chrome
+ *   redbook uncollect <url> --cookie-source chrome
  */
 import { Command } from "commander";
 import kleur from "kleur";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
-import { extractCookies } from "./lib/cookies.js";
+import { extractCookies, parseCookieString } from "./lib/cookies.js";
 import { XhsClient, XhsApiError } from "./lib/client.js";
 import { analyzeViral, formatViralAnalysis } from "./lib/analyze.js";
 import { selectCandidates, executeReplies, DEFAULT_DELAY_MS, MIN_DELAY_MS as MIN_REPLY_DELAY, MAX_REPLIES_HARD_CAP, } from "./lib/reply-strategy.js";
@@ -34,12 +37,23 @@ program
 function addCookieOption(cmd) {
     return cmd
         .option("--cookie-source <browser>", "Browser to read cookies from (chrome, safari, firefox)", "chrome")
-        .option("--chrome-profile <name>", 'Chrome profile directory name (e.g., "Profile 1")');
+        .option("--chrome-profile <name>", 'Chrome profile directory name (e.g., "Profile 1")')
+        .option("--cookie-string <cookies>", 'Manual cookie string: "a1=VALUE; web_session=VALUE" (from Chrome DevTools)');
 }
 function addJsonOption(cmd) {
     return cmd.option("--json", "Output as JSON");
 }
-async function getClient(cookieSource, chromeProfile) {
+async function getClient(cookieSource, chromeProfile, cookieString) {
+    if (cookieString) {
+        const cookies = parseCookieString(cookieString);
+        if (!cookies.a1 || !cookies.web_session) {
+            console.error(kleur.red("Cookie string must contain at least 'a1' and 'web_session'. " +
+                "Copy them from Chrome DevTools > Application > Cookies > xiaohongshu.com"));
+            process.exit(1);
+        }
+        console.error(kleur.dim("Using manual cookie string."));
+        return new XhsClient(cookies);
+    }
     const cookies = await extractCookies(cookieSource, chromeProfile);
     return new XhsClient(cookies);
 }
@@ -71,7 +85,7 @@ addCookieOption(whoamiCmd);
 addJsonOption(whoamiCmd);
 whoamiCmd.action(async (opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const info = await client.getSelfInfo();
         if (opts.json) {
             output(info, true);
@@ -100,7 +114,7 @@ addCookieOption(searchCmd);
 addJsonOption(searchCmd);
 searchCmd.action(async (keyword, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const sortMap = {
             general: "general",
             popular: "popularity_descending",
@@ -141,7 +155,7 @@ addCookieOption(readCmd);
 addJsonOption(readCmd);
 readCmd.action(async (url, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const { noteId, xsecToken } = parseNoteUrl(url);
         let result;
         if (opts.api || xsecToken) {
@@ -186,7 +200,7 @@ addCookieOption(commentsCmd);
 addJsonOption(commentsCmd);
 commentsCmd.action(async (url, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const { noteId, xsecToken } = parseNoteUrl(url);
         const allComments = [];
         let cursor = "";
@@ -224,7 +238,7 @@ addCookieOption(userCmd);
 addJsonOption(userCmd);
 userCmd.action(async (userId, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const info = await client.getUserInfo(userId);
         output(info, opts.json ?? false);
     }
@@ -240,7 +254,7 @@ addCookieOption(userPostsCmd);
 addJsonOption(userPostsCmd);
 userPostsCmd.action(async (userId, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const result = await client.getUserNotes(userId);
         if (opts.json) {
             output(result, true);
@@ -268,7 +282,7 @@ addCookieOption(feedCmd);
 addJsonOption(feedCmd);
 feedCmd.action(async (opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const result = await client.getHomeFeed(opts.category);
         output(result, opts.json ?? false);
     }
@@ -289,7 +303,7 @@ addCookieOption(postCmd);
 addJsonOption(postCmd);
 postCmd.action(async (opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const imageFiles = opts.images ?? [];
         if (imageFiles.length === 0) {
             console.error(kleur.red("At least one image is required. Use --images <path>"));
@@ -345,7 +359,7 @@ addCookieOption(topicsCmd);
 addJsonOption(topicsCmd);
 topicsCmd.action(async (keyword, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const result = await client.searchTopics(keyword);
         if (opts.json) {
             output(result, true);
@@ -362,6 +376,94 @@ topicsCmd.action(async (keyword, opts) => {
         handleError(err);
     }
 });
+// ─── favorites ──────────────────────────────────────────────────────────────
+const favoritesCmd = program
+    .command("favorites [userId]")
+    .description("List a user's collected/favorited notes (defaults to current user)")
+    .option("--all", "Fetch all pages");
+addCookieOption(favoritesCmd);
+addJsonOption(favoritesCmd);
+favoritesCmd.action(async (userId, opts) => {
+    try {
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
+        if (!userId) {
+            const me = (await client.getSelfInfo());
+            userId = String(me.user_id ?? "");
+            if (!userId) {
+                console.error(kleur.red("Could not determine current user ID"));
+                process.exit(1);
+            }
+        }
+        const allNotes = [];
+        let cursor = "";
+        let hasMore = true;
+        while (hasMore) {
+            const res = (await client.getUserCollectedNotes(userId, 30, cursor));
+            if (res.notes)
+                allNotes.push(...res.notes);
+            hasMore = opts.all ? (res.has_more ?? false) : false;
+            cursor = res.cursor ?? "";
+        }
+        if (opts.json) {
+            output(allNotes, true);
+        }
+        else {
+            for (const note of allNotes) {
+                const n = note;
+                const user = n.user;
+                console.log(`${kleur.bold(String(n.display_title ?? n.title ?? "(no title)"))}  ${kleur.dim(String(n.note_id ?? ""))}  ${kleur.dim(`@${user?.nickname ?? "?"}`)}`);
+            }
+            console.log(kleur.dim(`\n${allNotes.length} collected notes`));
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+// ─── collect ────────────────────────────────────────────────────────────────
+const collectCmd = program
+    .command("collect <url>")
+    .description("Collect (bookmark) a note");
+addCookieOption(collectCmd);
+addJsonOption(collectCmd);
+collectCmd.action(async (url, opts) => {
+    try {
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
+        const { noteId } = parseNoteUrl(url);
+        const result = await client.collectNote(noteId);
+        if (opts.json) {
+            output(result, true);
+        }
+        else {
+            console.log(kleur.green("Note collected!"));
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+// ─── uncollect ──────────────────────────────────────────────────────────────
+const uncollectCmd = program
+    .command("uncollect <url>")
+    .description("Remove a note from your collection");
+addCookieOption(uncollectCmd);
+addJsonOption(uncollectCmd);
+uncollectCmd.action(async (url, opts) => {
+    try {
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
+        const { noteId } = parseNoteUrl(url);
+        const result = await client.uncollectNote(noteId);
+        if (opts.json) {
+            output(result, true);
+        }
+        else {
+            console.log(kleur.green("Note removed from collection!"));
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
 // ─── analyze-viral ──────────────────────────────────────────────────────────
 const analyzeViralCmd = program
     .command("analyze-viral <url>")
@@ -371,7 +473,7 @@ addCookieOption(analyzeViralCmd);
 addJsonOption(analyzeViralCmd);
 analyzeViralCmd.action(async (url, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const { noteId, xsecToken } = parseNoteUrl(url);
         // 1. Fetch the note (same pattern as `read` — prefer HTML, API when xsec_token present)
         let note;
@@ -478,7 +580,7 @@ viralTemplateCmd.action(async (urls, opts) => {
             console.error(kleur.red("Maximum 3 URLs allowed"));
             process.exit(1);
         }
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const commentPages = Math.min(parseInt(opts.commentPages) || 3, 10);
         const analyses = [];
         for (const url of urls) {
@@ -584,7 +686,7 @@ addCookieOption(commentCmd);
 addJsonOption(commentCmd);
 commentCmd.action(async (url, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const { noteId } = parseNoteUrl(url);
         const result = await client.postComment(noteId, opts.content);
         if (opts.json) {
@@ -609,7 +711,7 @@ addCookieOption(replyCmd);
 addJsonOption(replyCmd);
 replyCmd.action(async (url, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const { noteId } = parseNoteUrl(url);
         const result = await client.replyComment(noteId, opts.commentId, opts.content);
         if (opts.json) {
@@ -637,7 +739,7 @@ addCookieOption(batchReplyCmd);
 addJsonOption(batchReplyCmd);
 batchReplyCmd.action(async (url, opts) => {
     try {
-        const client = await getClient(opts.cookieSource, opts.chromeProfile);
+        const client = await getClient(opts.cookieSource, opts.chromeProfile, opts.cookieString);
         const { noteId, xsecToken } = parseNoteUrl(url);
         const strategy = opts.strategy;
         const max = Math.min(parseInt(opts.max) || 10, MAX_REPLIES_HARD_CAP);