@skills-store/rednote 0.1.10 → 0.1.12

package/dist/rednote/getProfile.js

@@ -2,21 +2,24 @@
 import * as cheerio from 'cheerio';
 import { parseArgs } from 'node:util';
 import vm from 'node:vm';
-import { printJson, runCli } from '../utils/browser-cli.js';
+import { runCli } from '../utils/browser-cli.js';
 import { resolveStatusTarget } from './status.js';
 import { createRednoteSession, disconnectRednoteSession, ensureRednoteLoggedIn } from './checkLogin.js';
+import { ensureJsonSavePath, renderJsonSaveSummary, renderPostsMarkdown, resolveJsonSavePath, writeJsonFile } from './output-format.js';
 function printGetProfileHelp() {
     process.stdout.write(`rednote get-profile
 
 Usage:
-  npx -y @skills-store/rednote get-profile [--instance NAME] --id USER_ID [--format md|json]
-  node --experimental-strip-types ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--format md|json]
-  bun ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--format md|json]
+  npx -y @skills-store/rednote get-profile [--instance NAME] --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
+  node --experimental-strip-types ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
+  bun ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
 
 Options:
   --instance NAME   Optional. Defaults to the saved lastConnect instance
   --id USER_ID      Required. Xiaohongshu profile user id
+  --mode MODE       Optional. profile | notes. Default: profile
   --format FORMAT   Output format: md | json. Default: md
+  --save PATH       Required when --format json is used. Saves only the selected mode data as JSON
   -h, --help        Show this help
 `);
 }
