xhs-search

> 小红书关键词搜索技能 — 全链路自动代理 + X-S 签名 + 搜索结果提取

依赖

• Python 3.10+
• xhshow — X-S 签名纯算库
• httpx — HTTP 客户端

pip install xhshow httpx --break-system-packages

配置

编辑 scripts/config.json：

{
  "proxy": {
    "api_url": "快代理私密代理提取API链接",
    "user": "代理用户名",
    "pass": "代理密码"
  },
  "cookies": {
    "a1": "从小红书浏览器获取",
    "web_session": "从小红书浏览器获取",
    "webId": "从小红书浏览器获取",
    "id_token": "从小红书浏览器获取（可选，登录态）"
  }
}

用法

# 基础搜索
python3 scripts/search.py --keyword "openclaw"

# 指定页数和每页数量
python3 scripts/search.py --keyword "openclaw" --pages 3 --page-size 20

# JSON 输出
python3 scripts/search.py --keyword "openclaw" --json

# 保存结果到文件
python3 scripts/search.py --keyword "openclaw" --output results.json

输出格式

{
  "keyword": "openclaw",
  "total": 35,
  "items": [
    {
      "id": "noteId",
      "title": "笔记标题",
      "author": "作者昵称",
      "likes": "点赞数",
      "collected": "收藏数",
      "comments": "评论数",
      "url": "https://www.xiaohongshu.com/explore/noteId"
    }
  ]
}

架构

提取代理IP(快代理API) → X-S签名(xhshow) → Cookie认证 → 搜索API → 解析结果

注意事项

• Cookie 有效期约 7-30 天，过期后需更新
• 私密代理按 IP 提取次数计费（约 ¥0.05/IP）
• 每次搜索消耗 1 个代理 IP
• 翻页间自动加入 2-4s 随机延迟模拟人类行为
• UA 池随机轮换，降低指纹风险