warkinger 发表于 2025-6-23 15:59:44

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

GitHub - aki66938/xhs-toolkit: 📕 小红书MCP工具包 - 支持与AI客户端集成的智能内容创作和发布工具-一个强大的小红书自动化工具包,支持通过MCP协议与AI客户端(如Claude Desktop等)集成,实现与AI对话即可进行内容创作、发布及创作者数据分析。https://linux.do/images/emoji/twemoji/sparkles.png?v=14 主要特性
[*]https://linux.do/images/emoji/twemoji/cookie.png?v=14 Cookie管理: 安全获取、验证和管理小红书登录凭证
[*]https://linux.do/images/emoji/twemoji/robot.png?v=14 MCP协议支持: 与CherryStudio等AI客户端无缝集成
[*]https://linux.do/images/emoji/twemoji/memo.png?v=14 自动发布: 支持图文和视频笔记的自动化发布
[*]https://linux.do/images/emoji/twemoji/alarm_clock.png?v=14 定时任务: 支持cron表达式的定时数据采集
[*]https://linux.do/images/emoji/twemoji/bar_chart.png?v=14 数据采集: 自动采集创作者中心仪表板、内容分析、粉丝数据
[*]https://linux.do/images/emoji/twemoji/brain.png?v=14 AI数据分析: 中文表头数据,AI可直接理解和分析
[*]https://linux.do/images/emoji/twemoji/floppy_disk.png?v=14 数据存储: 支持csv本地存储(sql目前保留,暂不开发)
[*]https://linux.do/images/emoji/twemoji/bullseye.png?v=14 统一接口: 一个工具解决llm操作小红书自动化需求
https://linux.do/images/emoji/twemoji/clipboard.png?v=14 功能清单登录
[*] 登录 - 支持传统的命令行登录和通过与AI对话完成登录
内容发布
[*] 图文发布 - 支持发布图文笔记
[*] 视频发布 - 支持发布视频笔记
[*] 内容搜索 - 支持指定搜索(开发计划中)
数据采集
[*] 仪表板数据 - 采集账号概览数据(粉丝数、获赞数等)
[*] 内容分析数据 - 采集笔记表现数据(浏览量、点赞数等)
[*] 粉丝数据 - 采集粉丝增长和分析数据
[*] 定时采集 - 支持cron表达式的自动定时采集
[*] 数据存储 - CSV本地存储(默认)
https://linux.do/images/emoji/twemoji/clipboard.png?v=14 环境要求https://linux.do/images/emoji/twemoji/globe_with_meridians.png?v=14 浏览器环境
[*]Google Chrome 浏览器 (最新版本推荐)
[*]ChromeDriver (版本必须与Chrome版本完全匹配)
https://linux.do/images/emoji/twemoji/magnifying_glass_tilted_left.png?v=14 查看Chrome版本在Chrome浏览器中访问:chrome://version/https://linux.do/images/emoji/twemoji/inbox_tray.png?v=14 ChromeDriver安装方式方法一:自动下载(推荐)# 使用webdriver-manager自动管理

pip install webdriver-manager
方法二:手动下载
[*]https://linux.do/images/emoji/twemoji/clipboard.png?v=14 访问官方下载页面:Chrome for Testing
[*]https://linux.do/images/emoji/twemoji/bullseye.png?v=14 选择与您Chrome版本完全匹配的ChromeDriver
[*]https://linux.do/images/emoji/twemoji/file_folder.png?v=14 下载后解压到合适位置(如 /usr/local/bin/ 或 C:\tools\)
[*]https://linux.do/images/emoji/twemoji/gear.png?v=14 在 .env 文件中配置正确路径
方法三:包管理器安装# macOS (Homebrew)

brew install --cask chromedriver

# Windows (Chocolatey)

choco install chromedriver

# Linux (Ubuntu/Debian)

sudo apt-get install chromium-chromedriverhttps://linux.do/images/emoji/twemoji/warning.png?v=14 重要提示:版本不匹配是最常见的问题原因,请确保ChromeDriver版本与Chrome浏览器版本完全一致!
https://linux.do/images/emoji/twemoji/rocket.png?v=14 快速开始一键安装(推荐)# 下载并运行安装脚本

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

# 或者手动运行

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

cd xhs-toolkit

bash install.shhttps://linux.do/images/emoji/twemoji/hammer_and_wrench.png?v=14 从源码运行方法一:uv (推荐 https://linux.do/images/emoji/twemoji/high_voltage.png?v=14)# 克隆项目

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

cd xhs-toolkit

# 使用uv安装依赖并运行

uv sync

uv run python xhs_toolkit.py status ## 验证工具是否可用https://linux.do/images/emoji/twemoji/light_bulb.png?v=14 uv使用提示:文档中所有 python 命令都可以用 uv run python 替代,享受更快的依赖管理体验!
方法二:pip (传统方式)# 克隆项目

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

cd xhs-toolkit

# 创建虚拟环境(推荐)

python -m venv venv

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

# 安装依赖

pip install -r requirements.txt

python xhs_toolkit.py status ## 验证工具是否可用https://linux.do/images/emoji/twemoji/hammer_and_wrench.png?v=14 使用指南1. 创建配置文件复制并编辑配置文件:cp env_example .env

