rockingland-trader-monitor

Xiaohongshu (RedNote) user post keyword monitoring and WeChat notification. Use when the user needs to (1) monitor a specific Xiaohongshu user's latest posts for keywords in titles, (2) get notified via WeChat when target keywords appear in new posts, (3) set up automated periodic checks for a Xiaohongshu trader/seller's updates, or (4) configure keyword-based alerts for Xiaohongshu content. Triggers on phrases like "小红书监测", "远行商人", "帖子监控", "关键词提醒", "xiaohongshu monitor".

Audits

Pass

Install

openclaw skills install rockingland-trader-monitor

Xiaohongshu Trader Monitor

监测指定小红书用户的最新帖子,标题含关键词时自动推送到微信。

⚠️ 使用前配置(必须)

本 skill 需要你填入自己的认证信息才能运行。打开 scripts/xhs_trader_monitor.py,修改用户配置区(文件顶部):

1. 微信推送目标 ID

获取你的 openclaw-weixin 用户 ID:

openclaw message list-accounts --channel openclaw-weixin

TARGET_ID 替换为你的 ID,格式为 xxx@im.wechat

2. 小红书目标用户信息

USER_ID:目标用户主页 URL 中的 ID

  • 格式:https://www.xiaohongshu.com/user/profile/USER_ID
  • 从分享链接或搜索结果中获取

USER_XSEC:xsec_token(认证令牌)

  • 从目标用户任意帖子的 feed 数据中提取 xsecToken
  • 或运行 mcp-call.sh user_profile 后从返回数据中获取

3. 监测关键词

KEYWORDS 列表中配置你要监测的关键词:

KEYWORDS = ["棱镜球", "炫彩蛋", "同乘蛋", "祝福项坠"]

4. Cookies 登录

将已登录小红书的浏览器 cookies 导出为 JSON 数组,保存到 cookies.json

[
  {"name": "a1", "value": "...", "domain": ".xiaohongshu.com", "path": "/"},
  {"name": "web_session", "value": "...", "domain": ".xiaohongshu.com", "path": "/"}

放置路径(按优先级):

  1. ~/cookies.json
  2. ~/.xiaohongshu/cookies.json
  3. 环境变量 XHS_COOKIES_SRC 指定的路径

⚠️ 首次登录可通过 mcp-call.sh get_login_qrcode 获取二维码扫码登录,但当前环境多被风控,推荐直接导出 cookies。

Quick Start

安装依赖

# 1. 安装 xiaohongshu-mcp 二进制
# 从 GitHub Releases 下载对应平台文件:
# https://github.com/xpzouying/xiaohongshu-mcp/releases
mkdir -p ~/.local/bin
mv xiaohongshu-mcp-linux-amd64 ~/.local/bin/xiaohongshu-mcp
mv xiaohongshu-login-linux-amd64 ~/.local/bin/xiaohongshu-login
chmod +x ~/.local/bin/xiaohongshu-*

# 2. 安装系统依赖
apt-get install -y jq xvfb

# 3. 检查依赖
./scripts/install-check.sh

配置并运行

  1. 编辑 scripts/xhs_trader_monitor.py 填入你的配置
  2. 运行监测:
cd scripts/
python3 xhs_trader_monitor.py

配置定时任务

5 8,12,16,20 * * * /usr/bin/python3 /path/to/xiaohongshu-trader-monitor/scripts/xhs_trader_monitor.py >> /path/to/logs/xhs_trader.log 2>&1

How It Works

  1. 启动 MCP:自动启动 xiaohongshu-mcp 服务(含 Xvfb 虚拟显示)
  2. 获取帖子:调用 user_profile 获取目标用户主页最新帖子
  3. 关键词匹配:检查最近 5 条帖子标题是否含配置的关键词
  4. 日期过滤:只检查今天发布的帖子(MM.DD 前缀匹配)
  5. 去重推送:已通知过的帖子 ID 不会重复推送
  6. 微信通知:命中关键词时推送消息到微信
  7. 关闭 MCP:监测完成后自动关闭服务

Resources

scripts/

  • xhs_trader_monitor.py — 核心监测脚本(需配置用户信息)
  • start-mcp.sh — 启动 MCP 服务(自动管理 Xvfb)
  • stop-mcp.sh — 停止 MCP 服务
  • mcp-call.sh — 通用 MCP 调用脚本
  • install-check.sh — 依赖检查

references/

  • trader_rules.md — 完整配置指南、故障排查、消息模板

Files

FilePurpose
scripts/xhs_trader_monitor.pyCore monitoring script (requires user config)
scripts/start-mcp.shStart MCP service with Xvfb
scripts/stop-mcp.shStop MCP service
scripts/mcp-call.shGeneric MCP tool caller
scripts/install-check.shDependency checker
references/trader_rules.mdConfiguration guide and troubleshooting
cookies.jsonLogin cookies (user-provided, not included)
xhs_trader_state.jsonNotification state (auto-generated)