xhs-crawler-xie（xhs 爬虫谢）

小红书爬虫 Skill

功能描述

基于Python的小红书关键词爬取工具，支持搜索和抓取小红书笔记内容，自动推送到飞书群。

核心特性

• ✅ 浏览器模拟搜索 - 绕过API限制，搜索成功率更高
• ✅ Cookie自动管理 - 过期自动触发二维码登录
• ✅ 飞书集成 - 结果自动以卡片形式推送到飞书群
• ✅ 指令识别 - 支持 run-xhs:关键词 格式指令

命令列表

run-xhs

执行小红书关键词爬取

语法： run-xhs <关键词>

示例：

• run-xhs 新燕宝2025 - 搜索"新燕宝2025"相关笔记
• run-xhs 中间带新燕宝 - 搜索"中间带新燕宝"相关笔记

说明：

• 默认返回5条笔记
• 搜索时间约10-30秒
• 结果自动发送到飞书群

xhs-help

显示帮助信息

示例： xhs-help

环境要求

Python环境

• Python 3.8+
• 依赖包：

  pip install playwright requests
  playwright install chromium

配置文件

在 config.py 中配置以下参数：

# 飞书应用凭证（必填）
FEISHU_APP_ID = "cli_a924d921ce7a9cbd"
FEISHU_APP_SECRET = "5QG92Lp8kvhAkgpPJTd57fIxshnCebEt"

# 群聊ID（在example_openclaw_skill.py中配置）
FEISHU_CHAT_ID = "oc_29fbba0871ab7371a4c1a1ebe0350dac"

OpenClaw配置

方式1：通过配置文件添加（推荐）

在 OpenClaw 的 config/default.json 中添加：

{
    "skills": [
        {
            "name": "xhs-crawler",
            "type": "local",
            "path": "D:\\pycharm\\projects\\小红书关键词爬取\\openclaw封装skill",
            "config": {
                "pythonEnv": "python"
            }
        }
    ]
}

注意：path 应该指向 Skill 文件夹，而不是 index.js 文件。

方式2：通过 OpenClaw 命令行安装

# 在 OpenClaw 目录下执行
openclaw skill install D:\pycharm\projects\小红书关键词爬取\openclaw封装skill

工作流程

用户飞书输入: run-xhs 新燕宝2025
    ↓
OpenClaw 接收指令
    ↓
调用 example_openclaw_skill.py "run-xhs：新燕宝2025"
    ↓
解析指令 → 提取关键词
    ↓
检查Cookie有效性
    ↓
├── Cookie有效 → 继续搜索
└── Cookie失效 → 自动二维码登录
        ↓
    截图发送到飞书群
        ↓
    用户手机扫码登录
        ↓
    自动保存Cookie
        ↓
浏览器搜索小红书
    ↓
提取笔记信息（标题、链接、作者、点赞数）
    ↓
发送结果卡片到飞书群

文件结构

openclaw封装skill/
├── index.js                      # OpenClaw Skill入口
├── package.json                  # Node.js项目配置
├── example_openclaw_skill.py     # Python主程序
├── config.py                     # 配置文件
├── feishu_app_bot.py            # 飞书应用机器人
├── cookie_manager.py            # Cookie管理
├── auto_login_with_qrcode.py    # 自动二维码登录
├── xhs_search_with_browser.py   # 浏览器搜索
└── SKILL.md                     # 本文档

使用示例

1. 命令行测试

cd "D:\pycharm\projects\小红书关键词爬取\openclaw封装skill"
python example_openclaw_skill.py "run-xhs：新燕宝2025"

2. OpenClaw集成后飞书使用

run-xhs 新燕宝2025

飞书群将收到：

📱 小红书搜索报告

关键词: 新燕宝2025
共找到: 5 条笔记
时间: 2026-03-18 11:09

1. 0岁宝宝疫苗儿保一站式搞定...
   熙熙妈宝藏分享 | 👍 187
   [查看笔记]

2. 新燕宝·开年福利降免赔额...
   中间带新燕宝 | 👍 20
   [查看笔记]

...

注意事项

1. 首次使用：需要先运行 python login.py 手动登录一次，保存Cookie
2. Cookie过期：程序会自动检测并发送二维码到飞书群，扫码后即可继续
3. IP风控：如遇"IP存在风险"错误，请切换网络或等待2-4小时
4. 搜索频率：已设置防风控机制，请求间隔2-5秒

故障排查

更新日志