vim .env # 编辑配置必需配置:# Chrome浏览器路径

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

# ChromeDriver路径

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

3. 启动MCP服务器python xhs_toolkit.py server start
4. 客户端配置Claude Desktop在 ~/.claude_desktop_config.json 中添加:{

"mcpServers": {

"xiaohongshu": {

"command": "curl",

"args": [

"-N",

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

"http://localhost:8000/sse"

]

}

}

}-https://linux.do/images/emoji/twemoji/wrench.png?v=14 主要功能MCP工具列表| 工具名称 | 功能说明 | 参数 | 备注 ||---------|----------|------|------|| test_connection | 测试MCP连接 | 无 | 连接状态检查 || smart_publish_note | 发布小红书笔记 https://linux.do/images/emoji/twemoji/high_voltage.png?v=14 | 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数据分析专用 |https://linux.do/images/emoji/twemoji/speech_balloon.png?v=14 AI对话式操作指南通过与AI对话即可完成登录、发布、数据分析等操作,无需学习复杂命令。https://linux.do/images/emoji/twemoji/locked_with_key.png?v=14 智能登录用户:"登录小红书"
重要提示:
[*]https://linux.do/images/emoji/twemoji/police_car_light.png?v=14 首次使用请不要更改headless参数,获取到cookies后再更改为无头模式

[*]https://linux.do/images/emoji/twemoji/globe_with_meridians.png?v=14 AI调用登录工具后会拉起浏览器,首次登录需要手动输入验证码或扫码

[*]https://linux.do/images/emoji/twemoji/cookie.png?v=14 成功后会自动保存cookies到本地,下次就免登录了

https://linux.do/images/emoji/twemoji/memo.png?v=14 内容发布图文发布:请发布一篇小红书笔记,标题:"今日分享",内容:"...",图片路径:"/User/me/xhs/poster.png"视频发布:请发布一篇小红书视频,标题:"今日vlog",内容:"...",视频路径:"/User/me/xhs/video.mp4"https://linux.do/images/emoji/twemoji/bar_chart.png?v=14 数据分析:请分析我的小红书账号数据,给出内容优化建议
https://linux.do/images/emoji/twemoji/wrench.png?v=14 发布原理手工上传过程中,浏览器会弹窗让用户选中文件路径,AI会将用户提供的路径参数传递给MCP工具,自动完成上传动作。https://linux.do/images/emoji/twemoji/high_voltage.png?v=14 智能等待机制
[*]https://linux.do/images/emoji/twemoji/camera.png?v=14 图片上传:快速上传,无需等待

[*]https://linux.do/images/emoji/twemoji/clapper_board.png?v=14 视频上传:轮询检测上传进度,等待"上传成功"标识出现

[*]https://linux.do/images/emoji/twemoji/stopwatch.png?v=14 超时保护:最长等待2分钟,避免MCP调用超时

[*]https://linux.do/images/emoji/twemoji/bar_chart.png?v=14 状态监控:DEBUG模式显示视频文件大小和时长信息

[*]https://linux.do/images/emoji/twemoji/counterclockwise_arrows_button.png?v=14 高效轮询:每2秒检查一次,精确文本匹配

https://linux.do/images/emoji/twemoji/bar_chart.png?v=14 数据采集与AI分析功能 https://linux.do/images/emoji/twemoji/new_button.png?v=14(v1.2.0)自动采集小红书创作者数据,支持定时任务和AI智能分析。https://linux.do/images/emoji/twemoji/brain.png?v=14 AI数据分析特性
[*]中文表头: CSV文件使用中文表头,AI可直接理解数据含义

[*]智能分析: 通过 get_creator_data_analysis MCP工具获取完整数据

[*]数据驱动: AI基于真实数据提供内容优化建议

[*]趋势分析: 分析账号表现趋势和粉丝增长情况

采集的数据类型
[*]仪表板数据: 粉丝数、获赞数、浏览量等账号概览数据

[*]内容分析数据: 笔记表现数据,包括浏览量、点赞数、评论数等

[*]粉丝数据: 粉丝增长趋势、粉丝画像分析等

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

COLLECTION_SCHEDULE=0 */6 * * *

# 工作日上午9点采集

COLLECTION_SCHEDULE=0 9 * * 1-5

# 每月1号凌晨2点采集

COLLECTION_SCHEDULE=0 2 1 * *



davie67 发表于 2025-6-23 16:06:11

让我瞧瞧是啥东西!https://linux.do/images/emoji/twemoji/eyes.png?v=14

zhengdejin 发表于 2025-6-23 16:06:25

好强啊,mark一下学习

南隐 发表于 2025-6-23 16:06:33

收藏了 ,虽然不发小红书,但是得有

x_uy_u_n 发表于 2025-6-23 16:07:14

先收藏起来准没错

hslxwu 发表于 2025-6-24 19:00:02

这工具看着挺厉害

xingke 发表于 2025-7-18 09:00:02

这工具挺牛啊!
页: [1]
查看完整版本: 小红书创作者MCP工具包-v1.2.2更新