@jackwener/opencli 1.6.1 → 1.6.3

package/src/clis/xiaohongshu/creator-note-detail.ts

@@ -1,447 +0,0 @@
-/**
- * Xiaohongshu Creator Note Detail — per-note analytics from the creator detail page.
- *
- * The current creator center no longer serves stable single-note metrics from the legacy
- * `/api/galaxy/creator/data/note_detail` endpoint. The real note detail page loads data
- * through the newer `datacenter/note/*` API family, so this command navigates to the
- * detail page and parses the rendered metrics that are backed by those APIs.
- *
- * Requires: logged into creator.xiaohongshu.com in Chrome.
- */
-
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-type CreatorNoteDetailRow = {
-  section: string;
-  metric: string;
-  value: string;
-  extra: string;
-};
-
-export type { CreatorNoteDetailRow };
-
-type CreatorNoteDetailDomMetric = {
-  label: string;
-  value: string;
-  extra: string;
-};
-
-type CreatorNoteDetailDomSection = {
-  title: string;
-  metrics: CreatorNoteDetailDomMetric[];
-};
-
-type CreatorNoteDetailDomData = {
-  title: string;
-  infoText: string;
-  sections: CreatorNoteDetailDomSection[];
-};
-
-type AudienceSourceItem = {
-  title?: string;
-  value_with_double?: number;
-  info?: {
-    imp_count?: number;
-    view_count?: number;
-    interaction_count?: number;
-  };
-};
-
-type AudiencePortraitItem = {
-  title?: string;
-  value?: number;
-};
-
-type NoteTrendPoint = {
-  date?: number;
-  count?: number;
-  count_with_double?: number;
-};
-
-type NoteTrendBucket = {
-  imp_list?: NoteTrendPoint[];
-  view_list?: NoteTrendPoint[];
-  view_time_list?: NoteTrendPoint[];
-  like_list?: NoteTrendPoint[];
-  comment_list?: NoteTrendPoint[];
-  collect_list?: NoteTrendPoint[];
-  share_list?: NoteTrendPoint[];
-  rise_fans_list?: NoteTrendPoint[];
-};
-
-type NoteDetailApiPayload = {
-  noteBase?: {
-    hour?: NoteTrendBucket;
-    day?: NoteTrendBucket;
-  };
-  audienceTrend?: {
-    no_data?: boolean;
-    no_data_tip_msg?: string;
-  };
-  audienceSource?: {
-    source?: AudienceSourceItem[];
-  };
-  audienceSourceDetail?: {
-    gender?: AudiencePortraitItem[];
-    age?: AudiencePortraitItem[];
-    city?: AudiencePortraitItem[];
-    interest?: AudiencePortraitItem[];
-  };
-};
-
-const NOTE_DETAIL_DATETIME_RE = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/;
-const NOTE_DETAIL_METRICS = [
-  { label: '曝光数', section: '基础数据' },
-  { label: '观看数', section: '基础数据' },
-  { label: '封面点击率', section: '基础数据' },
-  { label: '平均观看时长', section: '基础数据' },
-  { label: '涨粉数', section: '基础数据' },
-  { label: '点赞数', section: '互动数据' },
-  { label: '评论数', section: '互动数据' },
-  { label: '收藏数', section: '互动数据' },
-  { label: '分享数', section: '互动数据' },
-] as const;
-
-const NOTE_DETAIL_METRIC_LABELS = new Set<string>(NOTE_DETAIL_METRICS.map((metric) => metric.label));
-const NOTE_DETAIL_SECTIONS = new Set<string>(NOTE_DETAIL_METRICS.map((metric) => metric.section));
-const NOTE_DETAIL_NOISE_LINES = new Set([
-  '切换笔记',
-  '笔记诊断',
-  '核心数据',
-  '观看来源',
-  '观众画像',
-  '提升建议',
-  '基础数据',
-  '互动数据',
-  '导出数据',
-  '实时',
-  '按小时',
-  '按天',
-]);
-
-function findNoteTitle(lines: string[]): string {
-  const detailIndex = lines.indexOf('笔记数据详情');
-  if (detailIndex < 0) return '';
-
-  for (let i = detailIndex + 1; i < lines.length; i++) {
-    const line = lines[i];
-    if (!line || line.startsWith('#') || NOTE_DETAIL_DATETIME_RE.test(line)) continue;
-    if (NOTE_DETAIL_NOISE_LINES.has(line)) continue;
-    return line;
-  }
-
-  return '';
-}
-
-function findMetricValue(lines: string[], startIndex: number): { value: string; extra: string } {
-  let value = '';
-  let extra = '';
-
-  for (let i = startIndex + 1; i < lines.length; i++) {
-    const line = lines[i];
-    if (!line) continue;
-    if (NOTE_DETAIL_METRIC_LABELS.has(line)) break;
-    if (NOTE_DETAIL_NOISE_LINES.has(line) || line.startsWith('数据更新至') || line.startsWith('部分数据统计中')) continue;
-
-    if (!value) {
-      value = line;
-      continue;
-    }
-
-    if (!extra && line.startsWith('粉丝')) {
-      extra = line;
-      break;
-    }
-
-    if (line === '0' || /^\d/.test(line) || line.endsWith('%') || line.endsWith('秒')) {
-      break;
-    }
-  }
-
-  return { value, extra };
-}
-
-function findPublishedAt(text: string): string {
-  const match = text.match(/\b\d{4}-\d{2}-\d{2} \d{2}:\d{2}\b/);
-  return match?.[0] ?? '';
-}
-
-export function parseCreatorNoteDetailText(bodyText: string, noteId: string): CreatorNoteDetailRow[] {
-  const lines = bodyText
-    .split('\n')
-    .map((line) => line.trim())
-    .filter(Boolean);
-
-  const title = findNoteTitle(lines);
-  const publishedAt = lines.find((line) => NOTE_DETAIL_DATETIME_RE.test(line)) ?? '';
-  const rows: CreatorNoteDetailRow[] = [
-    { section: '笔记信息', metric: 'note_id', value: noteId, extra: '' },
-    { section: '笔记信息', metric: 'title', value: title, extra: '' },
-    { section: '笔记信息', metric: 'published_at', value: publishedAt, extra: '' },
-  ];
-
-  for (const metric of NOTE_DETAIL_METRICS) {
-    const index = lines.indexOf(metric.label);
-    if (index < 0) continue;
-    const { value, extra } = findMetricValue(lines, index);
-    rows.push({
-      section: metric.section,
-      metric: metric.label,
-      value,
-      extra,
-    });
-  }
-
-  return rows;
-}
-
-export function parseCreatorNoteDetailDomData(dom: CreatorNoteDetailDomData | null | undefined, noteId: string): CreatorNoteDetailRow[] {
-  if (!dom) return [];
-  const title = typeof dom.title === 'string' ? dom.title.trim() : '';
-  const infoText = typeof dom.infoText === 'string' ? dom.infoText : '';
-  const sections = Array.isArray(dom.sections) ? dom.sections : [];
-
-  const rows: CreatorNoteDetailRow[] = [
-    { section: '笔记信息', metric: 'note_id', value: noteId, extra: '' },
-    { section: '笔记信息', metric: 'title', value: title, extra: '' },
-    { section: '笔记信息', metric: 'published_at', value: findPublishedAt(infoText), extra: '' },
-  ];
-
-  for (const section of sections) {
-    if (!NOTE_DETAIL_SECTIONS.has(section.title)) continue;
-    for (const metric of section.metrics) {
-      if (!NOTE_DETAIL_METRIC_LABELS.has(metric.label)) continue;
-      rows.push({
-        section: section.title,
-        metric: metric.label,
-        value: metric.value,
-        extra: metric.extra,
-      });
-    }
-  }
-
-  const hasMetric = rows.some((row) => row.section !== '笔记信息' && row.value);
-  return hasMetric ? rows : [];
-}
-
-function toPercentString(value?: number): string {
-  return value == null ? '' : `${value}%`;
-}
-
-function appendAudienceSourceRows(rows: CreatorNoteDetailRow[], payload?: NoteDetailApiPayload): CreatorNoteDetailRow[] {
-  const sourceItems = payload?.audienceSource?.source ?? [];
-  for (const item of sourceItems) {
-    if (!item.title) continue;
-    const extras: string[] = [];
-    if (item.info?.imp_count != null) extras.push(`曝光 ${item.info.imp_count}`);
-    if (item.info?.view_count != null) extras.push(`观看 ${item.info.view_count}`);
-    if (item.info?.interaction_count != null) extras.push(`互动 ${item.info.interaction_count}`);
-    rows.push({
-      section: '观看来源',
-      metric: item.title,
-      value: toPercentString(item.value_with_double),
-      extra: extras.join(' · '),
-    });
-  }
-  return rows;
-}
-
-function appendAudiencePortraitGroup(
-  rows: CreatorNoteDetailRow[],
-  groupLabel: string,
-  items?: AudiencePortraitItem[],
-): CreatorNoteDetailRow[] {
-  for (const item of items ?? []) {
-    if (!item.title) continue;
-    rows.push({
-      section: '观众画像',
-      metric: `${groupLabel}/${item.title}`,
-      value: toPercentString(item.value),
-      extra: '',
-    });
-  }
-  return rows;
-}
-
-export function appendAudienceRows(rows: CreatorNoteDetailRow[], payload?: NoteDetailApiPayload): CreatorNoteDetailRow[] {
-  appendAudienceSourceRows(rows, payload);
-  appendAudiencePortraitGroup(rows, '性别', payload?.audienceSourceDetail?.gender);
-  appendAudiencePortraitGroup(rows, '年龄', payload?.audienceSourceDetail?.age);
-  appendAudiencePortraitGroup(rows, '城市', payload?.audienceSourceDetail?.city);
-  appendAudiencePortraitGroup(rows, '兴趣', payload?.audienceSourceDetail?.interest);
-  return rows;
-}
-
-function formatTrendTimestamp(ts: number | undefined, granularity: 'hour' | 'day'): string {
-  if (!ts) return '';
-  // Use fixed UTC+8 offset to ensure consistent output regardless of CI server timezone.
-  const CST_OFFSET_MS = 8 * 60 * 60 * 1000;
-  const cstDate = new Date(ts + CST_OFFSET_MS);
-  const pad = (value: number) => String(value).padStart(2, '0');
-  if (granularity === 'hour') {
-    return `${pad(cstDate.getUTCMonth() + 1)}-${pad(cstDate.getUTCDate())} ${pad(cstDate.getUTCHours())}:00`;
-  }
-  return `${cstDate.getUTCFullYear()}-${pad(cstDate.getUTCMonth() + 1)}-${pad(cstDate.getUTCDate())}`;
-}
-
-function formatTrendSeries(points: NoteTrendPoint[] | undefined, granularity: 'hour' | 'day'): string {
-  if (!points?.length) return '';
-  return points
-    .map((point) => {
-      const label = formatTrendTimestamp(point.date, granularity);
-      const value = point.count_with_double ?? point.count;
-      return label && value != null ? `${label}=${value}` : '';
-    })
-    .filter(Boolean)
-    .join(' | ');
-}
-
-const TREND_SERIES_CONFIG = [
-  { key: 'imp_list', label: '曝光数' },
-  { key: 'view_list', label: '观看数' },
-  { key: 'view_time_list', label: '平均观看时长' },
-  { key: 'like_list', label: '点赞数' },
-  { key: 'comment_list', label: '评论数' },
-  { key: 'collect_list', label: '收藏数' },
-  { key: 'share_list', label: '分享数' },
-  { key: 'rise_fans_list', label: '涨粉数' },
-] as const;
-
-export function appendTrendRows(rows: CreatorNoteDetailRow[], payload?: NoteDetailApiPayload): CreatorNoteDetailRow[] {
-  if (payload?.audienceTrend?.no_data_tip_msg) {
-    rows.push({
-      section: '趋势说明',
-      metric: '观众趋势',
-      value: payload.audienceTrend.no_data ? '暂不可用' : '可用',
-      extra: payload.audienceTrend.no_data_tip_msg,
-    });
-  }
-
-  const buckets: Array<{ label: string; granularity: 'hour' | 'day'; data?: NoteTrendBucket }> = [
-    { label: '按小时', granularity: 'hour', data: payload?.noteBase?.hour },
-    { label: '按天', granularity: 'day', data: payload?.noteBase?.day },
-  ];
-
-  for (const bucket of buckets) {
-    for (const series of TREND_SERIES_CONFIG) {
-      const points = bucket.data?.[series.key];
-      const formatted = formatTrendSeries(points, bucket.granularity);
-      if (!formatted) continue;
-      rows.push({
-        section: '趋势数据',
-        metric: `${bucket.label}/${series.label}`,
-        value: `${points!.length} points`,
-        extra: formatted,
-      });
-    }
-  }
-
-  return rows;
-}
-
-const DETAIL_API_ENDPOINTS: Array<{ suffix: string; key: keyof NoteDetailApiPayload }> = [
-  { suffix: '/api/galaxy/creator/datacenter/note/base', key: 'noteBase' },
-  { suffix: '/api/galaxy/creator/datacenter/note/analyze/audience/trend', key: 'audienceTrend' },
-  { suffix: '/api/galaxy/creator/datacenter/note/audience/source/detail', key: 'audienceSourceDetail' },
-  { suffix: '/api/galaxy/creator/datacenter/note/audience', key: 'audienceSource' },
-];
-
-async function captureNoteDetailPayload(page: IPage, noteId: string): Promise<NoteDetailApiPayload | null> {
-  const payload: NoteDetailApiPayload = {};
-  let captured = 0;
-
-  // Try to fetch each API endpoint through the page context (uses the browser's cookies)
-  for (const { suffix, key } of DETAIL_API_ENDPOINTS) {
-    const apiUrl = `${suffix}?note_id=${noteId}`;
-    try {
-      const data = await page.evaluate(`
-        async () => {
-          try {
-            const resp = await fetch(${JSON.stringify(apiUrl)}, { credentials: 'include' });
-            if (!resp.ok) return null;
-            const json = await resp.json();
-            return JSON.stringify(json.data ?? {});
-          } catch { return null; }
-        }
-      `);
-      if (data && typeof data === 'string') {
-        try {
-          payload[key] = JSON.parse(data);
-          captured++;
-        } catch {}
-      }
-    } catch {}
-  }
-
-  return captured > 0 ? payload : null;
-}
-
-async function captureNoteDetailDomData(page: IPage): Promise<CreatorNoteDetailDomData | null> {
-  const result = await page.evaluate(`() => {
-    const norm = (value) => (value || '').trim();
-    const sections = Array.from(document.querySelectorAll('.shell-container')).map((container) => {
-      const containerText = norm(container.innerText);
-      const title = containerText.startsWith('互动数据')
-        ? '互动数据'
-        : containerText.includes('基础数据')
-          ? '基础数据'
-          : '';
-      const metrics = Array.from(container.querySelectorAll('.block-container.block')).map((block) => ({
-        label: norm(block.querySelector('.des')?.innerText),
-        value: norm(block.querySelector('.content')?.innerText),
-        extra: norm(block.querySelector('.text-with-fans')?.innerText),
-      })).filter((metric) => metric.label && metric.value);
-      return { title, metrics };
-    }).filter((section) => section.title && section.metrics.length > 0);
-
-    return {
-      title: norm(document.querySelector('.note-title')?.innerText),
-      infoText: norm(document.querySelector('.note-info-content')?.innerText),
-      sections,
-    };
-  }`);
-
-  if (!result || typeof result !== 'object') return null;
-  return result as CreatorNoteDetailDomData;
-}
-
-export async function fetchCreatorNoteDetailRows(page: IPage, noteId: string): Promise<CreatorNoteDetailRow[]> {
-  await page.goto(`https://creator.xiaohongshu.com/statistics/note-detail?noteId=${encodeURIComponent(noteId)}`);
-
-  const domData = await captureNoteDetailDomData(page).catch(() => null);
-  let rows = parseCreatorNoteDetailDomData(domData, noteId);
-  if (rows.length === 0) {
-    const bodyText = await page.evaluate('() => document.body.innerText');
-    rows = parseCreatorNoteDetailText(typeof bodyText === 'string' ? bodyText : '', noteId);
-  }
-  const apiPayload = await captureNoteDetailPayload(page, noteId).catch(() => null);
-  appendTrendRows(rows, apiPayload ?? undefined);
-  appendAudienceRows(rows, apiPayload ?? undefined);
-
-  return rows;
-}
-
-cli({
-  site: 'xiaohongshu',
-  name: 'creator-note-detail',
-  description: '小红书单篇笔记详情页数据 (笔记信息 + 核心/互动数据 + 观看来源 + 观众画像 + 趋势数据)',
-  domain: 'creator.xiaohongshu.com',
-  strategy: Strategy.COOKIE,
-  browser: true,
-  args: [
-    { name: 'note-id', positional: true, type: 'string', required: true, help: 'Note ID (from creator-notes or note-detail page URL)' },
-  ],
-  columns: ['section', 'metric', 'value', 'extra'],
-  func: async (page, kwargs) => {
-    const noteId: string = kwargs['note-id'];
-    const rows = await fetchCreatorNoteDetailRows(page, noteId);
-
-    const hasCoreMetric = rows.some((row) => row.section !== '笔记信息' && row.value);
-    if (!hasCoreMetric) {
-      throw new Error('No note detail data found. Check note_id and login status for creator.xiaohongshu.com.');
-    }
-
-    return rows;
-  },
-});

