返回市场
新华社-MCP

新华社-MCP

作者:lastkimi0 星标更新:2025-11-19

项目介绍

XHS-CLI/XHS-MCP

小红书MCP服务器及CLI工具,专为个人创作者设计——帮助创作者管理、分析和发布小红书内容。

License: MIT Node.js Version MCP Protocol

为什么选择XHS-CLI

个人创作越来越依赖各种数字工具,但缺乏将它们连接在一起的粘合剂。XHSCLI通过统一的CLI和MCP服务器,将浏览器自动化、内容模板、数据接口和AI协作能力打包在一起,使创作者能够在本地脚本、自动化服务或智能助手中无缝调用同一套小红书工作流程,真正实现“内容策略物料生成账户运营”的全链路联动。

🚀 最近更新

  • Trae编辑器支持 -增加了对Trae编辑器的MCP集成支持
  • 内容模板优化 -提供了5个主题样本模板,涵盖美容、日常生活和求助等场景
  • MCP配置增强 -支持描述、类型和禁用状态等高级配置选项
  • 示例管理 -内置示例文章系统,支持查看、创建和管理内容模板

核心功能

  • 🔗 一套CLI/MCP接口可以连接浏览器自动化、脚本和AI,构建自己的内容工作流
  • 📥 扫描并缓存历史笔记,将其作为上下文提供给智能助手或自动化过程
  • 🎯 根据模板生成新的内容、封面和材料,确保账户语气的一致性
  • 📊 拉取运营/画像数据,并按顺序输出以进行可视化或进一步分析
  • 🚀 开放整个发布、调度和材料管理的过程,便于接入任何数字工具链
  • 📝 内容样本系统 -内置丰富的主题模板,快速生成高质量内容
  • 🤖 多编辑器支持 -支持主流AI编辑器如Claude Desktop、Cursor和Trae

安装

# 全局安装(推荐)
npm install -g xhs-cli

注意

  • 此包在安装过程中无法下载Chromium(减少安装体积),会自动使用系统已安装的Chrome/Chromium浏览器
  • 如果您的系统未安装Chrome/Chromium,请先安装Chrome浏览器,然后运行xhs login命令。

前提条件

  • Node.js >= 18.0.0
  • Chrome/Chromium浏览器(Puppet所需)

快速开始

1. 登录

xhs login

这将打开浏览器并允许您登录到您的小红书账户。

Xhs CLI不会保存您的登录信息,所有信息都存储在您的浏览器中。

2. 检查登录状态

xhs check-login

3. 注销并重新登录

xhs logout

这将清除并保存在~/.xhs-mcp/browser-data的浏览器缓存文件,下次需要重新登录。

4. 获取账户信息

xhs get-my-profile

可用命令

账户管理

# 登录小红书账号
xhs login

# 退出登录并清除缓存
xhs logout

# 检查登录状态
xhs check-login

# 获取用户资料
xhs get-my-profile

数据获取

# 获取运营数据
xhs get-operation-data

# 获取近期笔记列表
xhs get-recent-notes

# 根据笔记ID获取笔记详情
xhs get-note-detail-by-id <noteId>

内容发布

# 将帖子添加到队列
xhs add-post "内容" --title "标题" --images "img1.jpg,img2.jpg" --scheduled-time "2024-01-01T10:00:00Z"

# 发布队列中的帖子
xhs post [filename]

# 列出待发布的帖子
xhs list-available-post

查看帮助

xhs

不带参数运行将显示所有可用命令的详细描述。

MCP服务器

此包也是一个MCP(模型上下文协议)服务器,可以与支持MCP的客户端(如Cursor、Claude Desktop、Trae等)集成。

🎯 支持的编辑器

  • Claude Desktop -Anthropic官方AI助手
  • Cursor -AI驱动的代码编辑器
  • Trae -新一代AI编程工具

配置MCP客户端

有关详细的MCP配置说明,请参阅仓库根目录下的MCPCOOKBOOK

快速配置

# 配置所有支持的编辑器
npm run setup-mcp -- --all

# 单独配置 Trae
npm run setup-mcp -- --trae

# 单独配置 Claude Desktop
npm run setup-mcp -- --claude

# 单独配置 Cursor
npm run setup-mcp -- --cursor

配置完成后,请重启相应的编辑器以使用MCP功能。

特点

  • ✅ 完整支持TypeScript
  • ✅ 缓存机制保护账户访问频率
  • ✅ 命令行工具,易于使用
  • ✅ 支持MCP协议,可集成AI工具
  • ✅ 专为个人创作者设计
  • 示例文章系统 -提供5个主题样本:美容美颜、氛围技巧、紧急求助、可爱图文和拔草防雷
  • 智能内容建议 -基于历史数据提供内容创作建议
  • 多平台MCP支持 -同时支持Claude Desktop、Cursor和Trae编辑器
  • 封面生成功能 -自动生成精美的帖子封面图片
  • 批量示例管理 -支持批量创建和管理内容

许可证

MIT

相关链接

🤝 贡献

欢迎提交Issue和Pull Requests来改进这个项目!

📝 更新日志

v1.1.0 (2024-11-18)

  • 增加了对Trae编辑器的MCP支持
  • 优化了内容模板系统,并添加了5个主题样本文章
  • 提升了MCP配置流程,支持更多自定义选项
  • 增强了示例管理和内容创作能力