登录发现更多内容
发帖
 找回密码
 立即注册
搜索
4 3 0
返回列表 发新帖

工具小红书创作者MCP工具包-v1.2.2更新

发布新帖
资源分享 33 4 昨天 15:59
一个强大的小红书自动化工具包，支持通过MCP协议与AI客户端（如Claude Desktop等）集成，实现与AI对话即可进行内容创作、发布及创作者数据分析。
主要特性
  • Cookie管理: 安全获取、验证和管理小红书登录凭证
  • MCP协议支持: 与CherryStudio等AI客户端无缝集成
  • 自动发布: 支持图文和视频笔记的自动化发布
  • 定时任务: 支持cron表达式的定时数据采集
  • 数据采集: 自动采集创作者中心仪表板、内容分析、粉丝数据
  • AI数据分析: 中文表头数据，AI可直接理解和分析
  • 数据存储: 支持csv本地存储（sql目前保留，暂不开发）
  • 统一接口: 一个工具解决llm操作小红书自动化需求
功能清单登录
  • 登录 - 支持传统的命令行登录和通过与AI对话完成登录
内容发布
  • 图文发布 - 支持发布图文笔记
  • 视频发布 - 支持发布视频笔记
  • 内容搜索 - 支持指定搜索（开发计划中）
数据采集
  • 仪表板数据 - 采集账号概览数据（粉丝数、获赞数等）
  • 内容分析数据 - 采集笔记表现数据（浏览量、点赞数等）
  • 粉丝数据 - 采集粉丝增长和分析数据
  • 定时采集 - 支持cron表达式的自动定时采集
  • 数据存储 - CSV本地存储（默认）
环境要求 浏览器环境
  • Google Chrome 浏览器 (最新版本推荐)
  • ChromeDriver (版本必须与Chrome版本完全匹配)
查看Chrome版本
在Chrome浏览器中访问：chrome://version/
7af872d09772d4b609ae3c4ac84a5fa54f8e004e.webp
ChromeDriver安装方式方法一：自动下载（推荐）
  1. # 使用webdriver-manager自动管理

  3. pip install webdriver-manager
复制代码

方法二：手动下载
  • 访问官方下载页面：Chrome for Testing
  • 选择与您Chrome版本完全匹配的ChromeDriver
  • 下载后解压到合适位置（如 /usr/local/bin/ 或 C:\tools\）
  • 在 .env 文件中配置正确路径
方法三：包管理器安装
  1. # macOS (Homebrew)

  3. brew install --cask chromedriver

  5. # Windows (Chocolatey)

  7. choco install chromedriver

  9. # Linux (Ubuntu/Debian)

  11. sudo apt-get install chromium-chromedriver
复制代码
重要提示：版本不匹配是最常见的问题原因，请确保ChromeDriver版本与Chrome浏览器版本完全一致！

快速开始一键安装（推荐）
  1. # 下载并运行安装脚本

  3. curl -sSL https://raw.githubusercontent.com/aki66938/xhs-toolkit/main/install.sh | bash

  5. # 或者手动运行

  7. git clone https://github.com/aki66938/xhs-toolkit.git

  9. cd xhs-toolkit

  11. bash install.sh
复制代码
从源码运行方法一：uv (推荐 )
  1. # 克隆项目

  3. git clone https://github.com/aki66938/xhs-toolkit.git

  5. cd xhs-toolkit

  7. # 使用uv安装依赖并运行

  9. uv sync

  11. uv run python xhs_toolkit.py status ## 验证工具是否可用
复制代码
uv使用提示：文档中所有 python 命令都可以用 uv run python 替代，享受更快的依赖管理体验！

方法二：pip (传统方式)
  1. # 克隆项目

  3. git clone https://github.com/aki66938/xhs-toolkit.git

  5. cd xhs-toolkit

  7. # 创建虚拟环境（推荐）

  9. python -m venv venv

  11. source venv/bin/activate # Windows: venv\Scripts\activate

  13. # 安装依赖

  15. pip install -r requirements.txt

  17. python xhs_toolkit.py status ## 验证工具是否可用
复制代码
使用指南1. 创建配置文件
复制并编辑配置文件：
  1. cp env_example .env

  3. vim .env # 编辑配置
复制代码
必需配置：
  1. # Chrome浏览器路径

  3. CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

  5. # ChromeDriver路径

  7. WEBDRIVER_CHROME_DRIVER="/opt/homebrew/bin/chromedriver"
复制代码
2. 获取登录凭证
  1. python xhs_toolkit.py cookie save
