@skills-store/rednote 0.1.0 → 0.1.2

package/dist/rednote/publish.js

@@ -0,0 +1,376 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { printJson, runCli } from '../utils/browser-cli.js';
+import { resolveStatusTarget } from './status.js';
+import { createRednoteSession, disconnectRednoteSession, ensureRednoteLoggedIn } from './checkLogin.js';
+const REDNOTE_EXPLORE_URL = 'https://www.xiaohongshu.com/explore';
+const CREATOR_HOME_URL = 'https://creator.xiaohongshu.com/new/home';
+const CREATOR_SERVICE_SELECTOR = 'a.link[href="//creator.xiaohongshu.com/?source=official"]';
+const MAX_IMAGE_COUNT = 15;
+function printPublishHelp() {
+    process.stdout.write(`rednote publish
+
+Usage:
+  npx -y @skills-store/rednote publish --type video --video ./video.mp4 --title 标题 --content 描述 [--tag 穿搭] [--tag 日常] [--publish] [--instance NAME]
+  npx -y @skills-store/rednote publish --type image --image ./1.jpg --image ./2.jpg --title 标题 --content 描述 [--tag 探店] [--publish] [--instance NAME]
+  npx -y @skills-store/rednote publish --type article --title 标题 --content '# 一级标题\n\n正文' [--publish] [--instance NAME]
+  node --experimental-strip-types ./scripts/rednote/publish.ts ...
+  bun ./scripts/rednote/publish.ts ...
+
+Options:
+  --instance NAME      Optional. Defaults to the saved lastConnect instance
+  --type TYPE          可选。video | image | article；不传时会按参数自动推断
+  --title TEXT         Required. 发布标题
+  --content TEXT       必填。视频/图文时为描述，长文时为 Markdown 内容
+  --tag TEXT           可选。重复传入多个标签，例如 --tag 穿搭 --tag OOTD
+  --video PATH         视频模式必填。只能传 1 个视频文件
+  --image PATH         图文模式必填。重复传入多张图片，最多 ${MAX_IMAGE_COUNT} 张，首张为首图
+  --publish            立即发布。不传时默认保存草稿
+  -h, --help           Show this help
+`);
+}
+function isCreatorHomeUrl(url) {
+    return url === CREATOR_HOME_URL || url.startsWith(`${CREATOR_HOME_URL}?`) || url.startsWith(`${CREATOR_HOME_URL}#`);
+}
+function ensureNonEmpty(value, optionName) {
+    const normalized = value?.trim();
+    if (!normalized) {
+        throw new Error(`Missing required option: ${optionName}`);
+    }
+    return normalized;
+}
+function normalizeTags(tags) {
+    const normalizedTags = tags.map((tag)=>tag.trim()).filter(Boolean).map((tag)=>tag.replace(/^#+/, '')).filter(Boolean);
+    return [
+        ...new Set(normalizedTags)
+    ];
+}
+function resolveExistingFile(filePath, optionName) {
+    const resolvedPath = path.resolve(filePath);
+    let stat;
+    try {
+        stat = fs.statSync(resolvedPath);
+    } catch  {
+        throw new Error(`${optionName} file not found: ${resolvedPath}`);
+    }
+    if (!stat.isFile()) {
+        throw new Error(`${optionName} must point to a file: ${resolvedPath}`);
+    }
+    return resolvedPath;
+}
+export function parsePublishCliArgs(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        strict: false,
+        options: {
+            instance: {
+                type: 'string'
+            },
+            type: {
+                type: 'string'
+            },
+            title: {
+                type: 'string'
+            },
+            content: {
+                type: 'string'
+            },
+            tag: {
+                type: 'string',
+                multiple: true
+            },
+            video: {
+                type: 'string'
+            },
+            image: {
+                type: 'string',
+                multiple: true
+            },
+            publish: {
+                type: 'boolean'
+            },
+            help: {
+                type: 'boolean',
+                short: 'h'
+            }
+        }
+    });
+    if (positionals.length > 0) {
+        throw new Error(`Unexpected positional arguments: ${positionals.join(' ')}`);
+    }
+    const publishType = values.type;
+    if (publishType && publishType !== 'video' && publishType !== 'image' && publishType !== 'article') {
+        throw new Error(`Invalid --type value: ${String(publishType)}`);
+    }
+    return {
+        instance: values.instance,
+        type: publishType,
+        title: values.title,
+        content: values.content,
+        tags: values.tag ?? [],
+        videoPath: values.video,
+        imagePaths: values.image ?? [],
+        publishNow: values.publish ?? false,
+        help: values.help
+    };
+}
+function hasPublishInputs(values) {
+    return Boolean(values.type || values.title?.trim() || values.content?.trim() || values.videoPath?.trim() || values.imagePaths.length > 0 || values.tags.length > 0 || values.publishNow);
+}
+function resolvePublishType(values) {
+    if (values.type) {
+        return values.type;
+    }
+    if (values.videoPath?.trim()) {
+        return 'video';
+    }
+    if (values.imagePaths.length > 0) {
+        return 'image';
+    }
+    return 'article';
+}
+export function resolvePublishPayload(values) {
+    const type = resolvePublishType(values);
+    const title = ensureNonEmpty(values.title, '--title');
+    const tags = normalizeTags(values.tags);
+    const draft = !values.publishNow;
+    if (type === 'video') {
+        const content = ensureNonEmpty(values.content, '--content');
+        const videoPath = ensureNonEmpty(values.videoPath, '--video');
+        if (values.imagePaths.length > 0) {
+            throw new Error('Do not combine --type video with --image');
+        }
+        return {
+            type,
+            title,
+            content,
+            tags,
+            draft,
+            videoPath: resolveExistingFile(videoPath, '--video')
+        };
+    }
+    if (type === 'image') {
+        const content = ensureNonEmpty(values.content, '--content');
+        if (values.videoPath) {
+            throw new Error('Do not combine --type image with --video');
+        }
+        if (values.imagePaths.length === 0) {
+            throw new Error('Missing required option: --image');
+        }
+        if (values.imagePaths.length > MAX_IMAGE_COUNT) {
+            throw new Error(`Too many images: received ${values.imagePaths.length}, maximum is ${MAX_IMAGE_COUNT}`);
+        }
+        const imagePaths = values.imagePaths.map((imagePath)=>resolveExistingFile(imagePath, '--image'));
+        return {
+            type,
+            title,
+            content,
+            tags,
+            draft,
+            imagePaths,
+            coverImagePath: imagePaths[0]
+        };
+    }
+    if (values.videoPath) {
+        throw new Error('Do not combine --type article with --video');
+    }
+    if (values.imagePaths.length > 0) {
+        throw new Error('Do not combine --type article with --image');
+    }
+    if (tags.length > 0) {
+        throw new Error('Do not combine --type article with --tag');
+    }
+    const content = ensureNonEmpty(values.content, '--content');
+    return {
+        type,
+        title,
+        draft,
+        content
+    };
+}
+function summarizePayload(payload) {
+    if (payload.type === 'video') {
+        return {
+            type: payload.type,
+            title: payload.title,
+            content: payload.content,
+            tags: payload.tags,
+            draft: payload.draft,
+            assetCount: 1,
+            coverImagePath: null,
+            videoPath: payload.videoPath,
+            imagePaths: [],
+            contentLength: payload.content.length
+        };
+    }
+    if (payload.type === 'image') {
+        return {
+            type: payload.type,
+            title: payload.title,
+            content: payload.content,
+            tags: payload.tags,
+            draft: payload.draft,
+            assetCount: payload.imagePaths.length,
+            coverImagePath: payload.coverImagePath,
+            videoPath: null,
+            imagePaths: payload.imagePaths,
+            contentLength: payload.content.length
+        };
+    }
+    return {
+        type: payload.type,
+        title: payload.title,
+        content: payload.content,
+        tags: [],
+        draft: payload.draft,
+        assetCount: 0,
+        coverImagePath: null,
+        videoPath: null,
+        imagePaths: [],
+        contentLength: payload.content.length
+    };
+}
+function toPublishResult(target, publish) {
+    return {
+        ok: true,
+        instance: {
+            scope: target.scope,
+            name: target.instanceName,
+            browser: target.browser,
+            userDataDir: target.userDataDir,
+            source: target.source,
+            lastConnect: target.lastConnect
+        },
+        publish
+    };
+}
+function getSessionPages(session) {
+    const pages = [
+        session.page,
+        ...session.browserContext.pages()
+    ];
+    return [
+        ...new Set(pages)
+    ];
+}
+async function findCreatorServicePage(session) {
+    for (const page of getSessionPages(session)){
+        if (!page.url().startsWith('https://www.xiaohongshu.com/')) {
+            continue;
+        }
+        const creatorServiceLink = page.locator(CREATOR_SERVICE_SELECTOR).filter({
+            hasText: '创作服务'
+        });
+        if (await creatorServiceLink.count() > 0) {
+            return page;
+        }
+    }
+    return null;
+}
+async function resolvePublishPage(session) {
+    const existingCreatorHomePage = getSessionPages(session).find((page)=>isCreatorHomeUrl(page.url()));
+    if (existingCreatorHomePage) {
+        return {
+            page: existingCreatorHomePage,
+            reusedCreatorHome: true
+        };
+    }
+    const existingCreatorServicePage = await findCreatorServicePage(session);
+    if (existingCreatorServicePage) {
+        return {
+            page: existingCreatorServicePage,
+            reusedCreatorHome: false
+        };
+    }
+    const page = session.page;
+    if (!page.url().startsWith('https://www.xiaohongshu.com/')) {
+        await page.goto(REDNOTE_EXPLORE_URL, {
+            waitUntil: 'domcontentloaded'
+        });
+    }
+    await page.waitForTimeout(1_500);
+    return {
+        page,
+        reusedCreatorHome: isCreatorHomeUrl(page.url())
+    };
+}
+async function waitForCreatorHome(page) {
+    await page.waitForURL((url)=>isCreatorHomeUrl(url.toString()), {
+        timeout: 15_000
+    });
+    await page.waitForLoadState('domcontentloaded');
+}
+export async function openRednotePublish(target, session, payload) {
+    const resolved = await resolvePublishPage(session);
+    const payloadSummary = summarizePayload(payload);
+    if (resolved.reusedCreatorHome || isCreatorHomeUrl(resolved.page.url())) {
+        return toPublishResult(target, {
+            pageUrl: resolved.page.url(),
+            creatorHomeUrl: CREATOR_HOME_URL,
+            clickedCreatorService: false,
+            reusedCreatorHome: true,
+            openedInNewPage: false,
+            payload: payloadSummary,
+            message: '当前页面已经是创作服务首页，发布参数已校验。'
+        });
+    }
+    const creatorServiceLink = resolved.page.locator(CREATOR_SERVICE_SELECTOR).filter({
+        hasText: '创作服务'
+    });
+    if (await creatorServiceLink.count() === 0) {
+        throw new Error('未找到“创作服务”入口，请先打开小红书首页并确认账号已登录。');
+    }
+    const popupPromise = session.browserContext.waitForEvent('page', {
+        timeout: 3_000
+    }).catch(()=>null);
+    await creatorServiceLink.first().click();
+    let targetPage = await popupPromise ?? resolved.page;
+    let openedInNewPage = targetPage !== resolved.page;
+    try {
+        await waitForCreatorHome(targetPage);
+    } catch  {
+        const existingCreatorHomePage = getSessionPages(session).find((page)=>isCreatorHomeUrl(page.url()));
+        if (!existingCreatorHomePage) {
+            throw new Error(`点击“创作服务”后，未跳转到 ${CREATOR_HOME_URL}`);
+        }
+        targetPage = existingCreatorHomePage;
+        openedInNewPage = targetPage !== resolved.page;
+    }
+    return toPublishResult(target, {
+        pageUrl: targetPage.url(),
+        creatorHomeUrl: CREATOR_HOME_URL,
+        clickedCreatorService: true,
+        reusedCreatorHome: false,
+        openedInNewPage,
+        payload: payloadSummary,
+        message: '已进入创作服务首页，发布参数已校验。'
+    });
+}
+export async function runPublishCommand(values) {
+    if (values.help || !hasPublishInputs(values)) {
+        printPublishHelp();
+        return;
+    }
+    const payload = resolvePublishPayload(values);
+    const target = resolveStatusTarget(values.instance);
+    const session = await createRednoteSession(target);
+    try {
+        await ensureRednoteLoggedIn(target, 'publishing content', session);
+        const result = await openRednotePublish(target, session, payload);
+        printJson(result);
+    } finally{
+        disconnectRednoteSession(session);
+    }
+}
+async function main() {
+    const values = parsePublishCliArgs(process.argv.slice(2));
+    if (values.help) {
+        printPublishHelp();
+        return;
+    }
+    await runPublishCommand(values);
+}
+runCli(import.meta.url, main);

