Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
redfox-data avatar

Xiaohongshu Account Analyzer

redfox-data/redfox-community

  • 249 installs
  • 316 repo stars
  • Updated August 4, 2026
  • redfox-data/redfox-community

Use xiaohongshu-account-analyzer for development tasks

About

xiaohongshu-account-analyzer: A skill for development. This provides functionality for development workflows.

  • xiaohongshu-account-analyzer

Xiaohongshu Account Analyzer by the numbers

  • 249 all-time installs (skills.sh)
  • +17 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #1,538 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/redfox-data/redfox-community --skill xiaohongshu-account-analyzer

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs249
repo stars★ 316
Last updatedAugust 4, 2026
Repositoryredfox-data/redfox-community ↗

What it does

Use xiaohongshu-account-analyzer for development tasks

Files

SKILL.mdMarkdownGitHub ↗

小红书账号诊断

1. 简介

深耕小红书账号分析的诊断师工具 -- 深度拆解小红书账号，基于近 30 天数据输出专业的七维度商业价值分析报告，覆盖账号定位、粉丝画像、选题体系、封面风格、爆文能力、互动规模、更新产能七大维度，并提供相似账号推荐和多账号对比分析。

适用对象：小红书创作者、MCN 运营、品牌方、对账号健康度有诊断需求的个人或团队。

---

2. 功能特性

核心功能：

  • 七维度诊断评分 -- 账号定位（10分）、粉丝画像与需求（15分）、选题体系（15分）、封面风格（10分）、爆文能力（15分）、互动规模（20分）、更新产能（15分），满分 100 分
  • 生命周期分析 -- 判断账号所处生命周期阶段
  • 行动处方生成 -- 基于诊断结果输出可落地的优化建议
  • 相似账号推荐 -- 推荐 2-5 个可对比的相似账号
  • 多账号对比分析 -- 支持多账号横向对比
  • HTML 报告生成 -- 生成可视化诊断报告

特色亮点：

  • 反空话规则：所有结论必须有数据支撑 + 落地动作，禁止无具体动作的表述
  • WebSearch 背景补全：自动搜索博主昵称、媒体报道、跨平台布局补充信息
  • 订阅推送机制：无作品数据时支持 30 分钟后的自动重试推送
  • 空值智能隐藏：数据为空时自动隐藏对应模块，不展示 "暂无"

---

3. 一键安装

鉴权

获取 API Key

请前往 红狐hub 获取API KEY

配置 API Key

方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

方案2: 终端配置：export REDFOX_API_KEY="ak_xxxx..."

export REDFOX_API_KEY="ak_xxxx..."

依赖安装

无需安装第三方依赖，使用 Python 标准库（ssl、urllib.request、json）即可。数据接口：POST https://redfox.hk/story/api/xhsUser/query。

---

4. 使用指南

基础使用

单账号诊断：用户输入小红书号（纯数字或字母数字组合），调用接口查询并生成诊断报告。

python scripts/xiaohongshu_analyzer.py query --user_ids "id1,id2"

脚本自动将接口原始数据保存至 output/raw_data.json。

操作流程（严格按顺序执行）

步骤 1：开场白引导 -- 输出欢迎语，引导用户输入小红书号。明确说明：请输入小红书号（纯数字或字母数字组合，非中文昵称）。若用户输入中文昵称，提示用户提供小红书号而非昵称。

步骤 2：输入识别与数据获取 -- 识别用户输入（纯数字或字母数字组合识别为小红书号）并调用接口查询。

步骤 3：WebSearch 背景信息补全：

  • 搜索「小红书 + 昵称」补全背景信息
  • 搜索「昵称 + 采访/报道」寻找媒体报道
  • 搜索抖音 / B 站 / 公众号等跨平台布局

步骤 4：查询结果处理 -- 根据查询类型输出对应响应：

  • 未查询到账号：调用数据同步接口 python scripts/xiaohongshu_analyzer.py sync_notes --red_ids "用户输入的账号ID"，输出提示并引导订阅推送（30 分钟后），使用 calendar_create 创建日程。
  • 查询到唯一账号：继续生成单账号报告（步骤 5-7）。
  • 查询到多个账号：进入多账号对比流程（步骤 5M-7M）。
  • 查询到账号但无作品：直接进入订阅流程，用户可选择订阅、仍执行分析或暂不订阅。

