这是什么
小红书账号拆解（xhs-account-teardown）是一个 AI Agent Skill，采用标准 SKILL.md 格式。它能够接收一个小红书账号链接，匿名抓取该账号的主页信息与笔记列表，下载封面图片并进行图像识别，然后按照一套“六问式”拆解框架，生成结构化的《账号拆解报告》。
该工具不绑定任何特定 AI 厂商，任何能读取 SKILL.md、能执行 shell 命令、能识别和生成图片的 Agent 都可以使用；甚至可以不使用 Agent，直接运行脚本获取数据，自行分析。
适合谁
这个 Skill 主要面向以下人群：
- 自媒体创作者：希望分析对标账号，学习其内容策略、商业变现模式。
- 电商运营者：研究小红书上的卖货账号，了解其选品、定价、营销手法。
- 内容策略分析师：需要系统化拆解账号，提炼可复用的方法论。
- AI Agent 爱好者：希望利用 AI 自动化完成账号调研和报告生成。
能做什么
该 Skill 提供以下核心能力：
- 匿名抓取主页：通过手机 UA 抓取账号 SSR，获取用户信息（昵称、简介、粉丝数等）和第一页笔记列表（最多 8 篇），并下载封面图。
- 封面识图拆解：利用视觉能力逐张读取封面，提取栏目期号、被拆对象截图字段（如昵称、评分、已售、粉丝、更新频率、售后标签）、品类、客单价、销量、钩子句、点睛句等信息。
- 深度拆解（可选）：如果用户提供带
xsec_token的笔记链接，可以抓取单篇笔记的完整内容，逐页识图还原论证链。 - 六问式成稿：按照
references/teardown-framework.md中的六问框架，生成结构化的《账号拆解报告》。 - 账号调性长图：默认将报告生成一张 9:16 的可分享长图，视觉风格从账号封面中抽象提炼，不直接复制受版权保护的素材。
使用前准备
在使用之前，请确保你的环境满足以下条件：
- Python 3.9+：脚本仅使用标准库，无需安装第三方包。
- curl：用于发送 HTTP 请求。
- 操作系统：macOS 和 Linux 开箱可用；Windows 用户建议在 WSL 或 Git Bash 中运行。
- Agent 能力：若要获得完整报告和长图，宿主 Agent 需要具备执行 shell 命令、读取本地图片（视觉）、写文件以及生成图片的能力。如果缺少某些能力，可以降级使用，例如仅作为方法论框架手工拆解。
安装方法
将本仓库复制或软链到你的 skills 目录。以 Claude Code 为例（全局安装）：
ln -s /path/to/xhs-account-teardown ~/.claude/skills/xhs-account-teardown之后，对 Agent 说“拆解这个账号 <链接>”即可触发。
如果你的工具不支持 SKILL.md，可以将 SKILL.md 正文贴入规则文件，并同时提供 references/teardown-framework.md 和 templates/report-template.md，脚本可手动调用。
使用示例
抓取账号主页：
python3 scripts/fetch_profile.py "https://www.xiaohongshu.com/user/profile/" -o ./work/<账号名>/产出 profile.json、notes_list.json、covers/cover1..N.jpg。
抓取单条笔记详情（需要带 token 的链接）：
python3 scripts/fetch_note.py "https://www.xiaohongshu.com/explore/?xsec_token=...&xsec_source=..." -o ./work/<账号名>/notes//产出 meta.json、desc.md、img1..N.jpg。
完整工作流包括：解析链接 → 抓主页 → 封面识图 → 深度拆解（可选）→ 六问成稿 → 生成 9:16 长图 → 核验与交付。
风险与注意事项
抓取边界：小红书匿名访问的边界较窄，以下数据无法匿名获取：
- 笔记详情（需要笔记级
xsec_token） - 第二页及以后的笔记列表（需要
x-s签名） - 搜索、评论、feed 流（需要签名或登录态）
Token 陷阱：
- Token 与笔记绑定，不能跨笔记使用。
- 主页列表中的 id 不能直接用于详情路由。
- Token 必须从登录态浏览器地址栏完整复制，包含
xsec_token和xsec_source。
风控警告：封面下载是串行限速的，同一 IP 高频请求会触发风控。失败时不要无限重试，否则会延长封锁。
数据真实性：抓不到的数据一律写“未获取”，严禁编造。报告生成时必须确保事实一致性，长图不得虚构数据。
版权合规：生成长图时不得直接复制账号的头像、人物、商标、封面原图等受版权保护的具体资产，应抽象提炼风格。
隐私保护：完整成稿样例不随仓库分发，因为包含真实第三方账号信息。使用时应遵守相关法律法规和平台规则。