# 搜索脚本文档

本目录包含各平台的搜索、推荐词和标签词获取脚本。

## 目录

- [获取工具列表](#获取工具列表-)
- [搜索脚本](#搜索脚本)
  - [通用搜索（Google、Baidu、Bing）](#1-通用搜索googlebaidubing-)
  - [抖音内容搜索](#2-抖音内容搜索-)
  - [小红书笔记搜索](#3-小红书笔记搜索-)
  - [AI搜索](#4-ai搜索-)
- [推荐词脚本](#推荐词脚本-)
- [标签词脚本](#标签词脚本)
  - [抖音标签词](#抖音标签词-)
  - [小红书标签词](#小红书标签词-)

---

## 获取工具列表 ✅

```bash
python script/get_tools_list.py
```

**输出：**`data/tools_list/tools_list_{时间戳}.json`

---

## 搜索脚本

### 1. 通用搜索（Google、Baidu、Bing） ✅

```bash
# 使用默认平台Google搜索
python script/search/custom_search.py --keyword "python"

# 指定其他搜索平台
python script/search/custom_search.py --keyword "python" --platform "baidu"
```

**参数：**
- `--keyword`: 搜索关键词（必填）
- `--platform`: 搜索平台，可选值：google/baidu/bing（可选，默认google）
- `--results-dir`: 结果保存目录（可选，默认 data/search）

**输出：**`data/search/custom_search/{平台}/{关键词}/{时间戳}.json`

### 2. 抖音内容搜索 ✅

```bash
python script/search/douyin_search.py --keyword "美食"
```

**参数：**
- `--keyword`: 搜索关键词（必填）
- `--results-dir`: 结果保存目录（可选，默认 data/search）

**输出：**`data/search/douyin_search/{关键词}/{时间戳}.json`

### 3. 小红书笔记搜索 ✅

```bash
python script/search/xiaohongshu_search.py --keyword "旅游"
```

**参数：**
- `--keyword`: 搜索关键词（必填）
- `--content-type`: 内容类型，可选值：不限/视频/图文（可选，默认"不限"）
- `--sort-type`: 排序方式，可选值：综合/最新/最多点赞/最多评论（可选，默认"综合"）
- `--publish-time`: 发布时间，可选值：不限/一天内/一周内/半年内（可选，默认"不限"）
- `--cursor`: 翻页游标（可选，默认为空）
- `--page`: 页码标识（可选，默认1）
- `--results-dir`: 结果保存目录（可选，默认 data/search）

**输出：**`data/search/xiaohongshu_search/{关键词}/{时间戳}_page{页码}.json`

### 4. AI搜索 ✅

```bash
python script/search/ai_search.py --query "什么是Python"
```

**参数：**
- `--query`: 查询内容（必填）
- `--results-dir`: 结果保存目录（可选，默认 data/search）

**输出：**`data/search/ai_search/{查询内容前20字符}/{时间戳}.json`

---

## 推荐词脚本 ✅

```bash
# 抖音推荐词
python script/search_recommendations/douyin_search_recommendations.py --keyword "美食"

# B站推荐词
python script/search_recommendations/bilibili_search_recommendations.py --keyword "游戏"

# 小红书推荐词
python script/search_recommendations/xiaohongshu_search_recommendations.py --keyword "长沙"
```

**参数：**
- `--keyword`: 搜索关键词（必填）
- `--results-dir`: 结果保存目录（可选，默认 data/search_recommendations）

**输出：**`data/search_recommendations/{平台}/{关键词}/{时间戳}.json`

---

## 标签词脚本

### 抖音标签词 ✅

```bash
python script/search_tagwords/douyin_search_tagword.py --keyword "旅游"
```

**参数：**
- `--keyword`: 搜索关键词（必填）
- `--results-dir`: 结果保存目录（可选，默认 data/search_tagwords）

**输出：**`data/search_tagwords/douyin/{关键词}/tagword_{时间戳}.json`

### 小红书标签词 ❌

```bash
python script/search_tagwords/xiaohongshu_search_hashtag.py --keyword "护肤"
```

**参数：**
- `--keyword`: 搜索关键词（必填）
- `--results-dir`: 结果保存目录（可选，默认 data/search_tagwords）

**输出：**`data/search_tagwords/xiaohongshu/{关键词}/hashtag_{时间戳}.json`

> ❌ **不可用：** 该接口当前返回500错误，服务端暂时不可用