@@ -35,6 +38,12 @@ export function parseGetProfileCliArgs(argv) {
             format: {
                 type: 'string'
             },
+            mode: {
+                type: 'string'
+            },
+            save: {
+                type: 'string'
+            },
             help: {
                 type: 'boolean',
                 short: 'h'
@@ -48,10 +57,16 @@ export function parseGetProfileCliArgs(argv) {
     if (format !== 'md' && format !== 'json') {
         throw new Error(`Invalid --format value: ${String(format)}`);
     }
+    const mode = values.mode ?? 'profile';
+    if (mode !== 'profile' && mode !== 'notes') {
+        throw new Error(`Invalid --mode value: ${String(values.mode)}`);
+    }
     return {
         instance: values.instance,
         id: values.id,
         format,
+        mode,
+        savePath: values.save,
         help: values.help
     };
 }
@@ -103,8 +118,7 @@ function normalizeProfileUser(userPageData) {
         follows: follows,
         fans: fans,
         interaction: interaction,
-        tags,
-        raw: userPageData
+        tags
     };
 }
 function normalizeProfileNote(item) {
@@ -197,8 +211,8 @@ function normalizeProfileNotes(notesRaw) {
 function formatProfileField(value) {
     return value ?? '';
 }
-function renderProfileMarkdown(result) {
-    const { user, notes, url, userId } = result.profile;
+function renderProfileUserMarkdown(result) {
+    const { user, url, userId } = result.profile;
     const lines = [];
     lines.push('## UserInfo');
     lines.push('');
@@ -211,23 +225,17 @@ function renderProfileMarkdown(result) {
     lines.push(`- Fans: ${formatProfileField(user.fans)}`);
     lines.push(`- Interactions: ${formatProfileField(user.interaction)}`);
     lines.push(`- Tags: ${user.tags.length > 0 ? user.tags.map((tag)=>`#${tag}`).join(' ') : ''}`);
-    lines.push('');
-    lines.push('## Notes');
-    lines.push('');
-    if (notes.length === 0) {
-        lines.push('- Notes not found or the profile is private');
-    } else {
-        notes.forEach((note, index)=>{
-            lines.push(`- Title: ${note.noteCard.displayTitle ?? ''}`);
-            lines.push(`  Url: ${note.url}`);
-            lines.push(`  Interaction: ${note.noteCard.interactInfo.likedCount ?? ''}`);
-            if (index < notes.length - 1) {
-                lines.push('');
-            }
-        });
-    }
     return `${lines.join('\n')}\n`;
 }
+function selectProfileOutput(result, mode) {
+    return mode === 'notes' ? result.profile.notes : result.profile.user;
+}
+function renderProfileMarkdown(result, mode) {
+    if (mode === 'notes') {
+        return renderPostsMarkdown(result.profile.notes);
+    }
+    return renderProfileUserMarkdown(result);
+}
 async function captureProfile(page, targetUrl) {
     let userPageData = null;
     let notes = null;
@@ -286,26 +294,33 @@ export async function getProfile(session, url, userId) {
             userId,
             url,
             fetchedAt: new Date().toISOString(),
-            user: normalizeProfileUser(captured.userPageData),
-            notes: normalizeProfileNotes(captured.notes),
-            raw: captured
+            user: normalizeProfileUser({
+                ...captured.userPageData,
+                userId
+            }),
+            notes: normalizeProfileNotes(captured.notes)
         }
     };
 }
-function writeProfileOutput(result, format) {
-    if (format === 'json') {
-        printJson(result);
+function writeProfileOutput(result, values) {
+    const output = selectProfileOutput(result, values.mode);
+    if (values.format === 'json') {
+        const savedPath = resolveJsonSavePath(values.savePath);
+        writeJsonFile(output, savedPath);
+        process.stdout.write(renderJsonSaveSummary(savedPath, output));
         return;
     }
-    process.stdout.write(renderProfileMarkdown(result));
+    process.stdout.write(renderProfileMarkdown(result, values.mode));
 }
 export async function runGetProfileCommand(values = {
-    format: 'md'
+    format: 'md',
+    mode: 'profile'
 }) {
     if (values.help) {
         printGetProfileHelp();
         return;
     }
+    ensureJsonSavePath(values.format, values.savePath);
     if (!values.id) {
         throw new Error('Missing required option: --id');
     }
@@ -315,7 +330,7 @@ export async function runGetProfileCommand(values = {
     try {
         await ensureRednoteLoggedIn(target, 'fetching profile', session);
         const result = await getProfile(session, buildProfileUrl(normalizedUserId), normalizedUserId);
-        writeProfileOutput(result, values.format);
+        writeProfileOutput(result, values);
     } finally{
         await disconnectRednoteSession(session);
     }

package/dist/rednote/home.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util';
-import { printJson, runCli } from '../utils/browser-cli.js';
+import { runCli } from '../utils/browser-cli.js';
 import { resolveStatusTarget } from './status.js';
 import * as cheerio from 'cheerio';
 import vm from 'node:vm';
-import { parseOutputCliArgs, renderPostsMarkdown, resolveSavePath, writePostsJsonl } from './output-format.js';
+import { ensureJsonSavePath, parseOutputCliArgs, renderJsonSaveSummary, renderPostsMarkdown, resolveJsonSavePath, resolveSavePath, writeJsonFile, writePostsJsonl } from './output-format.js';
 import { createRednoteSession, disconnectRednoteSession } from './checkLogin.js';
 export function parseHomeCliArgs(argv) {
     return parseOutputCliArgs(argv);
@@ -20,7 +20,7 @@ Usage:
 Options:
   --instance NAME   Optional. Defaults to the saved lastConnect instance
   --format FORMAT   Output format: md | json. Default: md
-  --save [PATH]     Save posts as JSONL. Uses a default path when PATH is omitted
+  --save [PATH]     In markdown mode, saves posts as JSONL and uses a default path when PATH is omitted. In json mode, PATH is required and the full result is saved as JSON
   -h, --help        Show this help
 `);
 }
@@ -165,6 +165,13 @@ export async function getRednoteHomePosts(session) {
     };
 }
 function writeHomeOutput(result, values) {
+    if (values.format === 'json') {
+        const savedPath = resolveJsonSavePath(values.savePath);
+        result.home.savedPath = savedPath;
+        writeJsonFile(result.home.posts, savedPath);
+        process.stdout.write(renderJsonSaveSummary(savedPath, result.home.posts));
+        return;
+    }
     const posts = result.home.posts;
     let savedPath;
     if (values.saveRequested) {
@@ -172,10 +179,6 @@ function writeHomeOutput(result, values) {
         writePostsJsonl(posts, savedPath);
         result.home.savedPath = savedPath;
     }
-    if (values.format === 'json') {
-        printJson(result);
-        return;
-    }
     let markdown = renderPostsMarkdown(posts);
     if (savedPath) {
         markdown = `Saved JSONL: ${savedPath}\n\n${markdown}`;
@@ -190,6 +193,7 @@ export async function runHomeCommand(values = {
         printHomeHelp();
         return;
     }
+    ensureJsonSavePath(values.format, values.savePath);
     const target = resolveStatusTarget(values.instance);
     const session = await createRednoteSession(target);
     try {

package/dist/rednote/index.js

@@ -6,7 +6,7 @@ function printRednoteHelp() {
 
 Commands:
   browser <list|create|remove|connect>
-  env [--format md|json]
+  env [--format md|json] [--save PATH]
   status [--instance NAME]
   check-login [--instance NAME]
   login [--instance NAME]
@@ -14,21 +14,22 @@ Commands:
   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]
-  get-profile [--instance NAME] --id USER_ID [--format md|json]
+  get-feed-detail [--instance NAME] --url URL [--url URL] [--comments [COUNT]] [--format md|json] [--save PATH]
+  get-profile [--instance NAME] --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
 
 Examples:
   npx -y @skills-store/rednote browser list
   npx -y @skills-store/rednote browser create --name seller-main --browser chrome
   npx -y @skills-store/rednote env
+  npx -y @skills-store/rednote env --format json --save ./output/env.json
   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 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 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"
-  npx -y @skills-store/rednote get-profile --instance seller-main --id USER_ID
+  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
+  npx -y @skills-store/rednote get-profile --instance seller-main --id USER_ID --mode notes --format json --save ./output/profile-notes.json
 `);
 }
 function parseBasicArgs(argv) {

package/dist/rednote/interact.js

@@ -135,7 +135,7 @@ async function requireVisibleLocator(locator, errorMessage, timeoutMs = 5_000) {
 }
 async function typeCommentContent(page, content) {
     const commentInput = page.locator(COMMENT_INPUT_SELECTOR);
-    const visibleCommentInput = await requireVisibleLocator(commentInput, '未找到评论输入框，请确认帖子详情页已正确加载。', 15_000);
+    const visibleCommentInput = await requireVisibleLocator(commentInput, 'Could not find the comment input. Make sure the feed detail page finished loading.', 15_000);
     await visibleCommentInput.scrollIntoViewIfNeeded();
     await visibleCommentInput.click({
         force: true
@@ -160,7 +160,7 @@ 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);
+    const visibleSendButton = await requireVisibleLocator(sendButton, 'Could not find the Send button. Make sure the comment toolbar finished loading.', 15_000);
     await page.waitForFunction(({ selector, text })=>{
         const buttons = [
             ...document.querySelectorAll(selector)
@@ -198,10 +198,10 @@ async function commentOnCurrentFeedPage(page, content) {
 async function waitForInteractContainer(page) {
     await page.waitForLoadState('domcontentloaded');
     await page.waitForTimeout(500);
-    await requireVisibleLocator(page.locator(INTERACT_CONTAINER_SELECTOR), '未找到互动工具栏，请确认帖子详情页已正确加载。', 15_000);
+    await requireVisibleLocator(page.locator(INTERACT_CONTAINER_SELECTOR), 'Could not find the interaction toolbar. Make sure the feed detail page finished loading.', 15_000);
 }
 function getActionErrorMessage(action) {
-    return action === 'like' ? '未找到点赞按钮，请确认帖子详情页已正确加载。' : '未找到收藏按钮，请确认帖子详情页已正确加载。';
+    return action === 'like' ? 'Could not find the Like button. Make sure the feed detail page finished loading.' : 'Could not find the Collect button. Make sure the feed detail page finished loading.';
 }
 async function ensureActionApplied(page, action, alreadyActive) {
     if (alreadyActive) {

package/dist/rednote/login.js

@@ -1,8 +1,79 @@
 #!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
 import { parseArgs } from 'node:util';
+import { fileURLToPath } from 'node:url';
 import { printJson, runCli } from '../utils/browser-cli.js';
 import { resolveStatusTarget } from './status.js';
 import { checkRednoteLogin, createRednoteSession, disconnectRednoteSession } from './checkLogin.js';
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const REDNOTE_ROOT = path.resolve(SCRIPT_DIR, '../..');
+function timestampForFilename() {
+    return new Date().toISOString().replaceAll(':', '').replaceAll('.', '').replace('T', '-').replace('Z', 'Z');
+}
+function resolveQrCodePath() {
+    return path.join(REDNOTE_ROOT, 'output', `login-qrcode-${timestampForFilename()}.png`);
+}
+function parseQrCodeDataUrl(src) {
+    const match = src.match(/^data:(image\/[a-zA-Z0-9.+-]+);base64,(.+)$/);
+    if (!match) {
+        return null;
+    }
+    return {
+        mimeType: match[1],
+        buffer: Buffer.from(match[2], 'base64')
+    };
+}
+async function refreshExpiredQrCode(page) {
+    const statusText = page.locator('.qrcode .status-text').first();
+    const refreshButton = page.locator('.qrcode .status-desc.refresh').first();
+    const isExpiredVisible = await statusText.isVisible().catch(()=>false);
+    if (!isExpiredVisible) {
+        return false;
+    }
+    const text = (await statusText.textContent().catch(()=>null))?.trim() ?? '';
+    if (!text.includes('过期')) {
+        return false;
+    }
+    if (await refreshButton.isVisible().catch(()=>false)) {
+        await refreshButton.click({
+            timeout: 2_000
+        }).catch(()=>{});
+        await page.waitForTimeout(800);
+        return true;
+    }
+    return false;
+}
+async function saveQrCodeImage(page) {
+    const qrImage = page.locator('.qrcode .qrcode-img').first();
+    for(let attempt = 0; attempt < 3; attempt += 1){
+        await qrImage.waitFor({
+            state: 'visible',
+            timeout: 5_000
+        });
+        const refreshed = await refreshExpiredQrCode(page);
+        if (refreshed) {
+            continue;
+        }
+        const filePath = resolveQrCodePath();
+        fs.mkdirSync(path.dirname(filePath), {
+            recursive: true
+        });
+        const src = await qrImage.getAttribute('src');
+        if (src) {
+            const parsed = parseQrCodeDataUrl(src);
+            if (parsed?.mimeType === 'image/png') {
+                fs.writeFileSync(filePath, parsed.buffer);
+                return filePath;
+            }
+        }
+        await qrImage.screenshot({
+            path: filePath
+        });
+        return filePath;
+    }
+    throw new Error('No usable Xiaohongshu login QR code was detected. Make sure the login dialog is open.');
+}
 function printLoginHelp() {
     process.stdout.write(`rednote login
 
@@ -36,11 +107,13 @@ export async function openRednoteLogin(target, session) {
                 loginClicked: false,
                 pageUrl: session.page.url(),
                 waitingForPhoneLogin: false,
-                message: '当前实例已登录，无需重复执行登录操作。'
+                qrCodePath: null,
+                message: 'The current instance is already logged in. No additional login step is required.'
             }
         };
     }
     const { page } = await getOrCreateXiaohongshuPage(session);
+    await page.reload();
     const loginButton = page.locator('#login-btn');
     const hasLoginButton = await loginButton.count() > 0;
     if (!hasLoginButton) {
@@ -50,21 +123,25 @@ export async function openRednoteLogin(target, session) {
                 loginClicked: false,
                 pageUrl: page.url(),
                 waitingForPhoneLogin: false,
-                message: '未检测到登录按钮，当前实例可能已经登录。'
+                qrCodePath: null,
+                message: 'No login button was found. The current instance may already be logged in.'
             }
         };
     }
     await loginButton.first().click({
-        timeout: 2000
+        timeout: 2000,
+        force: true
     });
     await page.waitForTimeout(500);
+    const qrCodePath = await saveQrCodeImage(page);
     return {
         ok: true,
         rednote: {
             loginClicked: true,
             pageUrl: page.url(),
             waitingForPhoneLogin: true,
-            message: '已点击登录按钮，请在浏览器中继续输入手机号并完成登录。'
+            qrCodePath,
+            message: 'The login button was clicked and the QR code image was exported. Scan the code to finish logging in.'
         }
     };
 }

package/dist/rednote/output-format.js

@@ -98,12 +98,86 @@ export function writePostsJsonl(posts, filePath) {
     const content = posts.map((post)=>JSON.stringify(post)).join('\n');
     fs.writeFileSync(filePath, content ? `${content}\n` : '', 'utf8');
 }
+export function ensureJsonSavePath(format, savePath) {
+    if (format !== 'json') {
+        return;
+    }
+    if (!savePath?.trim()) {
+        throw new Error('The --save PATH option is required when --format json is used.');
+    }
+}
+export function resolveJsonSavePath(explicitPath) {
+    const normalizedPath = explicitPath?.trim();
+    if (!normalizedPath) {
+        throw new Error('The --save PATH option is required when --format json is used.');
+    }
+    return path.resolve(normalizedPath);
+}
+export function writeJsonFile(payload, filePath) {
+    fs.mkdirSync(path.dirname(filePath), {
+        recursive: true
+    });
+    fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+}
+function describeStringValue(value, key) {
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value) || key.toLowerCase().endsWith('at')) {
+        return 'ISO-8601 string';
+    }
+    if (key.toLowerCase().endsWith('url')) {
+        return 'string (URL)';
+    }
+    if (key.toLowerCase().endsWith('path')) {
+        return 'string (path)';
+    }
+    return 'string';
+}
+function buildJsonFieldExample(value, key = '', depth = 0) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'string') {
+        return describeStringValue(value, key);
+    }
+    if (typeof value === 'number') {
+        return 'number';
+    }
+    if (typeof value === 'boolean') {
+        return 'boolean';
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0 ? [
+            buildJsonFieldExample(value[0], key, depth + 1)
+        ] : [
+            'unknown'
+        ];
+    }
+    if (typeof value === 'object') {
+        if (depth >= 3 || key === 'raw') {
+            return 'object';
+        }
+        const entries = Object.entries(value);
+        if (entries.length === 0) {
+            return 'object';
+        }
+        return Object.fromEntries(entries.map(([entryKey, entryValue])=>[
+                entryKey,
+                buildJsonFieldExample(entryValue, entryKey, depth + 1)
+            ]));
+    }
+    return typeof value;
+}
+export function renderJsonSaveSummary(filePath, payload) {
+    return `Saved JSON: ${filePath}\n\nField format example:\n${JSON.stringify(buildJsonFieldExample(payload), null, 3)}\n`;
+}
 function formatField(value) {
     return value ?? '';
 }
 export function renderPostsMarkdown(posts) {
     if (posts.length === 0) {
-        return '没有获取到帖子。\n';
+        return 'No posts were captured.\n';
     }
     return `${posts.map((post)=>[
             `- id: ${post.id}`,