# 内容寻找 Agent - MVP 版本

## 项目简介

这是一个基于 AI Agent 的抖音内容寻找工具，能够根据用户需求智能搜索和筛选符合目标受众（主要是老年人群体）的视频内容。

## 核心功能

1. **智能搜索**：根据用户需求解析关键词，搜索抖音视频内容
2. **画像筛选**：基于热点宝画像数据，筛选符合老年人群体的内容
3. **深度挖掘**：对优质作者进行深度挖掘，获取更多相关作品
4. **综合评估**：多维度评估内容质量和受众匹配度

## 工具列表

### 1. douyin_search
通过关键词搜索抖音视频内容
- 支持关键词搜索
- 支持播放量、点赞数筛选
- 返回视频列表及基础数据

### 2. douyin_user_videos
获取抖音用户的作品列表
- 根据用户ID获取作品
- 用于深度挖掘优质作者

### 3. get_video_audience_profile
获取视频的点赞观众画像
- 年龄分布（占比&偏好度）
- 性别分布（占比&偏好度）
- 城市等级分布（占比&偏好度）
- 地域分布（占比&偏好度）

### 4. get_user_fans_profile
获取用户的粉丝画像
- 粉丝年龄分布（占比&偏好度）
- 粉丝性别分布（占比&偏好度）
- 粉丝城市等级分布（占比&偏好度）
- 粉丝地域分布（占比&偏好度）

## Skills 策略

### 1. content_finding_strategy（内容寻找策略）
- 需求解析：提取关键词和目标受众特征
- 初步搜索：使用关键词搜索内容
- 内容筛选：基于热度指标筛选
- 深度挖掘：获取优质作者的其他作品
- 画像验证：验证是否符合目标受众

### 2. content_filtering_strategy（内容筛选策略）
- 热度指标筛选：播放量、点赞量、分享量
- 互动率筛选：点赞率、分享率、评论率
- 观众画像筛选：年龄分布、偏好度、城市等级
- 粉丝画像筛选：粉丝量、粉丝年龄分布
- 综合评分机制

## 快速开始

### 1. 安装依赖

```bash
pip install python-dotenv
```

### 2. 配置环境变量

复制 `.env` 文件并配置：

```bash
OPEN_ROUTER_API_KEY=your_api_key_here
MODEL=anthropic/claude-sonnet-4.5
TEMPERATURE=0.3
MAX_ITERATIONS=30
```

### 3. 运行

```bash
cd examples/content_finder
python run.py
```

## 使用示例

**用户需求**：
```
孩子军抗日，让人感动。找这样的视频。

要求：
- 内容要感人，有情感共鸣
- 适合老年人观看
- 热度要高，质量要好
```

**执行流程**：
1. Agent 解析需求，提取关键词："孩子军抗日"、"感人"
2. 使用 `douyin_search` 搜索相关内容
3. 使用 `get_video_audience_profile` 获取观众画像
4. 筛选符合老年人群体的内容（41岁以上占比高、偏好度高）
5. 对优质内容作者使用 `douyin_user_videos` 获取更多作品
6. 使用 `get_user_fans_profile` 验证作者粉丝画像
7. 综合评估并推荐最合适的内容

## 项目结构

```
content_finder/
├── .env                    # 环境变量配置
├── run.py                  # 主程序入口
├── README.md              # 项目文档
├── tools/                 # 工具包
│   ├── __init__.py
│   ├── douyin_search.py          # 抖音搜索
│   ├── douyin_user_videos.py     # 用户作品列表
│   └── hotspot_profile.py        # 热点宝画像数据
├── skills/                # Skills 策略
│   ├── content_finding_strategy.md    # 内容寻找策略
│   └── content_filtering_strategy.md  # 内容筛选策略
└── .cache/                # 缓存目录
    ├── traces/            # Trace 存储
    ├── output/            # 输出文件
    └── agent.log          # 日志文件
```

## 筛选标准

### 热度指标
- 播放量：≥ 50,000
- 点赞量：≥ 2,000
- 分享量：≥ 500

### 互动率
- 点赞率：≥ 3%
- 分享率：≥ 1%
- 评论率：≥ 0.5%

### 老年人群体画像
- 41岁以上占比：≥ 35%
- 41-50岁偏好度：≥ 1.1
- 51-60岁偏好度：≥ 1.2
- 60岁以上偏好度：≥ 1.3

## 注意事项

1. **API 密钥**：需要配置有效的 OPEN_ROUTER_API_KEY
2. **模拟数据**：当前版本使用模拟数据，实际使用需要对接真实的抖音API和热点宝API
3. **筛选条件**：可根据实际需求调整筛选标准
4. **画像数据**：画像数据仅作为参考，需结合多个维度综合判断

## 后续优化

- [ ] 对接真实的抖音API
- [ ] 对接真实的热点宝API
- [ ] 增加更多筛选维度
- [ ] 优化评分算法
- [ ] 增加结果导出功能
- [ ] 增加批量处理功能
- [ ] 增加可视化界面

## License

MIT