package/src/clis/xiaohongshu/creator-notes-summary.test.ts

@@ -1,54 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { summarizeCreatorNote } from './creator-notes-summary.js';
-import type { CreatorNoteRow } from './creator-notes.js';
-import type { CreatorNoteDetailRow } from './creator-note-detail.js';
-import './creator-notes-summary.js';
-
-describe('xiaohongshu creator-notes-summary', () => {
-  it('summarizes note list row and detail rows into one compact row', () => {
-    const note: CreatorNoteRow = {
-      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=cccccccccccccccccccccccc',
-    };
-
-    const rows: CreatorNoteDetailRow[] = [
-      { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
-      { section: '基础数据', metric: '观看数', value: '549', extra: '' },
-      { section: '互动数据', metric: '点赞数', value: '19', extra: '' },
-      { section: '互动数据', metric: '收藏数', value: '10', extra: '' },
-      { section: '互动数据', metric: '评论数', value: '7', extra: '' },
-      { section: '互动数据', metric: '分享数', value: '6', extra: '' },
-      { section: '基础数据', metric: '平均观看时长', value: '51.5秒', extra: '' },
-      { section: '基础数据', metric: '涨粉数', value: '3', extra: '' },
-      { section: '观看来源', metric: '首页推荐', value: '89.9%', extra: '' },
-      { section: '观看来源', metric: '搜索', value: '0.3%', extra: '' },
-      { section: '观众画像', metric: '兴趣/二次元', value: '13%', extra: '' },
-      { section: '观众画像', metric: '兴趣/游戏', value: '11%', extra: '' },
-    ];
-
-    expect(summarizeCreatorNote(note, rows, 1)).toEqual({
-      rank: 1,
-      id: 'cccccccccccccccccccccccc',
-      title: '示例内容复盘',
-      published_at: '2026-03-18 20:01',
-      views: '549',
-      likes: '19',
-      collects: '10',
-      comments: '7',
-      shares: '6',
-      avg_view_time: '51.5秒',
-      rise_fans: '3',
-      top_source: '首页推荐',
-      top_source_pct: '89.9%',
-      top_interest: '二次元',
-      top_interest_pct: '13%',
-      url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
-    });
-  });
-});

package/src/clis/xiaohongshu/creator-notes-summary.ts

@@ -1,120 +0,0 @@
-/**
- * Xiaohongshu Creator Notes Summary — batch summary for recent notes.
- *
- * Combines creator-notes and creator-note-detail into a single command that
- * returns one summary row per note, suitable for quick review or downstream JSON use.
- */
-
-import { cli, Strategy } from '../../registry.js';
-import { fetchCreatorNotes, type CreatorNoteRow } from './creator-notes.js';
-import { fetchCreatorNoteDetailRows, type CreatorNoteDetailRow } from './creator-note-detail.js';
-
-type CreatorNoteSummaryRow = {
-  rank: number;
-  id: string;
-  title: string;
-  published_at: string;
-  views: string;
-  likes: string;
-  collects: string;
-  comments: string;
-  shares: string;
-  avg_view_time: string;
-  rise_fans: string;
-  top_source: string;
-  top_source_pct: string;
-  top_interest: string;
-  top_interest_pct: string;
-  url: string;
-};
-
-function findDetailValue(rows: CreatorNoteDetailRow[], metric: string): string {
-  return rows.find((row) => row.metric === metric)?.value ?? '';
-}
-
-function findTopBySectionPrefix(rows: CreatorNoteDetailRow[], section: string, prefix: string): { label: string; value: string } {
-  const matches = rows.filter((row) => row.section === section && row.metric.startsWith(prefix) && row.value);
-  if (matches.length === 0) return { label: '', value: '' };
-  const sorted = [...matches].sort((a, b) => parseFloat(b.value) - parseFloat(a.value));
-  const top = sorted[0];
-  return {
-    label: top.metric.slice(prefix.length),
-    value: top.value,
-  };
-}
-
-export function summarizeCreatorNote(note: CreatorNoteRow, rows: CreatorNoteDetailRow[], rank: number): CreatorNoteSummaryRow {
-  const topSource = findTopBySectionPrefix(rows, '观看来源', '');
-  const topInterest = findTopBySectionPrefix(rows, '观众画像', '兴趣/');
-
-  return {
-    rank,
-    id: note.id,
-    title: note.title,
-    published_at: findDetailValue(rows, 'published_at') || note.date,
-    views: findDetailValue(rows, '观看数') || String(note.views),
-    likes: findDetailValue(rows, '点赞数') || String(note.likes),
-    collects: findDetailValue(rows, '收藏数') || String(note.collects),
-    comments: findDetailValue(rows, '评论数') || String(note.comments),
-    shares: findDetailValue(rows, '分享数'),
-    avg_view_time: findDetailValue(rows, '平均观看时长'),
-    rise_fans: findDetailValue(rows, '涨粉数'),
-    top_source: topSource.label,
-    top_source_pct: topSource.value,
-    top_interest: topInterest.label,
-    top_interest_pct: topInterest.value,
-    url: note.url,
-  };
-}
-
-cli({
-  site: 'xiaohongshu',
-  name: 'creator-notes-summary',
-  description: '小红书最近笔记批量摘要 (列表 + 单篇关键数据汇总)',
-  domain: 'creator.xiaohongshu.com',
-  strategy: Strategy.COOKIE,
-  browser: true,
-  args: [
-    { name: 'limit', type: 'int', default: 3, help: 'Number of recent notes to summarize' },
-  ],
-  columns: ['rank', 'id', 'title', 'views', 'likes', 'collects', 'comments', 'shares', 'avg_view_time', 'rise_fans', 'top_source', 'top_interest', 'url'],
-  timeoutSeconds: 180,
-  func: async (page, kwargs) => {
-    const limit = kwargs.limit || 3;
-    const notes = await fetchCreatorNotes(page, limit);
-
-    if (!notes.length) {
-      throw new Error('No notes found. Are you logged into creator.xiaohongshu.com?');
-    }
-
-    const results: CreatorNoteSummaryRow[] = [];
-    for (const [index, note] of notes.entries()) {
-      if (!note.id) {
-        results.push({
-          rank: index + 1,
-          id: note.id,
-          title: note.title,
-          published_at: note.date,
-          views: String(note.views),
-          likes: String(note.likes),
-          collects: String(note.collects),
-          comments: String(note.comments),
-          shares: '',
-          avg_view_time: '',
-          rise_fans: '',
-          top_source: '',
-          top_source_pct: '',
-          top_interest: '',
-          top_interest_pct: '',
-          url: note.url,
-        });
-        continue;
-      }
-
-      const detailRows = await fetchCreatorNoteDetailRows(page, note.id);
-      results.push(summarizeCreatorNote(note, detailRows, index + 1));
-    }
-
-    return results;
-  },
-});