package/dist/rednote/search.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+import { printJson, runCli } from '../utils/browser-cli.js';
+import { resolveStatusTarget } from './status.js';
+import { createRednoteSession, disconnectRednoteSession, ensureRednoteLoggedIn } from './checkLogin.js';
+import { parseOutputCliArgs, renderPostsMarkdown, resolveSavePath, writePostsJsonl } from './output-format.js';
+export function parseSearchCliArgs(argv) {
+    return parseOutputCliArgs(argv, {
+        includeKeyword: true
+    });
+}
+function printSearchHelp() {
+    process.stdout.write(`rednote search
+
+Usage:
+  npx -y @skills-store/rednote search [--instance NAME] --keyword TEXT [--format md|json] [--save [PATH]]
+  node --experimental-strip-types ./scripts/rednote/search.ts --instance NAME --keyword TEXT [--format md|json] [--save [PATH]]
+  bun ./scripts/rednote/search.ts --instance NAME --keyword TEXT [--format md|json] [--save [PATH]]
+
+Options:
+  --instance NAME   Optional. Defaults to the saved lastConnect instance
+  --keyword TEXT    Required. Search keyword
+  --format FORMAT   Output format: md | json. Default: md
+  --save [PATH]     Save posts as JSONL. Uses a default path when PATH is omitted
+  -h, --help        Show this help
+`);
+}
+function normalizeSearchPost(item) {
+    const noteCard = item.note_card ?? {};
+    const user = noteCard.user ?? {};
+    const interactInfo = noteCard.interact_info ?? {};
+    const cover = noteCard.cover ?? {};
+    const imageList = Array.isArray(noteCard.image_list) ? noteCard.image_list : [];
+    const cornerTagInfo = Array.isArray(noteCard.corner_tag_info) ? noteCard.corner_tag_info : [];
+    const xsecToken = item.xsec_token ?? null;
+    return {
+        id: item.id,
+        modelType: item.model_type,
+        xsecToken,
+        url: xsecToken ? `https://www.xiaohongshu.com/explore/${item.id}?xsec_token=${xsecToken}` : `https://www.xiaohongshu.com/explore/${item.id}`,
+        noteCard: {
+            type: noteCard.type ?? null,
+            displayTitle: noteCard.display_title ?? null,
+            cover: {
+                urlDefault: cover.url_default ?? null,
+                urlPre: cover.url_pre ?? null,
+                url: cover.url ?? null,
+                fileId: cover.file_id ?? null,
+                width: cover.width ?? null,
+                height: cover.height ?? null,
+                infoList: Array.isArray(cover.info_list) ? cover.info_list.map((info)=>({
+                        imageScene: info?.image_scene ?? null,
+                        url: info?.url ?? null
+                    })) : []
+            },
+            user: {
+                userId: user.user_id ?? null,
+                nickname: user.nickname ?? null,
+                nickName: user.nick_name ?? user.nickname ?? null,
+                avatar: user.avatar ?? null,
+                xsecToken: user.xsec_token ?? null
+            },
+            interactInfo: {
+                liked: interactInfo.liked ?? false,
+                likedCount: interactInfo.liked_count ?? null,
+                commentCount: interactInfo.comment_count ?? null,
+                collectedCount: interactInfo.collected_count ?? null,
+                sharedCount: interactInfo.shared_count ?? null
+            },
+            cornerTagInfo: cornerTagInfo.map((tag)=>({
+                    type: tag?.type ?? null,
+                    text: tag?.text ?? null
+                })),
+            imageList: imageList.map((image)=>({
+                    width: image?.width ?? null,
+                    height: image?.height ?? null,
+                    infoList: Array.isArray(image?.info_list) ? image.info_list.map((info)=>({
+                            imageScene: info?.image_scene ?? null,
+                            url: info?.url ?? null
+                        })) : []
+                })),
+            video: {
+                duration: noteCard.video?.capa?.duration ?? null
+            }
+        }
+    };
+}
+async function getOrCreateXiaohongshuPage(session) {
+    return session.page;
+}
+function isJsonContentType(contentType) {
+    return typeof contentType === 'string' && contentType.includes('/json');
+}
+async function collectSearchItems(page, keyword) {
+    const items = new Map();
+    const searchPromise = new Promise((resolve, reject)=>{
+        const handleResponse = async (response)=>{
+            try {
+                if (response.status() !== 200) {
+                    return;
+                }
+                if (response.request().method().toLowerCase() !== 'post') {
+                    return;
+                }
+                if (!isJsonContentType(response.headers()['content-type'])) {
+                    return;
+                }
+                const data = await response.json();
+                const list = Array.isArray(data?.data?.items) ? data.data.items : null;
+                if (!data?.success || !list) {
+                    return;
+                }
+                for (const item of list){
+                    if (item && item.model_type === 'note' && typeof item.id === 'string') {
+                        items.set(item.id, item);
+                    }
+                }
+                if (items.size > 0) {
+                    clearTimeout(timeoutId);
+                    page.off('response', handleResponse);
+                    resolve([
+                        ...items.values()
+                    ]);
+                }
+            } catch  {}
+        };
+        const timeoutId = setTimeout(()=>{
+            page.off('response', handleResponse);
+            reject(new Error(`Timed out waiting for Xiaohongshu search response: ${keyword}`));
+        }, 15_000);
+        page.on('response', handleResponse);
+    });
+    if (!page.url().startsWith('https://www.xiaohongshu.com/explore')) {
+        await page.goto('https://www.xiaohongshu.com/explore', {
+            waitUntil: 'domcontentloaded'
+        });
+    }
+    const searchInput = page.locator('#search-input');
+    await searchInput.focus();
+    await searchInput.fill(keyword);
+    await page.keyboard.press('Enter');
+    await page.waitForTimeout(500);
+    return await searchPromise;
+}
+export async function searchRednotePosts(session, keyword) {
+    const page = await getOrCreateXiaohongshuPage(session);
+    const items = await collectSearchItems(page, keyword);
+    const posts = items.map(normalizeSearchPost);
+    return {
+        ok: true,
+        search: {
+            keyword,
+            pageUrl: page.url(),
+            fetchedAt: new Date().toISOString(),
+            total: posts.length,
+            posts
+        }
+    };
+}
+function writeSearchOutput(result, values) {
+    const posts = result.search.posts;
+    let savedPath;
+    if (values.saveRequested) {
+        savedPath = resolveSavePath('search', values.savePath, result.search.keyword);
+        writePostsJsonl(posts, savedPath);
+        result.search.savedPath = savedPath;
+    }
+    if (values.format === 'json') {
+        printJson(result);
+        return;
+    }
+    let markdown = renderPostsMarkdown(posts);
+    if (savedPath) {
+        markdown = `Saved JSONL: ${savedPath}\n\n${markdown}`;
+    }
+    process.stdout.write(markdown);
+}
+export async function runSearchCommand(values = {
+    format: 'md',
+    saveRequested: false
+}) {
+    if (values.help) {
+        printSearchHelp();
+        return;
+    }
+    const keyword = values.keyword?.trim();
+    if (!keyword) {
+        throw new Error('Missing required option: --keyword');
+    }
+    const target = resolveStatusTarget(values.instance);
+    const session = await createRednoteSession(target);
+    try {
+        await ensureRednoteLoggedIn(target, 'search', session);
+        const result = await searchRednotePosts(session, keyword);
+        writeSearchOutput(result, values);
+    } finally{
+        disconnectRednoteSession(session);
+    }
+}
+async function main() {
+    const values = parseSearchCliArgs(process.argv.slice(2));
+    if (values.help) {
+        printSearchHelp();
+        return;
+    }
+    await runSearchCommand(values);
+}
+runCli(import.meta.url, main);