|
🤖 AI 拟人化内容生成 不是模板填空，而是真正像人写的。研究了上千条爆款笔记的语气和节奏，生成的文案像发朋友圈一样自然。 |
🎨 极简封面自动生成 一句话钩子 + 莫兰迪配色，告别花里胡哨。Playwright 渲染 HTML，像素级精确。 |
|
🔌 MCP 协议接入 标准 MCP Server，接入 Claude Desktop / Cursor / 任何 MCP 客户端，用自然语言操控小红书。 |
📱 多端支持 Web UI + 移动端 App + 命令行 + 定时任务，一套代码覆盖所有场景。 |
| 能力 | 说明 |
|---|---|
| 扫码登录 | 小红书二维码登录，Cookie 自动管理 |
| AI 生成文案 | 支持任意 LLM（OpenAI / Claude / 自定义），拟人化口语风格 |
| AI 生成封面 | HTML → 截图，极简钩子风格，自动配色 |
| 发布图文笔记 | 标题 + 正文 + 图片 + 标签，一键发布 |
| 发布视频笔记 | 支持视频上传发布 |
| 每日自动发布 | 3 套模板按天轮换，Cookie 过期 Mac 通知 |
| 搜索 / 详情 | 搜索笔记、查看笔记详情、查看用户主页 |
| 互动操作 | 点赞、收藏、评论、回复评论 |
./start.sh all # 一键启动 MCP 服务 + Web UI打开 http://localhost:7788，填入 API Key → 输入主题 → 生成 → 发布
启动 MCP 服务后，在 AI 客户端中配置：
Claude Desktop / Claude Code
编辑 ~/.claude.json：
{
"mcpServers": {
"xiaohongshu": {
"type": "http",
"url": "http://localhost:18060/mcp"
}
}
}Cursor
编辑 .cursor/mcp.json：
{
"mcpServers": {
"xiaohongshu": {
"url": "http://localhost:18060/mcp"
}
}
}./start.sh daily # 手动执行一次
# 设置 Cron 定时任务（每天 12:00）
0 12 * * * cd /path/to/xiaohongshu-mcp && ./start.sh daily >> /tmp/xhs_daily.log 2>&1android-app/ 为 Capacitor 项目，可打包为 Android / iOS App，前端直接调用 AI API，无需后端。
# 1. 克隆项目
git clone https://github.com/2975647277/xiaohongshu-mcp.git
cd xiaohongshu-mcp
# 2. 安装依赖（需要 Python 3.10+）
./start.sh install
# 3. 下载 MCP 二进制文件（从 Release 页面）
# macOS ARM: xiaohongshu-mcp-darwin-arm64
# Windows: xiaohongshu-mcp-windows-amd64.exe
# 4. 一键启动
./start.sh all首次使用需要用小红书 App 扫码登录，登录后 Cookie 自动保存。
| 命令 | 说明 |
|---|---|
./start.sh all |
启动 MCP 服务 + Web UI |
./start.sh mcp |
仅启动 MCP 服务（端口 18060） |
./start.sh web |
仅启动 Web UI（端口 7788） |
./start.sh daily |
执行一次每日自动发布 |
./start.sh install |
安装 Python 依赖 |
首次启动后在 Web UI 顶部展开「API 配置」：
| 配置项 | 说明 | 示例 |
|---|---|---|
| API Key | LLM API 密钥 | sk-xxx |
| Base URL | API 地址 | https://api.openai.com/v1 |
| Model | 模型名称 | gpt-4o / claude-sonnet-4-6 |
| 坐标 | 地理位置关键词 | 花桥 |
配置保存在本地
config.json，不会上传。
展开查看全部 13 个工具
| 工具 | 说明 |
|---|---|
check_login_status |
检查登录状态 |
get_login_qrcode |
获取登录二维码 |
delete_cookies |
清除登录 Cookie |
publish_content |
发布图文笔记 |
publish_with_video |
发布视频笔记 |
search_feeds |
搜索笔记 |
list_feeds |
获取笔记列表 |
get_feed_detail |
获取笔记详情 |
like_feed |
点赞笔记 |
favorite_feed |
收藏笔记 |
post_comment_to_feed |
评论笔记 |
reply_comment_in_feed |
回复评论 |
user_profile |
查看用户主页 |
xiaohongshu-mcp/
├── start.sh # 统一启动脚本
├── app.py # Flask Web UI + AI 生成
├── daily_post.py # 每日自动发布
├── xiaohongshu-mcp-darwin-arm64 # MCP 服务二进制
├── xiaohongshu-login-darwin-arm64 # 登录服务二进制
├── templates/index.html # Web UI 页面
├── static/ # 封面模板 + 静态资源
├── android-app/ # 移动端 Capacitor 项目
│ └── www/index.html
└── deploy/ # 构建部署脚本
| 项目 | 要求 |
|---|---|
| Python | 3.10+ |
| 系统 | macOS / Windows |
| 浏览器引擎 | Playwright + Chromium（封面截图） |
| 小红书 App | 扫码登录用 |
- 本项目仅供学习和研究使用
- 使用本工具产生的一切后果由使用者自行承担
- 请遵守小红书平台的使用规则和服务条款
- 不得用于任何违法违规用途
| 打赏支持 | 交流群 | 个人微信 |
|---|---|---|
| 觉得好用可以支持一下 | 问题反馈 / 功能建议 | 备注「小红书MCP」 |
MIT