@jackwener/opencli 1.5.8 → 1.6.0

package/dist/clis/notebooklm/open.js

@@ -0,0 +1,41 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError, EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { buildNotebooklmNotebookUrl, getNotebooklmPageState, parseNotebooklmNotebookTarget, readCurrentNotebooklm, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'open',
+    aliases: ['select'],
+    description: 'Open one NotebookLM notebook in the automation workspace by id or URL',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'notebook',
+            positional: true,
+            required: true,
+            help: 'Notebook id from list output, or a full NotebookLM notebook URL',
+        },
+    ],
+    columns: ['id', 'title', 'url', 'source'],
+    func: async (page, kwargs) => {
+        const notebookId = parseNotebooklmNotebookTarget(String(kwargs.notebook ?? ''));
+        await page.goto(buildNotebooklmNotebookUrl(notebookId));
+        await page.wait(2);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new CliError('NOTEBOOKLM_OPEN_FAILED', `NotebookLM notebook "${notebookId}" did not open in the automation workspace`, 'Run `opencli notebooklm list -f json` first and pass a valid notebook id.');
+        }
+        if (state.notebookId !== notebookId) {
+            console.warn(`[notebooklm open] expected notebook "${notebookId}" but page reports "${state.notebookId}"; continuing`);
+        }
+        const current = await readCurrentNotebooklm(page);
+        if (!current) {
+            throw new EmptyResultError('opencli notebooklm open', 'NotebookLM notebook metadata was not found after navigation.');
+        }
+        return [current];
+    },
+});

package/dist/clis/notebooklm/open.test.d.ts

@@ -0,0 +1 @@
+import './open.js';

package/dist/clis/notebooklm/open.test.js

@@ -0,0 +1,63 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockGetNotebooklmPageState, mockReadCurrentNotebooklm, mockRequireNotebooklmSession, } = vi.hoisted(() => ({
+    mockGetNotebooklmPageState: vi.fn(),
+    mockReadCurrentNotebooklm: vi.fn(),
+    mockRequireNotebooklmSession: vi.fn(),
+}));
+vi.mock('./utils.js', async () => {
+    const actual = await vi.importActual('./utils.js');
+    return {
+        ...actual,
+        getNotebooklmPageState: mockGetNotebooklmPageState,
+        readCurrentNotebooklm: mockReadCurrentNotebooklm,
+        requireNotebooklmSession: mockRequireNotebooklmSession,
+    };
+});
+import { getRegistry } from '../../registry.js';
+import './open.js';
+describe('notebooklm open', () => {
+    const command = getRegistry().get('notebooklm/open');
+    beforeEach(() => {
+        mockGetNotebooklmPageState.mockReset();
+        mockReadCurrentNotebooklm.mockReset();
+        mockRequireNotebooklmSession.mockReset();
+        mockRequireNotebooklmSession.mockResolvedValue(undefined);
+        mockGetNotebooklmPageState.mockResolvedValue({
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            title: 'Browser Automation',
+            hostname: 'notebooklm.google.com',
+            kind: 'notebook',
+            notebookId: 'nb-demo',
+            loginRequired: false,
+            notebookCount: 1,
+        });
+        mockReadCurrentNotebooklm.mockResolvedValue({
+            id: 'nb-demo',
+            title: 'Browser Automation',
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            source: 'current-page',
+        });
+    });
+    it('opens a notebook by id in the automation workspace', async () => {
+        const page = {
+            goto: vi.fn(async () => { }),
+            wait: vi.fn(async () => { }),
+        };
+        const result = await command.func(page, { notebook: 'nb-demo' });
+        expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/nb-demo');
+        expect(result).toEqual([{
+                id: 'nb-demo',
+                title: 'Browser Automation',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'current-page',
+            }]);
+    });
+    it('accepts a full notebook url', async () => {
+        const page = {
+            goto: vi.fn(async () => { }),
+            wait: vi.fn(async () => { }),
+        };
+        await command.func(page, { notebook: 'https://notebooklm.google.com/notebook/nb-demo?pli=1' });
+        expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/nb-demo');
+    });
+});

package/dist/clis/notebooklm/source-fulltext.js

