xiaohongshu-search 0.1.0

小红书搜索工具 - 基于 TikHub API

小红书搜索工具

基于 TikHub API 的小红书笔记搜索工具。

安装

pip install xiaohongshu-search

配置

设置 TikHub API Key：

export TIKHUB_API_KEY="your_api_key"

或创建 .env 文件：

TIKHUB_API_KEY=your_api_key

使用

命令行

# 基本搜索
xhs-search "美食推荐"

# 搜索并导出 JSON
xhs-search "北京旅游" -o results.json

# 搜索并导出 Excel
xhs-search "护肤心得" --excel results.xlsx

# 自动翻页获取多页数据
xhs-search "穿搭" -n 5 -o all.json

# 按点赞数排序
xhs-search "健身" --sort popularity_descending

# 只看视频笔记
xhs-search "教程" --type 视频笔记

# 只看最近一周
xhs-search "评测" --time 一周内

# 显示详细信息
xhs-search "数码" -v

Python API

from tikhub_xiaohongshu import TikHubClient

client = TikHubClient(api_key="your_api_key")

# 单页搜索
result = client.search_notes(keyword="美食推荐", page=1)
notes = result.data["notes"]

# 自动翻页
all_notes = client.search_notes_all("美食推荐", max_pages=5)

# 获取笔记详情
note = client.get_note_info(note_id="665f95200000000006005624")

选项

选项	说明	默认值
-p, --page	页码	1
-n, --max-pages	最大页数（自动翻页）	1
-o, --output	输出 JSON 文件	-
--excel	输出 Excel 文件	-
--sort	排序方式	general
--type	笔记类型	不限
--time	时间筛选	不限
-v, --verbose	显示详细信息	false

排序方式

• general - 综合排序
• time_descending - 最新
• popularity_descending - 最多点赞
• comment_descending - 最多评论
• collect_descending - 最多收藏

笔记类型

• 不限 - 所有类型
• 视频笔记 - 仅视频
• 普通笔记 - 仅图文
• 直播笔记 - 仅直播

时间筛选

• 不限 - 所有时间
• 一天内 - 24 小时内
• 一周内 - 7 天内
• 半年内 - 6 个月内

依赖

• Python 3.12+
• tikhub-xiaohongshu >= 0.1.1
• python-dotenv >= 1.1.1

可选依赖（导出 Excel）：

• pandas >= 2.2.0
• openpyxl >= 3.0.0

许可证

MIT