内容寻找 Agent

基于 AI Agent 的抖音内容寻找工具，根据用户需求智能搜索和筛选符合目标受众的视频内容。

核心功能

智能搜索：根据用户需求解析关键词，调用抖音搜索 API
画像筛选：基于热点宝画像数据，分析内容受众特征
深度挖掘：对优质作者进行深度挖掘，获取更多相关作品
综合评估：多维度评估内容质量和受众匹配度

平台背景

载体：微信小程序
核心用户群：95% 是 50 岁以上中老年人
增长方式：微信分享裂变
核心指标：分享率、DAU

工具列表

1. douyin_search

通过关键词搜索抖音视频内容

参数：

keyword (必需): 搜索关键词
content_type: 内容类型，默认 "视频"
sort_type: 排序方式，默认 "综合排序"
publish_time: 发布时间范围，默认 "不限"
cursor: 分页游标，默认 "0"
account_id: 账号ID（可选）
timeout: 超时时间（秒），默认 60

返回：搜索结果 JSON

2. douyin_user_videos

获取抖音账号的历史作品列表

参数：

account_id (必需): 抖音账号ID
sort_type: 排序方式，默认 "最新"
cursor: 分页游标，默认 ""
timeout: 超时时间（秒），默认 60

返回：作品列表 JSON

3. get_account_fans_portrait

获取抖音账号的粉丝画像（热点宝）

参数：

account_id (必需): 抖音账号ID
need_province: 是否获取省份分布，默认 False
need_city: 是否获取城市分布，默认 False
need_city_level: 是否获取城市等级分布，默认 False
need_gender: 是否获取性别分布，默认 False
need_age: 是否获取年龄分布，默认 True
need_phone_brand: 是否获取手机品牌分布，默认 False
need_phone_price: 是否获取手机价格分布，默认 False
timeout: 超时时间（秒），默认 60

返回：粉丝画像 JSON（包含占比和偏好度）

4. get_content_fans_portrait

获取抖音内容的点赞用户画像（热点宝）

参数：

content_id (必需): 抖音内容ID
need_province: 是否获取省份分布，默认 False
need_city: 是否获取城市分布，默认 False
need_city_level: 是否获取城市等级分布，默认 False
need_gender: 是否获取性别分布，默认 False
need_age: 是否获取年龄分布，默认 True
need_phone_brand: 是否获取手机品牌分布，默认 False
need_phone_price: 是否获取手机价格分布，默认 False
timeout: 超时时间（秒），默认 60

返回：点赞用户画像 JSON（包含占比和偏好度）

Skills 策略

1. content_finding_strategy（内容寻找方法论）

教授如何系统化地寻找符合任意需求的内容：

需求拆解技巧
搜索策略制定
迭代优化方法

2. content_filtering_strategy（内容筛选方法论）

教授如何评估内容是否符合要求：

从需求中提取评估标准
多维度评估框架
分层推荐策略

快速开始

1. 安装依赖

pip install python-dotenv httpx

2. 配置环境变量

复制 .env.example 为 .env 并配置：

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

3. 配置需求

编辑 content_finder.prompt 文件的 $user$ 段，填写你的内容需求。

4. 运行

cd examples/content_finder
python run.py

使用示例

需求示例（在 content_finder.prompt 中配置）：

孩子军抗日，让人感动。找这样的视频。

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

执行流程：

Agent 解析需求，提取关键词和评估标准
使用 douyin_search 搜索相关内容
使用 get_content_fans_portrait 获取内容画像
根据年龄分布和偏好度筛选符合老年人群体的内容
对优质内容作者使用 douyin_user_videos 获取更多作品
使用 get_account_fans_portrait 验证作者粉丝画像
综合评估并推荐最合适的内容

项目结构

content_finder/
├── .env                           # 环境变量配置
├── run.py                         # 主程序入口
├── content_finder.prompt          # Prompt 配置文件
├── 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 存储
    └── agent.log                  # 日志文件

API 配置

工具调用的爬虫服务 API 地址：

抖音搜索：http://crawapi.piaoquantv.com/crawler/dou_yin/keyword
账号作品：http://crawapi.piaoquantv.com/crawler/dou_yin/blogger
账号粉丝画像：http://crawapi.piaoquantv.com/crawler/dou_yin/re_dian_bao/account_fans_portrait
内容点赞画像：http://crawapi.piaoquantv.com/crawler/dou_yin/re_dian_bao/video_like_portrait

注意事项

API 密钥：需要配置有效的 OPEN_ROUTER_API_KEY
爬虫服务：确保爬虫服务 API 可访问
超时设置：默认 60 秒，可根据网络情况调整
画像数据：默认只获取年龄分布，需要其他维度时设置对应参数为 True

License

MIT

README.md 5.8 KB Állandó hivatkozás Előzmények Nyers