复制代码
在弹出的浏览器中：
  • 登录小红书创作者中心
  • 确保能正常访问创作者中心功能
  • 完成后按回车键保存

3. 启动MCP服务器
  1. python xhs_toolkit.py server start
复制代码

4. 客户端配置
Claude Desktop
在 ~/.claude_desktop_config.json 中添加：
  1. {

  3. "mcpServers": {

  5. "xiaohongshu": {

  7. "command": "curl",

  9. "args": [

  11. "-N",

  13. "-H", "Accept: text/event-stream",

  15. "http://localhost:8000/sse"

  17. ]

  19. }

  21. }

  23. }
复制代码
-
主要功能MCP工具列表
| 工具名称 | 功能说明 | 参数 | 备注 |
|---------|----------|------|------|
| test_connection | 测试MCP连接 | 无 | 连接状态检查 |
| smart_publish_note | 发布小红书笔记 | title, content, images, videos, tags, location | 支持智能路径解析 |
| check_task_status | 检查发布任务状态 | task_id | 查看任务进度 |
| get_task_result | 获取已完成任务的结果 | task_id | 获取最终发布结果 |
| login_xiaohongshu | 智能登录小红书 | force_relogin, quick_mode | MCP专用无交互登录 |
| get_creator_data_analysis | 获取创作者数据用于分析 | 无 | AI数据分析专用 |
AI对话式操作指南
通过与AI对话即可完成登录、发布、数据分析等操作，无需学习复杂命令。
智能登录
用户："登录小红书"

重要提示：
  • 首次使用请不要更改headless参数，获取到cookies后再更改为无头模式
  • AI调用登录工具后会拉起浏览器，首次登录需要手动输入验证码或扫码
  • 成功后会自动保存cookies到本地，下次就免登录了

内容发布
图文发布：
  1. 请发布一篇小红书笔记，标题："今日分享"，内容："..."，图片路径："/User/me/xhs/poster.png"
复制代码
视频发布：
  1. 请发布一篇小红书视频，标题："今日vlog"，内容："..."，视频路径："/User/me/xhs/video.mp4"
复制代码
数据分析：
  1. 请分析我的小红书账号数据，给出内容优化建议
复制代码

发布原理
手工上传过程中，浏览器会弹窗让用户选中文件路径，AI会将用户提供的路径参数传递给MCP工具，自动完成上传动作。
智能等待机制
  • 图片上传：快速上传，无需等待
  • 视频上传：轮询检测上传进度，等待"上传成功"标识出现
  • 超时保护：最长等待2分钟，避免MCP调用超时
  • 状态监控：DEBUG模式显示视频文件大小和时长信息
  • 高效轮询：每2秒检查一次，精确文本匹配

数据采集与AI分析功能 (v1.2.0)
自动采集小红书创作者数据，支持定时任务和AI智能分析。
AI数据分析特性
  • 中文表头: CSV文件使用中文表头，AI可直接理解数据含义
  • 智能分析: 通过 get_creator_data_analysis MCP工具获取完整数据
  • 数据驱动: AI基于真实数据提供内容优化建议
  • 趋势分析: 分析账号表现趋势和粉丝增长情况

采集的数据类型
  • 仪表板数据: 粉丝数、获赞数、浏览量等账号概览数据
  • 内容分析数据: 笔记表现数据，包括浏览量、点赞数、评论数等
  • 粉丝数据: 粉丝增长趋势、粉丝画像分析等

定时任务示例
采用cron语法，写入配置文件.env
  1. # 每6小时采集一次

  3. COLLECTION_SCHEDULE=0 */6 * * *

  5. # 工作日上午9点采集

  7. COLLECTION_SCHEDULE=0 9 * * 1-5

  9. # 每月1号凌晨2点采集

  11. COLLECTION_SCHEDULE=0 2 1 * *
复制代码




小红书apk下载
──── 3人觉得很赞 ────

使用道具 举报

davie67

举报

昨天 16:06
让我瞧瞧是啥东西！
回复 点赞
zhengdejin

举报

昨天 16:06
好强啊，mark一下学习

回复 点赞
南隐

举报

昨天 16:06
收藏了 ，虽然不发小红书，但是得有
回复 点赞
x_uy_u_n

举报

昨天 16:07
先收藏起来准没错
回复 点赞
您需要登录后才可以回帖 立即登录
高级模式

© BigSeek.Com Sitemap| Archiver | Tag | New | 苏ICP备2023012627号