Xiaohongshu Search

Extract searchable content from Xiaohongshu using one local script.

When to use this skill

• 用户要按关键词搜索小红书内容
• 用户要批量提取搜索结果中的图片链接
• 用户要导出搜索结果标题做后续选题或分析
• 用户需要一个可重复执行的本地抓取流程

Scripts overview

Setup

1. Verify Python

python --version

2. Install dependencies (first run)

pip install playwright
playwright install chromium

Critical error recovery: if a command fails with missing dependency/browser errors, install the missing dependency, then rerun the exact same command.

Usage

Basic search

python scripts/search.py "AI"

Limit extracted items

python scripts/search.py "AI" --count 30

Save output files

python scripts/search.py "AI" --count 30 --save ./output

Parameters

• keyword (required): 搜索关键词
• --count (optional): 最多提取条数，默认 20
• --save (optional): 本地输出目录

Output

Terminal output

Script prints JSON at the end:

{
  "keyword": "AI",
  "images": ["https://..."],
  "titles": ["..."],
  "count": 20
}

Files (when --save is used)

• <keyword>_links.txt: 图片链接列表
• <keyword>_titles.txt: 标题列表（有标题时写入）

Execution behavior

• 脚本会打开浏览器并访问小红书搜索页
• 如果未登录，会提示手动登录并等待
• 会自动滚动页面加载更多结果后再提取
• 仅做搜索结果层面的链接/标题采集，不抓取详情页评论线程

Limits and edge cases

• 小红书页面结构变更可能导致选择器失效，需要更新 scripts/search.py
• 登录、验证码、风控策略可能影响抓取成功率
• 不同关键词返回结构不一致，标题可能为空或数量少于图片
• 脚本使用可视化浏览器流程，不是纯无头 API 调用

Out of scope

This skill does not provide the following capabilities in current repository state:

• 发布图文/视频
• 点赞、评论、回复、收藏
• MCP server tool calls
• 登录脚本、封面生成器、智能发布脚本

Script reference

• search.py: Xiaohongshu keyword search extractor