Metadata-Version: 2.4
Name: xiaohongshu-search
Version: 0.1.0
Summary: 小红书搜索工具 - 基于 TikHub API
Project-URL: Homepage, https://coding.jd.com/u_py/xiaohongshu_search
Project-URL: Repository, https://coding.jd.com/u_py/xiaohongshu_search.git
Author: 叶浩
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Requires-Dist: python-dotenv>=1.1.1
Requires-Dist: tikhub-xiaohongshu>=0.1.1
Description-Content-Type: text/markdown

# 小红书搜索工具

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

## 安装

```bash
pip install xiaohongshu-search
```

## 配置

设置 TikHub API Key：

```bash
export TIKHUB_API_KEY="your_api_key"
```

或创建 `.env` 文件：

```
TIKHUB_API_KEY=your_api_key
```

## 使用

### 命令行

```bash
# 基本搜索
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

```python
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
