Xiaohongshu (小红书) Automation 技能包

做小红书运营的人都知道痛点在哪:选题要刷信息流、竞品要逐篇点开看数据和评论、发笔记要在手机上写标题正文传图——一天下来光重复操作就占掉大半天。想用脚本自动化吧,小红书又没有开放 API,网上的爬虫方案要么三天两头失效,要么直接把 Cookie 明文塞进代码里,安全感人。

Xiaohongshu (小红书) Automation 是 borye 维护的技能包,本质是知名开源项目 xpzouying/xiaohongshu-mcp(GitHub 8.4k+ stars)的 MCP 客户端封装:本地起一个小红书 MCP 服务器,扫码登录后,模型就能通过五个命令完成搜索、笔记详情分析、推荐流浏览和图文发布。社区数据:收藏 148.2k、安装 33.4k,专业技能榜 #44,当前版本 1.0.0,2026 年 5 月 1 日通过 CLS 安全性认证,整包只有 4.5 kB。下面进正题,先给下载,再一层层拆。

百度网盘下载:https://pan.baidu.com/s/1Nq02af2SQTmRQqSIebXGoA?pwd=463q(提取码:463q)

通过网盘分享的文件:borye-xiaohongshu-mcp-1.0.0.zip
链接: https://pan.baidu.com/s/1Nq02af2SQTmRQqSIebXGoA?pwd=463q 提取码: 463q 复制这段内容后打开百度网盘手机App,操作更方便哦

一、基本信息

这一章把关键参数汇总成一张表,装之前扫一眼,能避免大部分预期落差——尤其是”它不是开箱即用”这一点,后面会反复出现。

技能名称 Xiaohongshu (小红书) Automation(xiaohongshu-mcp)
维护方 borye(个人开发者);底层依赖 xpzouying/xiaohongshu-mcp 开源项目(GitHub 8.4k+ stars)
定位 小红书自动化运营的 MCP 客户端封装:图文发布、搜索、笔记详情分析、推荐流浏览
版本 1.0.0
社区数据 收藏 148.2k · 安装 33.4k · 专业技能榜 #44
安全认证 CLS 安全性认证(2026-05-01);Skill 本身无凭证、无外网请求,风险主要在部署与使用层
运行环境 Python 3 + requests;需本地部署 xiaohongshu-mcp 服务器(下载平台二进制,扫码登录)
启动命令 python scripts/xhs_client.py status / search / detail / feeds / publish
包体大小 4.5 kB(zip),客户端脚本约 264 行
下载安装 borye-xiaohongshu-mcp-1.0.0.zip(网盘,提取码 463q)
标签 xiaohongshu · social-media · mcp · content-publishing · automation · rednote

二、它解决什么问题

小红书是内容营销绕不开的阵地,但它对自动化始终是敌意状态:没有面向个人的开放 API,网页版登录态难维持,反爬策略激进。结果就是运营工作大量停留在手工阶段——想调研某个关键词下的爆款笔记,得一条条刷;想分析竞品的评论风向,得逐篇打开复制粘贴。市面上的”小红书工具”很多,但不少是来路不明的第三方平台,要求你把账号 Cookie 交给别人的服务器,风险不可控。

这个技能包的思路是把整条链路留在本地:xpzouying/xiaohongshu-mcp 服务器用无头浏览器模拟登录,凭证保存在本机;Skill 包只提供约 264 行的 Python 客户端,通过 localhost:18060 的 HTTP 接口调用服务器,全程不直接访问外网。模型不用碰 Cookie,也不用伪造请求签名,只管发命令、拿结构化结果。代价是你要自己负责部署服务器、维持会话,并且承担平台合规风险——这是后面绕不开的部分。

一句话设计哲学:凭证留在本地、操作走本地接口,Skill 只做薄薄一层翻译,把复杂度和风险都挡在架构之外。

三、核心功能

1. 五个命令覆盖完整运营链路

客户端把服务器能力收敛成五个子命令,每个都对应运营里的一类动作:

命令 作用 示例
status 检查登录状态,确认服务器就绪 python scripts/xhs_client.py status
search 按关键词搜索笔记,返回列表(含 feed_id 和 xsec_token) python scripts/xhs_client.py search “咖啡”
detail 用 feed_id + xsec_token 取完整笔记内容与评论 python scripts/xhs_client.py detail “note_id” “token”
feeds 拉取推荐流,观察当前账号的内容画像 python scripts/xhs_client.py feeds
publish 发布图文笔记:标题、正文、图片 URL python scripts/xhs_client.py publish “标题” “正文” “url1,url2”

search 返回的 xsec_token 是个关键细节:小红书的笔记详情接口需要它做访问凭证,客户端把这一步串联好了,拿到搜索结果就能直接查详情,不用自己研究反爬参数。

2. 调研-分析-发布的工作流闭环

五个命令串起来就是一条完整的运营流水线:先用 status 确认服务器和登录态就绪;再用 search 调研目标关键词下的竞品笔记,看哪些选题、哪些标题结构在热榜上;接着用 detail 深入分析高互动笔记的正文写法和评论区风向——用户在骂什么、追问什么,往往就是下一篇的选题;最后按需用 publish 把成稿发出去。整个过程模型都能参与,比如让 AI 读完十条笔记的详情后总结共性、起草新标题,人只做终审。

3. 架构上的安全设计

这套封装最值得说的是边界感。凭证存在本地服务器的会话里,Skill 包内不落任何账号信息;客户端唯一的第三方依赖是 requests,代码 264 行,半小时能读完;所有请求走 localhost:18060,不直接访问小红书域名。服务器提供无头模式(默认)和可视化浏览器模式(-headless=false,调试用),登录靠扫码,首次配好之后日常使用不再碰浏览器。对比那些把 Cookie 写进配置文件、上传到第三方云端的方案,这套架构在隐私上干净得多。

四、真正有价值的地方

1. 上游项目可信度扎实。核心能力来自 xpzouying/xiaohongshu-mcp,GitHub 8.4k+ stars 的活跃开源项目,反爬适配由上游社区持续维护——这比个人闭源脚本靠谱一个量级,失效了也有人修。

2. 凭证不出本机。扫码登录、会话保存在本地服务器,Skill 里没有也不需要任何密钥。对账号安全敏感的运营者,这是选它的首要理由。

3. 代码透明到可以审。客户端 264 行、唯一依赖 requests,部署前把整份代码读一遍毫无压力。出了问题也容易定位——是服务器没起、会话掉了,还是接口参数变了,看一眼输出就知道。

4. 功能覆盖运营主链路。搜索、详情、评论、推荐流、发布一条龙,日常选题调研和内容发布的 80% 手工操作都能搬进来。虽然有接口能力的边角没暴露(比如用户主页管理),但核心场景是完整的。

5. 结构化输出对模型友好。search 直接带上 feed_id 和 xsec_token,detail 返回完整正文与评论列表,模型拿到就能继续加工,不需要二次解析 HTML。这让”让 AI 做竞品分析报告”从概念变成了十几分钟就能跑通的事。

6. 部署一次,长期复用。服务器和登录态配好之后,日常使用只剩命令调用,登录工具只在会话失效时才需要重跑。相比每次都要起浏览器、过验证的临时脚本方案,这套常驻架构的边际成本几乎为零,团队多人共用一台机器部署也完全可行。

五、绕不开的问题

1. 外部依赖重,不是开箱即用。Skill 只是客户端,你得自己去 GitHub Releases 下载对应平台的二进制(macOS、Windows、Linux 各有版本)、跑登录工具扫码、再单独开个终端把服务器挂起来。服务器进程一停,所有命令都失效。

2. 平台合规风险是悬顶之剑。这套方案本质是浏览器自动化访问小红书,可能违反平台服务条款;高频搜索或发布容易触发反爬,存在限流乃至封号风险。官方文档自己都建议不要在别的浏览器登录同一账号——因为会话是独占的,顶掉就失效。

