Skills
skills/tclawde/xiaohongshu-mcp-skill/xiaohongshu-mcp

xiaohongshu-mcp

SKILL.md

Xiaohongshu MCP Skill

基于 xpzouying/xiaohongshu-mcp 构建

🎯 核心功能

本 Skill 提供小红书完整自动化解决方案：

功能 状态 说明
🔐 登录管理 ✅ 已测试 支持截图发送到飞书
🔍 搜索内容 ✅ 已测试 关键词搜索、筛选
📄 获取详情 ✅ 已测试 含评论列表
📤 发布图文 ✅ 已测试 封面生成器集成
👍 点赞 ✅ 已测试 单条点赞
💬 发表评论 ✅ 已测试 主评论
↩️ 回复评论 ✅ 已测试 子评论回复
⭐ 收藏 ✅ 已测试 收藏/取消
🔄 获取推荐 ✅ 已测试 首页 feeds

共 13 个 MCP 工具全部可用！

🚀 快速开始

1. 登录

# 方式1：一键登录（推荐）
bash xhs_login.sh --notify

# 方式2：本地登录
bash xhs_login.sh

2. 启动 MCP 服务器

./xiaohongshu-mcp-darwin-arm64 &

3. 使用功能

# 检查登录状态
python3 scripts/xhs_client.py status

# 搜索内容
python3 scripts/xhs_client.py search "AI"

# 发布内容
python3 scripts/xhs_client.py publish "标题" "内容" "图片URL"

📚 完整操作指南

MCP 工具列表

工具 功能 使用场景
check_login_status 检查登录状态 确认账号状态
list_feeds 获取推荐列表 发现热门内容
search_feeds 搜索内容 关键词搜索
get_feed_detail 获取帖子详情 查看评论
publish_content 发布图文 创作新内容
publish_with_video 发布视频 视频内容
post_comment_to_feed 发表评论 回复粉丝
reply_comment_in_feed 回复评论 互动
like_feed 点赞 点赞帖子
favorite_feed 收藏 收藏帖子
delete_cookies 删除 cookies 重置登录
get_login_qrcode 获取二维码 重新登录
user_profile 获取用户主页 查看主页

💬 评论互动策略

人设保持

人设：理性思考者，不是杠精

评论区互动要求：

  • ✅ 理性分析，尊重不同意见
  • ✅ 有数据支撑的反驳
  • ✅ 自然的聊天感
  • ❌ 攻击评论者
  • ❌ 强词夺理

评论规则

评论类型 点赞 回复
观点一致 ✅ ✅ 有延续性
部分认同 ❌ ✅ 补充观点
观点相反 ❌ ✅ 尊重表达
提问 ✅ ✅ 直接回答
分享经历 ✅ ✅ 共鸣

回复模板

观点一致型：

"说出了我想说的！[补充细节]"
"对对对，尤其是[具体例子]..."

部分认同型：

"有道理，不过我觉得[补充观点]"
"同意一半吧，另外[补充视角]"

观点相反型：

"你的观点挺有意思，不过我觉得[不同看法]"
"可能我表达不清楚，我想说的是[重新解释]"

提问型：

"好问题！我的看法是[直接回答]"
"这个要分情况，[分情况说明]"

分享经历型：

"太真实了！[共鸣]"
"你这个经历太有代表性了！[延伸]"

回复要求

  1. 每条必回 - 展现活跃度
  2. 主题相关 - 扣住帖子核心
  3. 有延续性 - 不是敷衍
  4. 无 AI 感 - 自然口语化
  5. 保持人设 - 理性思考者

🔧 技术实现

MCP HTTP API

所有功能都可通过 HTTP API 调用：

# MCP Endpoint
http://localhost:18060/mcp

# 格式
curl -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_feeds",
      "arguments": {
        "keyword": "AI"
      }
    }
  }'

MCP Session 获取

# 初始化
RESPONSE=$(curl -s -i -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}')

# 提取 Session ID
SESSION_ID=$(echo "$RESPONSE" | grep -i "Mcp-Session-Id:" | cut -d' ' -f2)

示例：完整发布流程

#!/bin/bash
MCP_URL="http://localhost:18060/mcp"
COOKIE_FILE="cookies.txt"

# 1. 初始化
RESPONSE=$(curl -s -i -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -c "$COOKIE_FILE" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}')

SESSION_ID=$(echo "$RESPONSE" | grep -i "Mcp-Session-Id:" | cut -d' ' -f2)

# 2. 发送初始化通知
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}' > /dev/null

# 3. 发布内容
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "id": 100,
    "method": "tools/call",
    "params": {
      "name": "publish_content",
      "arguments": {
        "title": "AI正在毁掉这一代年轻人？",
        "content": "🔥 争议话题...\n\n详细内容...",
        "images": ["/tmp/cover.jpg"]
      }
    }
  }'

