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/url.ts
View on GitHub/**
* Build a shareable web URL for an XHS note.
*
* A bare `/explore/<id>` URL without `xsec_token` is 302-redirected to
* `/404/sec_*?source=xhs_sec_server` by XHS's anti-scrape gate. The token is
* per-note and context-scoped; `xsec_source` identifies which surface minted
* it (feed, search, share, etc.). Any consumer clicking a bare URL — Safari,
* an iOS link preview, an agent's action button — hits the gate.
*
* Common source values: `pc_feed`, `pc_search`, `pc_user`, `pc_share`,
* `pc_creatormng`, `app_share`.
*/
export function buildWebUrl(
noteId: string,
xsecToken: string | null | undefined,
source: string = "pc_feed",
): string {
const base = `https://www.xiaohongshu.com/explore/${noteId}`;
if (!xsecToken) return base;
const params = new URLSearchParams({ xsec_token: xsecToken, xsec_source: source });
return `${base}?${params.toString()}`;
}
/**
* Recursively walk a response and add `webUrl` to any object that looks like a
* note (has a note id plus an `xsec_token`). Mutates in place and returns the
* same object for chaining. Idempotent — won't overwrite an existing `webUrl`.
*/
export function enrichWithWebUrl<T>(obj: T, source: string = "pc_feed"): T {
walk(obj as unknown, source);
return obj;
}
function walk(value: unknown, source: string): void {
if (!value || typeof value !== "object") return;
if (Array.isArray(value)) {
for (const item of value) walk(item, source);
return;
}
const o = value as Record<string, unknown>;
const noteId = (o.note_id ?? o.id) as string | undefined;
const token = o.xsec_token as string | undefined;
if (typeof noteId === "string" && typeof token === "string" && token && !o.webUrl) {
o.webUrl = buildWebUrl(noteId, token, source);
}
for (const v of Object.values(o)) walk(v, source);
}
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 |