3. 部署门槛实打实存在。下载二进制、chmod 加执行权限、跑登录工具、保持服务器运行——对纯小白不算友好,而且服务器是个前台进程,终端一关就没了,想常驻得自己配 systemd 或 launchd。

4. 无许可证声明。Skill 包本身没有 LICENSE 文件,个人使用没什么问题,但想在商业产品里集成,法律边界得自己掂量。

5. 没有批量与定时能力。命令是单次调用的,没有队列、没有定时发布、没有多账号管理。想做”每天九点自动发一条”,得自己在脚本层包 cron——Skill 只给原子能力,不给调度。

6. 会话是独占资源。登录态绑定在本地服务器的浏览器会话里,任何其他浏览器登录同一小红书账号都会把会话顶掉,日常使用时要养成习惯:这个账号的网页版别再碰了。

六、官方风险表与解读

风险项 级别 说明
账号安全 🔴 高 自动化操作用真实账号登录,建议使用独立小号,不要绑主力账号
平台合规 🔴 高 可能违反小红书服务条款,高频操作触发反爬机制,存在限流封号风险
上游依赖 🟡 中 核心能力依赖 xpzouying/xiaohongshu-mcp,上游接口变动需同步更新
会话管理 🟡 中 18060 端口勿暴露公网;其他浏览器登录同一账号会顶掉本地会话

解读:这张表里两条红色都指向同一个根源——你在用真实账号做平台不鼓励的事。代码本身没有恶意行为(CLS 认证也印证了这一点),风险全部来自使用方式。所以隔离措施要做到位:一条实用纪律是,永远用独立的运营小号跑这套流程,主力账号绝不登录;服务器只监听本机,18060 端口不做任何公网暴露。

七、适合谁,不适合谁

类型 是否适合 理由
内容营销与运营人员 ✅ 适合 选题调研、竞品分析、评论风向监测一键化,节省大量手工时间
自媒体博主 ✅ 适合 用 AI 分析爆款结构再辅助创作,发布链路也走得通
市场研究机构 ✅ 适合 结构化的搜索与详情接口适合做品牌声量的持续监测
开发者/自动化爱好者 ✅ 适合 264 行代码 + 8.4k stars 上游,是学习 MCP 架构的好样本
不想折腾部署的用户 ⚠️ 谨慎 要手动下载二进制、扫码登录、维持服务器进程,纯小白容易卡在第一步
只有主力账号的用户 ❌ 不适合 限流封号风险真实存在,别拿主号试水
追求批量定时发布的团队 ❌ 不适合 无队列无调度,高级自动化要自己开发,预期要摆正

八、落地路径

  1. 下载解压:从文末网盘链接取 borye-xiaohongshu-mcp-1.0.0.zip,解压确认 scripts/xhs_client.py 与 SKILL.md 齐全。
  2. 部署服务器:到 xpzouying/xiaohongshu-mcp 的 GitHub Releases 下载对应平台二进制,chmod +x 赋权,先用 -headless=false 跑通一次。
  3. 扫码登录:运行 xiaohongshu-login 工具,弹出浏览器后用小红书 App 扫码——这一步务必用独立小号。
  4. 验证链路:开一个终端常驻服务器,另开终端跑 python scripts/xhs_client.py status,看到已登录状态后用 search 试搜一个关键词,确认返回 feed_id 和 xsec_token。
  5. 调研分析:search 锁定关键词 → detail 拉高互动笔记的正文与评论 → 让模型总结选题规律和评论风向,产出调研笔记。
  6. 试水发布:用 publish 发一条测试笔记到小号,确认图片 URL、格式渲染都正常后,再把正式内容搬进工作流。

九、文件构成与安装

文件/目录 大小 作用
SKILL.md 3.8 kB 技能说明:服务器部署三步、命令表、市场调研工作流示例
scripts/xhs_client.py 10.2 kB Python 客户端:约 264 行,封装五个子命令,唯一依赖 requests
_meta.json 134 B 包元数据:名称、版本与来源信息