@@ -1,7 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
-import { ensureNotebooklmNotebookBinding, findNotebooklmSourceRow, getNotebooklmPageState, getNotebooklmSourceFulltextViaRpc, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
+import { findNotebooklmSourceRow, getNotebooklmPageState, getNotebooklmSourceFulltextViaRpc, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
 cli({
     site: NOTEBOOKLM_SITE,
     name: 'source-fulltext',
@@ -20,11 +20,10 @@ cli({
     ],
     columns: ['title', 'kind', 'char_count', 'url', 'source'],
     func: async (page, kwargs) => {
-        await ensureNotebooklmNotebookBinding(page);
         await requireNotebooklmSession(page);
         const state = await getNotebooklmPageState(page);
         if (state.kind !== 'notebook') {
-            throw new EmptyResultError('opencli notebooklm source-fulltext', 'Open a specific NotebookLM notebook tab first, then retry.');
+            throw new EmptyResultError('opencli notebooklm source-fulltext', 'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.');
         }
         const rpcRows = await listNotebooklmSourcesViaRpc(page).catch(() => []);
         const rows = rpcRows.length > 0 ? rpcRows : await listNotebooklmSourcesFromPage(page);

package/dist/clis/notebooklm/source-get.js

@@ -1,7 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
-import { ensureNotebooklmNotebookBinding, findNotebooklmSourceRow, getNotebooklmPageState, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
+import { findNotebooklmSourceRow, getNotebooklmPageState, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
 cli({
     site: NOTEBOOKLM_SITE,
     name: 'source-get',
@@ -20,11 +20,10 @@ cli({
     ],
     columns: ['title', 'id', 'type', 'size', 'created_at', 'updated_at', 'url', 'source'],
     func: async (page, kwargs) => {
-        await ensureNotebooklmNotebookBinding(page);
         await requireNotebooklmSession(page);
         const state = await getNotebooklmPageState(page);
         if (state.kind !== 'notebook') {
-            throw new EmptyResultError('opencli notebooklm source-get', 'Open a specific NotebookLM notebook tab first, then retry.');
+            throw new EmptyResultError('opencli notebooklm source-get', 'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.');
         }
         const rpcRows = await listNotebooklmSourcesViaRpc(page).catch(() => []);
         const rows = rpcRows.length > 0 ? rpcRows : await listNotebooklmSourcesFromPage(page);

package/dist/clis/notebooklm/source-guide.js

@@ -1,7 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
-import { ensureNotebooklmNotebookBinding, findNotebooklmSourceRow, getNotebooklmPageState, getNotebooklmSourceGuideViaRpc, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
+import { findNotebooklmSourceRow, getNotebooklmPageState, getNotebooklmSourceGuideViaRpc, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
 cli({
     site: NOTEBOOKLM_SITE,
     name: 'source-guide',
@@ -20,11 +20,10 @@ cli({
     ],
     columns: ['source_id', 'notebook_id', 'title', 'type', 'summary', 'keywords', 'source'],
     func: async (page, kwargs) => {
-        await ensureNotebooklmNotebookBinding(page);
         await requireNotebooklmSession(page);
         const state = await getNotebooklmPageState(page);
         if (state.kind !== 'notebook') {
-            throw new EmptyResultError('opencli notebooklm source-guide', 'Open a specific NotebookLM notebook tab first, then retry.');
+            throw new EmptyResultError('opencli notebooklm source-guide', 'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.');
         }
         const rpcRows = await listNotebooklmSourcesViaRpc(page).catch(() => []);
         const rows = rpcRows.length > 0 ? rpcRows : await listNotebooklmSourcesFromPage(page);

package/dist/clis/notebooklm/source-list.js

@@ -1,7 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
-import { ensureNotebooklmNotebookBinding, getNotebooklmPageState, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
+import { getNotebooklmPageState, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
 cli({
     site: NOTEBOOKLM_SITE,
     name: 'source-list',
@@ -13,11 +13,10 @@ cli({
     args: [],
     columns: ['title', 'id', 'type', 'size', 'created_at', 'updated_at', 'url', 'source'],
     func: async (page) => {
-        await ensureNotebooklmNotebookBinding(page);
         await requireNotebooklmSession(page);
         const state = await getNotebooklmPageState(page);
         if (state.kind !== 'notebook') {
-            throw new EmptyResultError('opencli notebooklm source-list', 'Open a specific NotebookLM notebook tab first, then retry.');
+            throw new EmptyResultError('opencli notebooklm source-list', 'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.');
         }
         const rpcRows = await listNotebooklmSourcesViaRpc(page).catch(() => []);
         if (rpcRows.length > 0)

package/dist/clis/notebooklm/status.js

@@ -1,6 +1,6 @@
 import { cli, Strategy } from '../../registry.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_HOME_URL, NOTEBOOKLM_SITE } from './shared.js';
-import { ensureNotebooklmNotebookBinding, getNotebooklmPageState } from './utils.js';
+import { getNotebooklmPageState } from './utils.js';
 cli({
     site: NOTEBOOKLM_SITE,
     name: 'status',
@@ -12,7 +12,6 @@ cli({
     args: [],
     columns: ['status', 'login', 'page', 'url', 'title', 'notebooks'],
     func: async (page) => {
-        await ensureNotebooklmNotebookBinding(page);
         const currentUrl = await page.getCurrentUrl?.().catch(() => null);
         if (!currentUrl || !currentUrl.includes(NOTEBOOKLM_DOMAIN)) {
             await page.goto(NOTEBOOKLM_HOME_URL);

package/dist/clis/notebooklm/summary.js

@@ -1,7 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
-import { ensureNotebooklmNotebookBinding, getNotebooklmPageState, getNotebooklmSummaryViaRpc, readNotebooklmSummaryFromPage, requireNotebooklmSession, } from './utils.js';
+import { getNotebooklmPageState, getNotebooklmSummaryViaRpc, readNotebooklmSummaryFromPage, requireNotebooklmSession, } from './utils.js';
 cli({
     site: NOTEBOOKLM_SITE,
     name: 'summary',
@@ -13,11 +13,10 @@ cli({
     args: [],
     columns: ['title', 'summary', 'source', 'url'],
     func: async (page) => {
-        await ensureNotebooklmNotebookBinding(page);
         await requireNotebooklmSession(page);
         const state = await getNotebooklmPageState(page);
         if (state.kind !== 'notebook') {
-            throw new EmptyResultError('opencli notebooklm summary', 'Open a specific NotebookLM notebook tab first, then retry.');
+            throw new EmptyResultError('opencli notebooklm summary', 'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.');
         }
         const domSummary = await readNotebooklmSummaryFromPage(page);
         if (domSummary)

package/dist/clis/notebooklm/utils.d.ts

@@ -2,6 +2,8 @@ import type { IPage } from '../../types.js';
 import { type NotebooklmHistoryRow, type NotebooklmNotebookDetailRow, type NotebooklmNoteDetailRow, type NotebooklmNoteRow, type NotebooklmPageKind, type NotebooklmPageState, type NotebooklmRow, type NotebooklmSourceFulltextRow, type NotebooklmSourceGuideRow, type NotebooklmSourceRow, type NotebooklmSummaryRow } from './shared.js';
 export { buildNotebooklmRpcBody, extractNotebooklmRpcResult, fetchNotebooklmInPage, getNotebooklmPageAuth, parseNotebooklmChunkedResponse, stripNotebooklmAntiXssi, } from './rpc.js';
 export declare function parseNotebooklmIdFromUrl(url: string): string;
+export declare function parseNotebooklmNotebookTarget(value: string): string;
+export declare function buildNotebooklmNotebookUrl(notebookId: string): string;
 export declare function classifyNotebooklmPage(url: string): NotebooklmPageKind;
 export declare function normalizeNotebooklmTitle(value: unknown, fallback?: string): string;
 type NotebooklmRawNoteRow = {
@@ -29,7 +31,6 @@ export declare function getNotebooklmSourceFulltextViaRpc(page: IPage, sourceId:
 export declare function getNotebooklmSourceGuideViaRpc(page: IPage, source: Pick<NotebooklmSourceRow, 'id' | 'notebook_id' | 'title' | 'type'>): Promise<NotebooklmSourceGuideRow | null>;
 export declare function readNotebooklmVisibleNoteFromPage(page: IPage): Promise<NotebooklmNoteDetailRow | null>;
 export declare function ensureNotebooklmHome(page: IPage): Promise<void>;
-export declare function ensureNotebooklmNotebookBinding(page: IPage): Promise<boolean>;
 export declare function getNotebooklmPageState(page: IPage): Promise<NotebooklmPageState>;
 export declare function readCurrentNotebooklm(page: IPage): Promise<NotebooklmRow | null>;
 export declare function listNotebooklmLinks(page: IPage): Promise<NotebooklmRow[]>;

package/dist/clis/notebooklm/utils.js

@@ -1,6 +1,5 @@
 import { AuthRequiredError, CliError } from '../../errors.js';
-import { bindCurrentTab } from '../../browser/daemon-client.js';
-import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_HOME_URL, NOTEBOOKLM_SITE, } from './shared.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_HOME_URL, } from './shared.js';
 import { callNotebooklmRpc, getNotebooklmPageAuth, } from './rpc.js';
 export { buildNotebooklmRpcBody, extractNotebooklmRpcResult, fetchNotebooklmInPage, getNotebooklmPageAuth, parseNotebooklmChunkedResponse, stripNotebooklmAntiXssi, } from './rpc.js';
 const NOTEBOOKLM_LIST_RPC_ID = 'wXbhsf';
@@ -18,6 +17,25 @@ export function parseNotebooklmIdFromUrl(url) {
     const match = url.match(/\/notebook\/([^/?#]+)/);
     return match?.[1] ?? '';
 }
+export function parseNotebooklmNotebookTarget(value) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', 'NotebookLM notebook id is required', 'Pass a notebook id from `opencli notebooklm list` or a full notebook URL.');
+    }
+    if (/^https?:\/\//i.test(normalized)) {
+        const notebookId = parseNotebooklmIdFromUrl(normalized);
+        if (notebookId)
+            return notebookId;
+        throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', 'NotebookLM notebook URL is invalid', 'Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<id>.');
+    }
+    const pathMatch = normalized.match(/(?:^|\/)notebook\/([^/?#]+)/);
+    if (pathMatch?.[1])
+        return pathMatch[1];
+    return normalized;
+}
+export function buildNotebooklmNotebookUrl(notebookId) {
+    return new URL(`/notebook/${encodeURIComponent(notebookId)}`, NOTEBOOKLM_HOME_URL).toString();
+}
 export function classifyNotebooklmPage(url) {
     try {
         const parsed = new URL(url);
@@ -511,25 +529,6 @@ export async function ensureNotebooklmHome(page) {
     await page.goto(NOTEBOOKLM_HOME_URL);
     await page.wait(2);
 }
-export async function ensureNotebooklmNotebookBinding(page) {
-    if (!page.getCurrentUrl)
-        return false;
-    if (process.env.OPENCLI_CDP_ENDPOINT)
-        return false;
-    const currentUrl = await page.getCurrentUrl().catch(() => null);
-    if (currentUrl && classifyNotebooklmPage(currentUrl) === 'notebook')
-        return false;
-    try {
-        await bindCurrentTab(`site:${NOTEBOOKLM_SITE}`, {
-            matchDomain: NOTEBOOKLM_DOMAIN,
-            matchPathPrefix: '/notebook/',
-        });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 export async function getNotebooklmPageState(page) {
     const raw = await page.evaluate(`(() => {
     const url = window.location.href;

package/dist/clis/twitter/article.js

@@ -14,11 +14,38 @@ cli({
     ],
     columns: ['title', 'author', 'content', 'url'],
     func: async (page, kwargs) => {
-        // Extract tweet ID from URL if needed
+        // Extract tweet ID from URL if needed.
+        // Article URLs (x.com/i/article/{articleId}) use a different ID than
+        // tweet status URLs — the GraphQL endpoint needs the parent tweet ID.
         let tweetId = kwargs['tweet-id'];
+        const isArticleUrl = /\/article\/\d+/.test(tweetId);
         const urlMatch = tweetId.match(/\/(?:status|article)\/(\d+)/);
         if (urlMatch)
             tweetId = urlMatch[1];
+        if (isArticleUrl) {
+            // Navigate to the article page and resolve the parent tweet ID from DOM
+            await page.goto(`https://x.com/i/article/${tweetId}`);
+            await page.wait(3);
+            const resolvedId = await page.evaluate(`
+        (function() {
+          var links = document.querySelectorAll('a[href*="/status/"]');
+          for (var i = 0; i < links.length; i++) {
+            var m = links[i].href.match(/\\/status\\/(\\d+)/);
+            if (m) return m[1];
+          }
+          var og = document.querySelector('meta[property="og:url"]');
+          if (og && og.content) {
+            var m2 = og.content.match(/\\/status\\/(\\d+)/);
+            if (m2) return m2[1];
+          }
+          return null;
+        })()
+      `);
+            if (!resolvedId || typeof resolvedId !== 'string') {
+                throw new CommandExecutionError(`Could not resolve article ${tweetId} to a tweet ID. The article page may not contain a linked tweet.`);
+            }
+            tweetId = resolvedId;
+        }
         // Navigate to the tweet page for cookie context
         await page.goto(`https://x.com/i/status/${tweetId}`);
         await page.wait(3);

package/dist/clis/xiaohongshu/creator-note-detail.test.js

@@ -36,9 +36,9 @@ function createPageMock(evaluateResult) {
 describe('xiaohongshu creator-note-detail', () => {
     it('parses note detail page text into info and metric rows', () => {
         const bodyText = `笔记数据详情
-一张图讲清 诡秘之主·耕种者途径
-#诡秘之主
-#耕种者序列
+示例内容复盘
+#测试标签
+#内容分析
 2026-03-18 20:01
 切换笔记
 笔记诊断
@@ -81,9 +81,9 @@ describe('xiaohongshu creator-note-detail', () => {
 分享数
 6
 粉丝占比 0%`;
-        expect(parseCreatorNoteDetailText(bodyText, '69ba940500000000200384db')).toEqual([
-            { section: '笔记信息', metric: 'note_id', value: '69ba940500000000200384db', extra: '' },
-            { section: '笔记信息', metric: 'title', value: '一张图讲清 诡秘之主·耕种者途径', extra: '' },
+        expect(parseCreatorNoteDetailText(bodyText, 'cccccccccccccccccccccccc')).toEqual([
+            { section: '笔记信息', metric: 'note_id', value: 'cccccccccccccccccccccccc', extra: '' },
+            { section: '笔记信息', metric: 'title', value: '示例内容复盘', extra: '' },
             { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
             { section: '基础数据', metric: '曝光数', value: '1733', extra: '粉丝占比 6.6%' },
             { section: '基础数据', metric: '观看数', value: '544', extra: '粉丝占比 7.2%' },
@@ -98,8 +98,8 @@ describe('xiaohongshu creator-note-detail', () => {
     });
     it('parses structured note detail dom data into rows', () => {
         expect(parseCreatorNoteDetailDomData({
-            title: '神雕侠侣战力金字塔',
-            infoText: '神雕侠侣战力金字塔\n#武侠\n2025-12-04 19:45\n切换笔记',
+            title: '测试笔记一',
+            infoText: '测试笔记一\n#测试标签\n2025-12-04 19:45\n切换笔记',
             sections: [
                 {
                     title: '基础数据',
@@ -121,9 +121,9 @@ describe('xiaohongshu creator-note-detail', () => {
                     ],
                 },
             ],
-        }, '693155fc000000000d03b42c')).toEqual([
-            { section: '笔记信息', metric: 'note_id', value: '693155fc000000000d03b42c', extra: '' },
-            { section: '笔记信息', metric: 'title', value: '神雕侠侣战力金字塔', extra: '' },
+        }, 'bbbbbbbbbbbbbbbbbbbbbbbb')).toEqual([
+            { section: '笔记信息', metric: 'note_id', value: 'bbbbbbbbbbbbbbbbbbbbbbbb', extra: '' },
+            { section: '笔记信息', metric: 'title', value: '测试笔记一', extra: '' },
             { section: '笔记信息', metric: 'published_at', value: '2025-12-04 19:45', extra: '' },
             { section: '基础数据', metric: '曝光数', value: '898204', extra: '粉丝占比 0.5%' },
             { section: '基础数据', metric: '观看数', value: '148284', extra: '粉丝占比 0.6%' },

package/dist/clis/xiaohongshu/creator-notes-summary.test.js

@@ -4,14 +4,14 @@ import './creator-notes-summary.js';
 describe('xiaohongshu creator-notes-summary', () => {
     it('summarizes note list row and detail rows into one compact row', () => {
         const note = {
-            id: '69ba940500000000200384db',
-            title: '一张图讲清 诡秘之主·耕种者途径',
+            id: 'cccccccccccccccccccccccc',
+            title: '示例内容复盘',
             date: '2026年03月18日 20:01',
             views: 549,
             likes: 19,
             collects: 10,
             comments: 7,
-            url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+            url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
         };
         const rows = [
             { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
@@ -29,8 +29,8 @@ describe('xiaohongshu creator-notes-summary', () => {
         ];
         expect(summarizeCreatorNote(note, rows, 1)).toEqual({
             rank: 1,
-            id: '69ba940500000000200384db',
-            title: '一张图讲清 诡秘之主·耕种者途径',
+            id: 'cccccccccccccccccccccccc',
+            title: '示例内容复盘',
             published_at: '2026-03-18 20:01',
             views: '549',
             likes: '19',
@@ -43,7 +43,7 @@ describe('xiaohongshu creator-notes-summary', () => {
             top_source_pct: '89.9%',
             top_interest: '二次元',
             top_interest_pct: '13%',
-            url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+            url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
         });
     });
 });

package/dist/clis/xiaohongshu/creator-notes.test.js

@@ -41,7 +41,7 @@ describe('xiaohongshu creator-notes', () => {
         const bodyText = `笔记管理
 全部笔记(366)
 已发布
-神雕侠侣战力金字塔
+测试笔记一
 发布于 2025年12月04日 19:45
 148208
 324
@@ -53,7 +53,7 @@ describe('xiaohongshu creator-notes', () => {
 编辑
 删除
 仅自己可见
-终于等到了！！！
+测试笔记二
 发布于 2026年03月18日 12:39
 10
 0
@@ -64,7 +64,7 @@ describe('xiaohongshu creator-notes', () => {
         expect(parseCreatorNotesText(bodyText)).toEqual([
             {
                 id: '',
-                title: '神雕侠侣战力金字塔',
+                title: '测试笔记一',
                 date: '2025年12月04日 19:45',
                 views: 148208,
                 likes: 2279,
@@ -74,7 +74,7 @@ describe('xiaohongshu creator-notes', () => {
             },
             {
                 id: '',
-                title: '终于等到了！！！',
+                title: '测试笔记二',
                 date: '2026年03月18日 12:39',
                 views: 10,
                 likes: 0,
@@ -98,7 +98,7 @@ describe('xiaohongshu creator-notes', () => {
 4
 5
 权限设置`,
-                html: '"noteId":"69ba940500000000200384db"',
+                html: '"noteId":"aaaaaaaaaaaaaaaaaaaaaaaa"',
             },
         ]);
         const result = await cmd.func(page, { limit: 1 });
@@ -106,14 +106,14 @@ describe('xiaohongshu creator-notes', () => {
         expect(result).toEqual([
             {
                 rank: 1,
-                id: '69ba940500000000200384db',
+                id: 'aaaaaaaaaaaaaaaaaaaaaaaa',
                 title: '示例笔记',
                 date: '2026年03月19日 12:00',
                 views: 10,
                 likes: 3,
                 collects: 4,
                 comments: 2,
-                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=aaaaaaaaaaaaaaaaaaaaaaaa',
             },
         ]);
     });
@@ -124,8 +124,8 @@ describe('xiaohongshu creator-notes', () => {
             undefined,
             [
                 {
-                    id: '693155fc000000000d03b42c',
-                    title: '神雕侠侣战力金字塔',
+                    id: 'bbbbbbbbbbbbbbbbbbbbbbbb',
+                    title: '测试笔记一',
                     date: '2025年12月04日 19:45',
                     metrics: [148284, 319, 2280, 466, 33],
                 },
@@ -135,14 +135,14 @@ describe('xiaohongshu creator-notes', () => {
         expect(result).toEqual([
             {
                 rank: 1,
-                id: '693155fc000000000d03b42c',
-                title: '神雕侠侣战力金字塔',
+                id: 'bbbbbbbbbbbbbbbbbbbbbbbb',
+                title: '测试笔记一',
                 date: '2025年12月04日 19:45',
                 views: 148284,
                 likes: 2280,
                 collects: 466,
                 comments: 319,
-                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=693155fc000000000d03b42c',
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=bbbbbbbbbbbbbbbbbbbbbbbb',
             },
         ]);
     });
@@ -153,8 +153,8 @@ describe('xiaohongshu creator-notes', () => {
                 data: {
                     note_infos: [
                         {
-                            id: '69ba940500000000200384db',
-                            title: '一张图讲清 诡秘之主·耕种者途径',
+                            id: 'cccccccccccccccccccccccc',
+                            title: '示例内容复盘',
                             post_time: new Date('2026-03-18T20:01:00+08:00').getTime(),
                             read_count: 521,
                             like_count: 18,
@@ -169,26 +169,26 @@ describe('xiaohongshu creator-notes', () => {
         expect(result).toEqual([
             {
                 rank: 1,
-                id: '69ba940500000000200384db',
-                title: '一张图讲清 诡秘之主·耕种者途径',
+                id: 'cccccccccccccccccccccccc',
+                title: '示例内容复盘',
                 date: '2026年03月18日 20:01',
                 views: 521,
                 likes: 18,
                 collects: 10,
                 comments: 7,
-                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
             },
         ]);
     });
     it('extracts note ids from creator note-manager html', () => {
         const html = `
-      <div>&quot;noteId&quot;:&quot;69ba940500000000200384db&quot;</div>
-      <div>&quot;noteId&quot;:&quot;69ba2c98000000001a026e0f&quot;</div>
-      <div>&quot;noteId&quot;:&quot;69ba940500000000200384db&quot;</div>
+      <div>&quot;noteId&quot;:&quot;aaaaaaaaaaaaaaaaaaaaaaaa&quot;</div>
+      <div>&quot;noteId&quot;:&quot;dddddddddddddddddddddddd&quot;</div>
+      <div>&quot;noteId&quot;:&quot;aaaaaaaaaaaaaaaaaaaaaaaa&quot;</div>
     `;
         expect(parseCreatorNoteIdsFromHtml(html)).toEqual([
-            '69ba940500000000200384db',
-            '69ba2c98000000001a026e0f',
+            'aaaaaaaaaaaaaaaaaaaaaaaa',
+            'dddddddddddddddddddddddd',
         ]);
     });
 });

package/dist/clis/xiaohongshu/note.js

@@ -19,6 +19,7 @@ cli({
     columns: ['field', 'value'],
     func: async (page, kwargs) => {
         const raw = String(kwargs['note-id']);
+        const isBareNoteId = !/^https?:\/\//.test(raw.trim());
         const noteId = parseNoteId(raw);
         const url = buildNoteUrl(raw);
         await page.goto(url);
@@ -60,6 +61,16 @@ cli({
         // XHS renders placeholder text like "赞"/"收藏"/"评论" when count is 0;
         // normalize to '0' unless the value looks numeric.
         const numOrZero = (v) => /^\d+/.test(v) ? v : '0';
+        // XHS sometimes renders an empty shell page for bare /explore/<id> visits
+        // when the request lacks a valid xsec_token.  Title + author are always
+        // present on a real note, so their absence is the simplest reliable signal.
+        const emptyShell = !d.title && !d.author;
+        if (emptyShell) {
+            if (isBareNoteId) {
+                throw new EmptyResultError('xiaohongshu/note', 'Pass the full search_result URL with xsec_token, for example from `opencli xiaohongshu search`, instead of a bare note ID.');
+            }
+            throw new EmptyResultError('xiaohongshu/note', 'The note page loaded without visible content. Retry with a fresh URL or run with --verbose; if it persists, the page structure may have changed.');
+        }
         const rows = [
             { field: 'title', value: d.title || '' },
             { field: 'author', value: d.author || '' },