步骤 5：诊断报告生成 -- 智能体严格按照 references/report_template.md 模板格式在对话中输出诊断报告。报告结构按 7 个评分维度展开：

  • 账号定位（10分）：TA 是谁、心智占位、核心身份、价值观锚点、吸引力类型、差异化优势
  • 粉丝画像与需求（10分）：粉丝构成、核心需求反推、付费意愿评估
  • 选题体系（15分）：选题方向、表达风格、叙事手法、人格一致性
  • 封面风格（10分）：视觉特征、信息层级、一致性
  • 爆文能力（15分）：爆文率、爆文特征分析、爆文列表、放大倍数
  • 互动规模（20分）：互动量、互动率、收藏率、互动结构、水平衡量
  • 更新产能（15分）：周更频率、间隔标准差、发布时间分析、水平衡量

空数据模块自动隐藏：爆文数为 0 省略爆文能力；无近期作品省略近期作品；赛道痛点或优势为空省略差异化优势。

综合评分结论规则：

  • >= 60 分：必须列 >= 2 个已验证可复用的具体动作
  • < 60 分：必须先点明薄弱项对应的具体数据问题，再给对应建议

步骤 6：展示相似账号 -- 从脚本返回数据的 similar_accounts 字段提取 2-5 个相似账号，按格式直接展示：