安装建议:Skill 本身解压即用,真正的工作量在服务器侧——下载二进制、扫码登录、保持进程运行这三步一次配好,之后就是日常的命令调用。建议把服务器启动命令写成一个 shell 脚本,登录态失效时能快速重建;xhs_client.py 不用改,若要扩展命令(比如批量搜索),照着现有函数的写法加就行,代码短到改造成本可以忽略。另外提醒一句:本地路径装好后,把整个目录放进版本管理没必要,但给自己留一份部署步骤笔记很有必要。

十、常见问题

1. 需要 API key 吗?会不会泄露账号?

不需要任何 key。登录态由本地服务器持有,Skill 包内没有凭证,客户端也不发送账号信息到任何第三方——所有请求都走 localhost:18060。安全边界在你自己的机器上。

2. 能发视频吗?

技能定位里包含视频发布,但客户端当前暴露的 publish 命令走的是图文路径(标题、正文、图片 URL)。视频发布建议关注上游 xiaohongshu-mcp 的版本更新,接口能力扩展后会同步。

3. 服务器必须一直挂着吗?

是。客户端是无状态的,每次调用都请求 localhost:18060,服务器进程停了命令就全部失败。日常使用建议让服务器常驻(nohup 或 systemd),别依赖前台终端。

4. 为什么别在浏览器登录同一个账号?

小红书网页登录态是互斥的,你在 Chrome 里登一次,本地服务器的会话就被顶掉,status 会显示未登录,得重新扫码。这个账号就专属于这套自动化流程,网页版别碰。

5. 高频操作会被封号吗?

有这个风险,而且不低。搜索和发布频率拉高后容易触发风控——限流是轻的,严重会封号。控制调用节奏、用小号、模拟人工间隔,是降低风险的基本操作。

6. 客户端报连接失败怎么办?

先确认服务器进程是否存活、端口是否是 18060,再用 status 排查。最常见的原因有两个:服务器没启动,或者会话被其他浏览器的登录顶掉了——后者重新跑一次登录工具扫码即可恢复。连接类问题基本都能在两分钟内定位。

7. search 结果里的 xsec_token 是什么?

小红书详情接口的访问凭证,每次搜索会话生成。调用 detail 时必须把 search 返回的 feed_id 和 xsec_token 成对传入,过期了就重新搜一次拿新 token。这个机制正是小红书反爬的核心,客户端已经替你处理好了。

8. Windows 和 Linux 能用吗?

能。上游 Releases 提供 macOS(Apple Silicon/Intel)、Windows、Linux amd64 四套二进制,客户端脚本是纯 Python,平台无关,照 SKILL.md 的表选对下载就行。

结语

Xiaohongshu (小红书) Automation 是个定位清晰的”薄封装”:4.5 kB 的包,264 行代码,把 8.4k stars 的上游项目接进 AI 工作流,搜索、分析、发布全链路留在本地跑。它的价值在于把凭证安全、代码透明、平台适配这三件难事交给了架构和上游社区;它的风险也明明白白——平台合规与账号安全,需要用小号、限频率、不暴露端口这些纪律去对冲。想给小红书运营装上自动化引擎的用户,值得一试,但请从测试号开始。

通过网盘分享的文件:borye-xiaohongshu-mcp-1.0.0.zip
链接: https://pan.baidu.com/s/1Nq02af2SQTmRQqSIebXGoA?pwd=463q 提取码: 463q 复制这段内容后打开百度网盘手机App,操作更方便哦

关键词:Xiaohongshu、小红书自动化、Skills技能包、MCP、内容发布、竞品分析、xpzouying、rednote、social-media、automation

百度网盘下载:https://pan.baidu.com/s/1Nq02af2SQTmRQqSIebXGoA?pwd=463q(提取码:463q)

THE END
喜欢就支持一下吧
点赞51 分享
评论 抢沙发
头像-知了AI
欢迎您留下宝贵的见解!
提交
头像-知了AI

昵称

取消
昵称表情代码快捷回复

    暂无评论内容