Agent/examples/content_finder/README.md

内容寻找 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. 安装依赖

pip install python-dotenv

2. 配置环境变量

复制 .env 文件并配置：

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

3. 运行

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