ZJU-REAL/Easel / skills/builtin/skill-xhs-analyzer
redbook
Flagged小红书内容分析:搜索笔记、拉取互动数据、分析爆款规律、创作者画像、限流检测,支持 CLI 自动化操作。 当用户说"小红书数据分析""小红书爆款分析""笔记数据""小红书限流检测""小红书创作者画像""分析小红书账号"时使用。 发布与日常互动运营请用 skill-xhs-publisher。
| File | Kind | Size |
|---|---|---|
| .github/workflows/npm-publish.yml | config | 3.8 KB |
| EASEL-META.md | markdown | 2.1 KB |
| SKILL.md | skill md | 5.2 KB |
| package-lock.json | manifest | 36.6 KB |
| package.json | manifest | 1.6 KB |
| references/commands.md | markdown | 4.4 KB |
| references/modules.md | markdown | 6.2 KB |
| references/platform-signals.md | markdown | 1.7 KB |
| references/research-loop.md | markdown | 8.2 KB |
| references/technical-reference.md | markdown | 3.8 KB |
| scripts/postinstall.js | script | 4.5 KB |
| scripts/preuninstall.js | script | 1.4 KB |
| social-preview.html | other | 5.1 KB |
| social-preview.png | binary | 261.4 KB |
| src/cli.ts | script | 76.8 KB |
| src/lib/analyze.ts | script | 20.0 KB |
| src/lib/cdp-cookies.ts | script | 13.1 KB |
| src/lib/client.ts | script | 22.2 KB |
| src/lib/cookies.ts | script | 13.3 KB |
| src/lib/creator-signing.ts | script | 1.8 KB |
| src/lib/detect.ts | script | 6.6 KB |
| src/lib/fingerprint-data.ts | script | 2.3 KB |
| src/lib/health.ts | script | 5.5 KB |
| src/lib/platform.ts | script | 2.7 KB |
| src/lib/render.ts | script | 19.5 KB |
| src/lib/reply-strategy.ts | script | 6.0 KB |
| src/lib/signing.ts | script | 21.1 KB |
| src/lib/template.ts | script | 8.0 KB |
| src/lib/url.ts | script | 1.8 KB |
| tsconfig.json | config | 458 B |
src/lib/template.ts
View on GitHub/**
* Viral template extraction — synthesize structural patterns from multiple viral notes.
*
* Given 1-3 ViralAnalysis results, extracts a ContentTemplate capturing
* the common structural formula: hook patterns, title/body structure,
* engagement profile, and audience signals.
*
* Deterministic, no LLM dependency.
*/
import kleur from "kleur";
import type { ViralAnalysis } from "./analyze.js";
// ─── Interfaces ─────────────────────────────────────────────────────────────
export interface ContentTemplate {
dominantHookPatterns: string[];
titleStructure: {
avgLength: number;
commonPatterns: string[];
hasEmoji: boolean;
hasNumber: boolean;
};
bodyStructure: {
lengthRange: [number, number];
paragraphRange: [number, number];
emojiDensityRange: [number, number];
hashtagRange: [number, number];
hasCallToAction: boolean;
usesBulletFormat: boolean;
};
engagementProfile: {
type: "reference" | "insight" | "entertainment";
avgCollectToLikeRatio: number;
avgCommentToLikeRatio: number;
avgShareToLikeRatio: number;
};
audienceSignals: {
commonThemes: Array<{ keyword: string; count: number }>;
avgQuestionRate: number;
};
sourceNotes: Array<{
id: string;
title: string;
url: string;
score: number;
}>;
generatedAt: string;
}
// ─── Extraction ─────────────────────────────────────────────────────────────
export function extractTemplate(analyses: ViralAnalysis[]): ContentTemplate {
const n = analyses.length;
// Hook patterns — count occurrences across notes, keep those appearing in majority
const hookCounts = new Map<string, number>();
for (const a of analyses) {
for (const p of a.hook.hookPatterns) {
hookCounts.set(p, (hookCounts.get(p) ?? 0) + 1);
}
}
const threshold = n === 1 ? 1 : Math.ceil(n / 2);
const dominantHookPatterns = [...hookCounts.entries()]
.filter(([, count]) => count >= threshold)
.sort((a, b) => b[1] - a[1])
.map(([pattern]) => pattern);
// Title structure
const titleLengths = analyses.map((a) => a.hook.titleLength);
const hasEmoji = analyses.some((a) => a.hook.emojiCount > 0);
const hasNumber = analyses.some((a) => a.hook.hasNumber);
// Body structure — compute ranges
const bodyLengths = analyses.map((a) => a.content.bodyLength);
const paragraphs = analyses.map((a) => a.content.paragraphCount);
const emojiDensities = analyses.map((a) => a.content.emojiDensity);
const hashtags = analyses.map((a) => a.content.hashtagCount);
const hasCTA = analyses.some((a) => a.content.hasCallToAction);
const usesBullets = analyses.some((a) => a.content.bulletOrListUsage);
// Engagement profile — classify by average collect/like ratio
const avgCollectRatio = avg(analyses.map((a) => a.engagement.collectToLikeRatio));
const avgCommentRatio = avg(analyses.map((a) => a.engagement.commentToLikeRatio));
const avgShareRatio = avg(analyses.map((a) => a.engagement.shareToLikeRatio));
let profileType: "reference" | "insight" | "entertainment";
if (avgCollectRatio > 40) profileType = "reference";
else if (avgCollectRatio > 20) profileType = "insight";
else profileType = "entertainment";
// Audience signals — merge comment themes across notes
const themeCounts = new Map<string, number>();
for (const a of analyses) {
for (const t of a.comments.themes) {
themeCounts.set(t.keyword, (themeCounts.get(t.keyword) ?? 0) + t.count);
}
}
const commonThemes = [...themeCounts.entries()]
.sort((a, b) => b[1] - a[1])
.slice(0, 10)
.map(([keyword, count]) => ({ keyword, count }));
return {
dominantHookPatterns,
titleStructure: {
avgLength: Math.round(avg(titleLengths)),
commonPatterns: dominantHookPatterns,
hasEmoji,
hasNumber,
},
bodyStructure: {
lengthRange: [Math.min(...bodyLengths), Math.max(...bodyLengths)],
paragraphRange: [Math.min(...paragraphs), Math.max(...paragraphs)],
emojiDensityRange: [
round2(Math.min(...emojiDensities)),
round2(Math.max(...emojiDensities)),
],
hashtagRange: [Math.min(...hashtags), Math.max(...hashtags)],
hasCallToAction: hasCTA,
usesBulletFormat: usesBullets,
},
engagementProfile: {
type: profileType,
avgCollectToLikeRatio: round2(avgCollectRatio),
avgCommentToLikeRatio: round2(avgCommentRatio),
avgShareToLikeRatio: round2(avgShareRatio),
},
audienceSignals: {
commonThemes,
avgQuestionRate: round2(avg(analyses.map((a) => a.comments.questionRate))),
},
sourceNotes: analyses.map((a) => ({
id: a.note.id,
title: a.note.title,
url: a.note.url,
score: a.score.overall,
})),
generatedAt: new Date().toISOString(),
};
}
// ─── Formatting ─────────────────────────────────────────────────────────────
const TYPE_LABELS: Record<string, string> = {
reference: "工具型 (Reference)",
insight: "认知型 (Insight)",
entertainment: "娱乐型 (Entertainment)",
};
export function formatTemplate(t: ContentTemplate): string {
const lines: string[] = [];
lines.push(kleur.bold("=== Content Template ===\n"));
// Hook patterns
lines.push(kleur.bold("Hook Patterns"));
if (t.dominantHookPatterns.length > 0) {
lines.push(` ${t.dominantHookPatterns.map((p) => kleur.cyan(`[${p}]`)).join(" ")}`);
} else {
lines.push(kleur.dim(" No dominant patterns detected"));
}
lines.push("");
// Title structure
lines.push(kleur.bold("Title Structure"));
lines.push(` Avg length: ${t.titleStructure.avgLength} chars`);
lines.push(` Emoji: ${t.titleStructure.hasEmoji ? "Yes" : "No"} | Number: ${t.titleStructure.hasNumber ? "Yes" : "No"}`);
lines.push("");
// Body structure
lines.push(kleur.bold("Body Structure"));
lines.push(` Length: ${t.bodyStructure.lengthRange[0]}–${t.bodyStructure.lengthRange[1]} chars`);
lines.push(` Paragraphs: ${t.bodyStructure.paragraphRange[0]}–${t.bodyStructure.paragraphRange[1]}`);
lines.push(` Emoji density: ${t.bodyStructure.emojiDensityRange[0]}–${t.bodyStructure.emojiDensityRange[1]}%`);
lines.push(` Hashtags: ${t.bodyStructure.hashtagRange[0]}–${t.bodyStructure.hashtagRange[1]}`);
lines.push(` CTA: ${t.bodyStructure.hasCallToAction ? "Yes" : "No"} | List/bullet format: ${t.bodyStructure.usesBulletFormat ? "Yes" : "No"}`);
lines.push("");
// Engagement profile
lines.push(kleur.bold("Engagement Profile"));
lines.push(` Type: ${TYPE_LABELS[t.engagementProfile.type] ?? t.engagementProfile.type}`);
lines.push(` Collect/Like: ${t.engagementProfile.avgCollectToLikeRatio}% | Comment/Like: ${t.engagementProfile.avgCommentToLikeRatio}% | Share/Like: ${t.engagementProfile.avgShareToLikeRatio}%`);
lines.push("");
// Audience signals
if (t.audienceSignals.commonThemes.length > 0) {
lines.push(kleur.bold("Audience Signals"));
lines.push(` Question rate: ${t.audienceSignals.avgQuestionRate}%`);
lines.push(` Top themes: ${t.audienceSignals.commonThemes.map((t) => t.keyword).join(", ")}`);
lines.push("");
}
// Source notes
lines.push(kleur.bold("Source Notes"));
for (const s of t.sourceNotes) {
lines.push(` ${kleur.dim(`[${s.score}/100]`)} ${s.title} ${kleur.dim(s.url)}`);
}
return lines.join("\n");
}
// ─── Helpers ────────────────────────────────────────────────────────────────
function avg(nums: number[]): number {
return nums.length === 0 ? 0 : nums.reduce((a, b) => a + b, 0) / nums.length;
}
function round2(n: number): number {
return Math.round(n * 100) / 100;
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |