功能特性
- 多平台支持:TikTok、Instagram、Twitter/X、Facebook、YouTube、LinkedIn
- 智能工具选择:自动选择最优的抓取方法
- 全面分析:内容提取、论断识别、交叉核验、结论综合
- 权威来源:对照新闻网站、事实核查机构与官方来源进行验证
- 置信度评分:基于证据给出结论,并提供透明的解释
演示
点击观看 FactFlux 实际运行演示
先决条件
- Python 3.8+
- 有效的 API Key:
- Google Gemini
- Bright Data
安装
- 克隆仓库
git clone https://github.com/MeirKaD/FactFlux.git cd FactFlux - 创建虚拟环境
python -m venv venv source venv/bin/activate # On Windows: venvScriptsactivate - 安装依赖
pip install -r requirements.txt - 配置环境变量
cp .env.example .env # Edit .env with your API keys
配置
创建一个包含 API Key 的 .env 文件:
GOOGLE_API_KEY=your_google_gemini_api_key_here
BRIGHT_DATA_API_KEY=your_bright_data_api_key_here
使用方法
Playground 模式(推荐)
python playground_fact_check.py
架构
智能体团队结构
- 内容提取智能体(Content Extractor Agent)
- 使用最优的 Bright Data 工具提取帖子数据
- 自动处理多平台
- 论断识别智能体(Claim Identifier Agent)
- 识别可验证的事实性论断
- 区分事实与观点/讽刺内容
- 交叉核验智能体(Cross-Reference Agent)
- 对照权威来源验证论断
- 执行反向媒体搜索
- 结论智能体(Verdict Agent)
- 综合证据并给出最终结论
- 提供置信度评分与推理依据
工作流程
URL Input Content Extraction Claim Identification Cross-Reference Final Verdict
技术栈
- Agno
- Gemini
支持的平台
- TikTok
- Twitter/X
- YouTube
错误处理
系统包含全面的错误处理,覆盖:
- 无效 URL
- 网络故障
- API 速率限制
- 格式异常的社交媒体帖子
- 内容缺失
参与贡献
- Fork 本仓库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交改动(
git commit -m 'Add amazing feature') - 推送到分支(
git push origin feature/amazing-feature) - 发起 Pull Request
许可证
本项目使用 MIT License 许可——详情请参阅 LICENSE 文件。
支持
- 查看日志以获取详细错误信息
- 确保所有 API Key 有效且有足够额度
- 确认社交媒体 URL 可公开访问
- 核对支持的平台列表
更新
- 检查 Agno 框架更新:
pip install -U agno - 关注 Bright Data API 变更
- 在配置中保持模型版本为最新
注意:本系统用于教育与研究目的。请始终遵守各平台服务条款与速率限制。
