核心用法
xiaohongshu-skills 是一套面向小红书平台的完整自动化解决方案，通过 Python 脚本调用 Chrome DevTools Protocol（CDP）控制浏览器实现操作。核心架构采用 CLI 命令行接口，包含五大子技能模块：
- xhs-auth：账号认证管理，支持二维码登录、手机号验证码登录及多账号切换
- xhs-publish：图文/视频内容发布，含本地图片上传和 URL 图片下载
- xhs-explore：内容发现与搜索，支持首页Feed获取、关键词搜索、笔记详情查看及用户主页分析
- xhs-interact：社交互动操作，包括评论、回复、点赞、收藏等
- xhs-content-ops：复合运营工作流，整合竞品分析、热点追踪、批量互动等高阶功能
使用前需通过 chrome_launcher.py 启动带调试端口的 Chrome 实例，所有操作均通过 python scripts/cli.py <子命令> 执行，输出为标准 JSON 格式便于程序化处理。
显著优点
功能完整性：覆盖小红书运营全流程，从账号登录到内容发布、数据分析、社交互动，形成闭环工作流，无需人工切换多个工具。
技术可靠性：基于 Chrome CDP 协议而非逆向破解，通过真实浏览器环境操作，有效规避平台风控检测。代码包含 stealth.js 反检测脚本，隐藏自动化特征。
多账号支持：内置账号管理系统，支持 cookies 持久化存储和快速切换，适合矩阵运营场景。
结构化输出：CLI 返回 JSON 格式数据，便于与现有数据 pipeline 集成，支持自动化报表生成。
开源透明：MIT 协议开源，代码结构清晰，依赖知名库（requests、websockets），安全审计可追溯。
潜在缺点与局限性
环境依赖重：必须本地安装 Chrome 浏览器并保持运行，占用系统资源；Linux/Darwin 双平台支持但 Windows 未明确兼容。
稳定性风险：平台反爬策略升级可能导致脚本失效；CDP 协议版本与 Chrome 版本需匹配，更新不同步时易出错。
功能边界：依赖小红书 Web 端能力，部分 App 端功能（如直播、部分特效）无法实现；图片视频处理需预处理为符合平台规范的格式。
安全合规灰色地带：自动化操作可能违反小红书用户协议，存在账号限流或封禁风险；stealth.js 注入属于规避检测行为，平台识别后可能加重处罚。
隐私数据处理：登录凭证明文存储于本地文件系统，多用户共享设备存在泄露风险；二维码解码依赖第三方在线服务，存在数据外流隐患。
适合的目标群体
- 小红书运营人员：负责多账号内容分发、数据监控、竞品分析的社媒运营者
- 内容创作者：需要批量发布、定时更新、高效管理粉丝互动的个人博主
- MCN 机构：管理达人矩阵、进行批量数据采集和内容分发的团队协作场景
- 市场研究人员：需要抓取公开笔记数据、分析热点趋势、生成行业报告的分析师
- 自动化爱好者：希望将小红书运营工作流整合到现有自动化体系的技术用户
使用风险与注意事项
账号安全风险：自动化行为被平台识别后可能导致限流、降权或永久封禁；建议控制操作频率，避免短时间内高频点赞、评论、发布。
数据安全建议：cookies.json 包含有效会话凭证，建议设置 700 目录权限并避免版本控制提交；可考虑使用系统密钥库加密存储。
法律合规边界：仅用于管理自有账号，禁止用于批量注册、恶意刷量、数据采集贩卖等违规用途；遵守《网络安全法》及平台用户协议。
技术维护成本：Chrome 版本更新、小红书前端改版均可能导致脚本失效，需持续关注维护；subprocess 调用和外部网络请求存在潜在注入风险，建议审查输入参数。
性能与稳定性：长时间运行可能出现内存泄漏或浏览器崩溃，建议定期重启 Chrome 实例；网络不稳定时操作易超时失败。