你有没有遇到过这种情况？

辛辛苦苦写了一篇小红书笔记，打开网页版准备发布，结果发现还要一张张上传图片、手打标签、选择定时发布时间...一套操作下来，十分钟就过去了。如果你每天要发三五篇，那光是在发布这件事上，就得耗费小半天。

更别提那些做矩阵号的兄弟们了，手里握着十几个账号，每次发布都要重复登录、退出、再登录，简直是一场噩梦。

今天要分享的这个开源项目，就是专门解决这个痛点的。它是一个基于Python的小红书自动化工具，能帮你搞定从登录、发布到互动的全套操作。

项目亮点🚀 一键发布图文/视频支持从本地或URL直接上传，自动填写标题和正文，识别话题标签，全程无需人工干预。

👥 多账号管理每个账号独立Chrome配置文件，Cookie完全隔离，支持一键切换，矩阵号运营神器。

🔍 内容检索与互动能抓取首页推荐、搜索笔记、查看详情，甚至支持自动评论、回复、点赞收藏。

📊 数据看板导出自动抓取笔记的曝光、观看、点赞等数据，生成CSV表格，方便分析复盘。

📱 登录二维码导出支持返回Base64格式的登录二维码，可以集成到你的前端页面，远程扫码登录。

解决什么痛点？先给你讲个小故事。

我的朋友老张，是个小红书博主，手里运营着三个账号：一个是自己的个人IP号，一个是公司的品牌号，还有一个是帮客户代运营的种草号。

每天早上一睁眼，老张就要开始他的“发布仪式”：打开Chrome，登录账号A，上传图片，写文案，设置定时，发布；然后退出登录，清除缓存，登录账号B，重复以上操作...

最崩溃的是，有一次他急着出门，三个账号的发布时间都设错了，结果内容全堆在同一分钟发出，被平台判定为营销号，限流了整整一周。

老张来找我诉苦的时候，我二话不说，把这个项目发给了他。现在，他每天只需要准备好素材，运行一下脚本，三篇笔记自动排队发布，还能顺手把前一天的數據导出来分析。用他的话说：“终于有時間睡個囫圇覺了。”

这就是这个项目要解决的问题：把那些重复、枯燥、容易出错的发布工作，交给代码去完成，让你把精力放在真正重要的内容创作上。

手把手教程好了，不扯远了，咱们直接上手试试。

➤ 环境安装首先，确保你的电脑满足以下条件：

• Python 3.10 或更高版本
• 安装了 Google Chrome 浏览器
• Windows系统（目前主要支持Windows，其他系统可能需要调整）

打开命令行，执行：pip install -r requirements.txt

如果你没有下载项目源码，可以先克隆下来：git clone https://github.com/Angiin/Post-to-xhs.gitcd Post-to-xhs

---

➤ 首次登录与账号配置这个项目最贴心的一点，就是帮你把每个账号的登录状态都独立保存，互不干扰。

先来看看账号管理功能：

查看账号列表

python account_manager.py list

添加一个新账号，比如叫“我的生活号”

python account_manager.py add shenghuo --alias "生活记录号"

查看某个账号的详细信息

python account_manager.py info shenghuo

第一次使用，需要先登录。运行下面的命令，会自动打开一个Chrome窗口：python scripts/cdp_publish.py login

在弹出的浏览器里，扫码登录你的小红书账号。登录完成后，关掉浏览器就行，登录状态会自动保存在默认的profile里。

如果你想为刚才添加的“shenghuo”账号单独登录，可以指定账号名：python scripts/cdp_publish.py login --account shenghuo

---

➤ 检查登录状态登录完了，先确认一下状态对不对：python scripts/cdp_publish.py check-login

如果返回“已登录”，恭喜你，可以继续了。如果显示未登录，它会自动切换到有窗口模式，引导你重新扫码。

这里有个小技巧：如果你在写代码集成这个功能，可以用 get-login-qrcode 命令获取登录二维码的Base64数据，直接展示在你的前端页面上，让用户远程扫码。python scripts/cdp_publish.py get-login-qrcode

---

➤ 发布图文内容重头戏来了。假设你今天写了一篇笔记，标题是“周末探店｜藏在胡同里的宝藏咖啡馆”，正文写了一堆种草文案，还准备了3张图片的URL。