1. [账号名](https://www.xiaohongshu.com/user/profile/[accountId])
| 粉丝：[followerCount] | 总互动：[总点赞+总收藏] | 活跃评分：[评分]
推荐理由：[基于数据总结值得学习的点]
发文特点：[总结内容特征和策略]
可学之处：[具体可复制的策略]

回复序号可继续分析！

步骤 7：生成 HTML 报告并展示：

  • 7.1：调用脚本 python scripts/xiaohongshu_analyzer.py build_report_data --account_name "账号名" 生成 output/report_data.json
  • 7.2：填充 AI 分析内容到 report_data.json（与对话输出完全一致），数值字段填纯数字（不带 % 和单位），空值留空字符串 ""
  • 7.3：调用脚本生成 HTML：python scripts/xiaohongshu_analyzer.py generate_html
  • 7.4：直接在对话中展示 HTML 文件内容

高级使用

多账号对比流程：

5M. 依次为每个账号输出诊断报告，最后输出对比总结（核心差异、共同问题、发展建议）。 6M. 展示相似账号（同步骤 6）。 7M. 生成多账号 HTML 报告（使用多账号模板）：

  • python scripts/xiaohongshu_analyzer.py build_multi_report_data --account_names "账号1,账号2"
  • 填充各账号分析内容到 output/multi_report_data.json
  • python scripts/xiaohongshu_analyzer.py generate_multi_html

可选分支：

  • 用户提供后台数据：直接使用数据生成报告，无需调用查询接口
  • 用户回复序号继续分析相似账号：获取该账号 userId，调用完整诊断流程（步骤 3-7）

常用指令速查

场景用户输入预期产出
单账号诊断分析小红书号 26112666886输出七维度诊断报告，推荐相似账号，生成 HTML 报告
多账号对比帮我对比分析 ID1 和 ID2分别输出各账号诊断报告 + 横向对比总结 + 生成对比 HTML
分析相似账号回复序号 "1" 选择相似账号对选中的相似账号进行完整诊断分析
订阅更新账号无作品数据时回复 "订阅"30 分钟后自动推送诊断报告

---

5. 使用场景

1. 个人创作者自诊：输入自己的小红书号，获取七维度评分和针对性优化建议，发现定位模糊、选题迷茫等真实问题。 2. MCN 机构批量评估：输入多个签约博主的小红书号，多账号对比分析，识别潜力账号和需要重点扶持的账号。 3. 品牌方筛选合作达人：对候选达人进行账号诊断，评估其商业价值、粉丝质量和内容能力，辅助投放决策。 4. 竞品账号分析：输入竞品小红书号，获取完整的账号画像和 SWOT 分析，发现可借鉴的策略和可追赶的机会点。

---

6. 项目架构

目录结构

xiaohongshu-account-analyzer/
├── SKILL.md                        # 本文件
├── scripts/
│   ├── xiaohongshu_analyzer.py     # query查询数据，build_report_data生成模板，generate_html生成报告
│   ├── html_generator.py           # HTML报告生成逻辑，模板替换、字段填充、条件移除
│   └── html_checker.py             # HTML数据完整性检查与修复
├── references/
│   ├── report_template.md          # 诊断报告输出模板（生成报告前必须先读取）
│   ├── api_guide.md                # 接口字段和评分逻辑说明
│   └── workflow_guide.md           # 开场白、查询结果、相似账号展示、评分体系和数据填写指南
├── assets/
│   ├── report_template.html        # 单账号HTML格式报告模板
│   ├── report_data_template.json   # 单账号报告数据模板
│   ├── multi_report_template.html  # 多账号对比HTML格式报告模板
│   └── multi_report_data_template.json # 多账号报告数据模板
└── output/
    ├── raw_data.json               # 接口原始数据
    ├── report_data.json            # 单账号报告数据
    └── multi_report_data.json      # 多账号报告数据

技术栈

技术用途
Python 标准库HTTP 请求与数据解析
红狐 API小红书账号数据来源
WebSearch博主背景信息补全
HTML / CSS可视化诊断报告渲染

核心模块说明

  • xiaohongshu_analyzer.py：主脚本，包含 query（查询数据保存 raw_data.json）、sync_notes（数据同步）、build_report_data（生成 report_data.json 模板）、generate_html / generate_multi_html（生成 HTML 报告）子命令。
  • html_generator.py：HTML 报告生成逻辑，包含模板替换、字段填充、条件移除等功能。
  • html_checker.py：HTML 数据完整性检查与修复，检测缺失字段并填充默认值。

资源索引

文件用途
scripts/xiaohongshu_analyzer.pyquery查询数据保存raw_data.json，build_report_data生成report_data.json模板，generate_html生成HTML报告
scripts/html_generator.pyHTML报告生成逻辑
scripts/html_checker.pyHTML数据完整性检查与修复
references/report_template.md生成报告前必须先读取此模板
references/api_guide.md理解接口字段和评分逻辑时读取
references/workflow_guide.md处理开场白、查询结果、相似账号展示、评分体系和数据填写时读取
assets/report_template.html单账号HTML格式报告模板
assets/report_data_template.json单账号报告数据模板
assets/multi_report_template.html多账号对比HTML格式报告模板
assets/multi_report_data_template.json多账号报告数据模板

---

7. 常见问答

安装

Q: 需要安装什么依赖？ A: 无需安装第三方依赖，使用 Python 标准库即可。

Q: 如何配置 API Key？ A: 请前往 红狐hub 获取 API KEY，通过环境变量 REDFOX_API_KEY 配置。

使用

Q: 分析基于多久的数据？ A: 基于近 30 天数据，确保数据时效性。

Q: 输入什么格式的小红书号？ A: 小红书号是名称下方的纯数字或字母数字组合（如 Esther1218、26112666886），非中文昵称。

Q: 查询不到账号怎么办？ A: 系统会引导数据同步并支持 30 分钟后自动推送诊断报告。

Q: 无作品数据怎么办？ A: 系统会提示用户等待更新并引导订阅提醒，也可选择 "仍然执行分析" 继续输出报告。

Q: 多账号对比输出的格式是什么？ A: 依次输出每个账号的诊断报告，然后输出对比总结（核心差异、共同问题、发展建议），各按账号分别展示。

故障排除

Q: HTML 报告与对话内容不一致？ A: 步骤 7 填充 report_data.json 时，AI 分析内容必须与对话中输出的诊断报告完全一致。HTML 只是将对话中的分析报告进行更美观的输出。

Q: 报告格式不正确？ A: 诊断报告必须严格按照 references/report_template.md 格式输出。空值字段直接隐藏对应模块，不展示 "暂无"。

Related skills

open.feishu.cnLark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493klarksuiteLark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16klarksuiteLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16kscrapegraphaiJust ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41larksuiteLark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16kmattpocockDesign An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198k
Backend & APIsbackendintegrations
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.