示例：评论互动

#!/bin/bash
MCP_URL="http://localhost:18060/mcp"
COOKIE_FILE="cookies.txt"
SESSION_ID="YOUR_SESSION_ID"

# 1. 获取评论列表
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_feed_detail",
      "arguments": {
        "feed_id": "698c441c000000002801d381",
        "xsec_token": "YOUR_TOKEN",
        "load_all_comments": true
      }
    }
  }'

# 2. 点赞
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "like_feed",
      "arguments": {
        "feed_id": "698c441c000000002801d381",
        "xsec_token": "YOUR_TOKEN"
      }
    }
  }'

# 3. 发表评论
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "post_comment_to_feed",
      "arguments": {
        "feed_id": "698c441c000000002801d381",
        "xsec_token": "YOUR_TOKEN",
        "content": "说出了我想说的！补充细节..."
      }
    }
  }'

# 4. 回复评论
curl -s -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "reply_comment_in_feed",
      "arguments": {
        "feed_id": "68786933000000000d01a693",
        "xsec_token": "YOUR_TOKEN",
        "comment_id": "68786afc000000001101ada6",
        "user_id": "6695e7370000000003032a17",
        "content": "说得有道理！补充观点..."
      }
    }
  }'

🛠️ 脚本工具

xhs_client.py - Python 客户端

# 检查状态
python3 scripts/xhs_client.py status

# 搜索
python3 scripts/xhs_client.py search "AI" --sort "最新" --type "图文" --time "一周内"

# 发布
python3 scripts/xhs_client.py publish "标题" "内容" "图片URL" --tags "标签1,标签2"

# 获取详情
python3 scripts/xhs_client.py detail <feed_id> <xsec_token> --comments

xhs_mcp.py - MCP 直接调用

# 列出所有工具
python3 scripts/xhs_mcp.py tools

# 发表评论
python3 scripts/xhs_mcp.py comment <feed_id> <xsec_token> "评论内容"

generate_cover.py - 封面生成器

# 生成封面
python3 generate_cover.py --title "标题" --output /tmp/cover.jpg

# 选项
--font-size 80      # 字体大小
--padding 60         # 内边距
--max-width 600      # 最大宽度

📁 文件结构

xiaohongshu-mcp-skill/
├── SKILL.md              # 本文档
├── README.md             # 中文文档
├── STRATEGY.md          # 运营策略（含评论互动）
├── install.sh            # 安装脚本
├── xhs_login.sh         # 一键登录
├── generate_cover.py     # 封面生成器
├── data/
│   ├── post_history.json   # 发布记录
│   ├── hot_topics.json    # 热点选题
│   └── cookies.json       # 登录 cookies
└── scripts/
    ├── xhs_client.py     # Python 客户端
    ├── xhs_mcp.py       # MCP 直接调用
    ├── xhs_login_sop.py  # 登录 SOP
    └── publish_smart.py   # 智能发布脚本

📊 测试记录

已测试功能 ✅

功能 状态 测试时间 备注
发布图文 ✅ 2026-02-11 2 篇已发布
搜索内容 ✅ 2026-02-11 22 条结果
获取详情 ✅ 2026-02-11 含评论列表
发表评论 ✅ 2026-02-11 6 条评论
点赞 ✅ 2026-02-11 API 成功
收藏 ✅ 2026-02-11 功能正常
回复评论 ✅ 2026-02-11 API 成功

测试帖子

  1. "美院学生都在用AI？我就笑了"

    • Feed ID: 698c441c000000002801d381
    • 点赞: 2, 评论: 6

  2. "AI正在毁掉这一代年轻人？"

    • Feed ID: 698c76f8000000001a024a93
    • 点赞: 1, 评论: 0

🔗 相关资源

📝 更新日志

v3.0 (2026-02-11)

  • ✅ 新增完整评论互动策略
  • ✅ 新增 MCP HTTP API 调用示例
  • ✅ 新增 13 个工具完整列表
  • ✅ 新增脚本工具使用说明
  • ✅ 新增技术实现细节
  • ✅ 新增测试记录

v2.0 (2026-02-11)

  • ✅ 登录修复（支持小红书页面变更）
  • ✅ 飞书通知集成
  • ✅ Python 客户端完善

v1.0 (2026-02-11)

  • ✅ 初始版本
  • ✅ 基础发布功能
  • ✅ 搜索功能

维护者: TClawDE 🦀 最后更新: 2026-02-11

Weekly Installs
146
Repository
tclawde/xiaohon…cp-skill
GitHub Stars
7
First Seen
Feb 24, 2026
Security Audits
Gen Agent Trust HubFail
SocketWarn
SnykFail
Installed on
gemini-cli145
amp145
github-copilot145
opencode145
cursor145
codex145