想一键发布？只需一行命令：python scripts/publish_pipeline.py --headless--title "周末探店｜藏在胡同里的宝藏咖啡馆"--content "这家咖啡馆真的太有感觉了，藏在南锣鼓巷深处，手冲咖啡绝了！#北京探店 #咖啡馆 #周末去哪儿"--image-urls "https://example.com/coffee1.jpg" "https://example.com/coffee2.jpg" "https://example.com/coffee3.jpg"

--headless 参数表示无头模式运行，不会弹出浏览器窗口，适合服务器或后台运行。如果你想亲眼看着它怎么操作，去掉这个参数就行。

如果你用的是本地图片，可以这样：python scripts/publish_pipeline.py --title "..." --content "..." --images /path/to/photo1.jpg /path/to/photo2.jpg

发布视频也很简单，把 --image-urls 换成 --video 或 --video-url 即可。

➤ 预览模式如果你担心脚本操作太快，想先看看填写效果再手动发布，可以加上 --preview 参数：python scripts/publish_pipeline.py --title "..." --content "..." --image-urls "..." --preview

这样脚本只会帮你填好标题、正文、传好图片，但最后一步点击“发布”的动作会留给你手动确认。

➤ 高级功能：内容检索与互动这个项目不仅能发布，还能帮你抓取内容、自动互动。

比如你想看看首页推荐了哪些笔记：python scripts/cdp_publish.py list-feeds

想搜索关键词“露营装备”：python scripts/cdp_publish.py search-feeds --keyword "露营装备"

看到一篇感兴趣的笔记，想看看详情和评论？先用搜索找到它的 feed_id 和 xsec_token（搜索结果里会返回），然后：python scripts/cdp_publish.py get-feed-detail --feed-id 123456789 --xsec-token abcdefg --load-all-comments

觉得这篇笔记不错，想点个赞？python scripts/cdp_publish.py note-upvote --feed-id 123456789 --xsec-token abcdefg

想评论一句“写得真好”？python scripts/cdp_publish.py post-comment-to-feed --feed-id 123456789 --xsec-token abcdefg --content "写得真好，收藏了！"

这些功能组合起来，完全可以搭建一个自动化的“养号”机器人。

➤ 多账号切换与发布如果你有多个账号，想用“生活记录号”来发布刚才的内容：python scripts/publish_pipeline.py --account shenghuo --title "..." --content "..." --image-urls "..."

想切换默认账号：python account_manager.py set-default shenghuo

设置之后，后续不指定 --account 的命令都会用这个账号执行。

➤ 浏览器控制小技巧有时候想单独打开一个测试浏览器，看看登录状态或者手动操作一下：

启动测试浏览器（有窗口）

python scripts/chrome_launcher.py

无头模式启动

python scripts/chrome_launcher.py --headless

用完记得关掉

python scripts/chrome_launcher.py --kill

如果你有多台机器，还可以连接远程Chrome调试端口：python scripts/cdp_publish.py --host 192.168.1.100 --port 9222 check-login

同类项目对比市面上也有一些类似的小红书自动化工具，我把它们和这个项目做了个对比：

从表格能看出来，这个项目在功能完整性、性能和开放性上都有明显优势。特别是多账号隔离这个设计，对于矩阵号运营来说简直是刚需——每个账号独立的Chrome profile，不会互相干扰，也不会因为一个账号出问题导致其他账号都被封。

还有个细节值得提：项目里专门有一个 run_lock.py 模块，确保同一时间只有一个发布进程在运行。这个设计很贴心，防止你一不小心同时跑多个脚本导致冲突。

如果你对代码感兴趣，可以看看 scripts/cdp_publish.py 里的 SELECTORS 部分。这里定义了小红书网页版的各种元素定位器，如果以后小红书改版导致脚本失效，优先检查这里就好。项目作者已经把2026年2-3月的改版都适配好了，短期内应该问题不大。

写在最后说实话，这种自动化工具就像一把双刃剑。用得好，它能把你从重复劳动里解放出来，让你有更多时间打磨内容、思考创意；用得不好，也可能会让你陷入“只求数量不求质量”的陷阱。

我的建议是，把它当作你的得力助手，而不是内容的制造机。素材还是要用心准备，文案还是要真诚打磨，只是把最后那几步机械操作交给它去做。

就像老张现在，每天还是花同样的时间准备内容，但多出来的那一两个小时，他会去翻翻评论区，和粉丝聊聊天，或者研究一下最近的热门趋势。这才是运营账号的正确姿势，对吧？

好了，今天就聊到这儿。有什么问题欢迎在评论区留言，我会尽力解答。如果你也有好用的自动化工具推荐，也别忘了分享出来！