个人研究 Agent — 输入关键词,AI 驱动深度调研,结构化输出

中文 English GitHub Stars License Python React

简介

关键词 → AI 追问细化 → 深度爬取 → AI 总结归类 → Notion 式展示 → PDF/JSON 导出

截图预览

首页 — 主题列表

AI 对话 — 追问细化

结果页 — Notion 式展示

任务页 — 后台进度

配置页 — LLM + 爬取 + 微信公众号

功能特性

快速开始

环境要求

安装

git clone https://github.com/haodehaode378/TopicScout.git
cd TopicScout
# 后端
pip install -e .
playwright install chromium
# 前端
cd frontend
npm install
cd ..

配置

cp .env.example .env
# 编辑 .env,填入 LLM API Key

启动

# 终端 1:后端
python -m topic_scout serve
# 终端 2:前端
cd frontend && npm run dev

技术栈

项目结构

topic_scout/
├── __main__.py # CLI 入口
├── config.py # Dataclass 配置
├── models.py # 数据模型
├── llm.py # LLM 适配器
├── chat.py # AI 追问对话
├── wx_auth.py # 微信扫码登录(Playwright)
├── wx_api.py # 微信公众号 API 调用
├── wx_token.py # 凭证持久化
├── crawler/
│ ├── base.py # 爬虫基类
│ ├── web.py # 通用网页
│ ├── bilibili.py # B站
│ ├── douyin.py # 抖音
│ ├── weibo.py # 微博
│ ├── zhihu.py # 知乎
│ ├── xiaohongshu.py # 小红书
│ └── wechat.py # 微信公众号
├── summarizer.py # AI 总结 + 归类
├── exporter.py # JSON / PDF 导出
├── server.py # FastAPI 服务
└── db.py # SQLite CRUD
frontend/src/
├── App.tsx # 路由 + 主题切换
├── components/
│ ├── HomePage.tsx # 主题列表
│ ├── ChatPage.tsx # AI 对话
│ ├── ResultPage.tsx # Notion 式结果页
│ ├── SourceCard.tsx # 来源卡片
│ ├── TasksPage.tsx # 任务列表
│ ├── ConfigPage.tsx # 配置面板
│ └── ...
└── lib/
 ├── api.ts # API 客户端
 └── types.ts # TypeScript 类型

API 端点

LLM 配置

微信公众号集成

测试

# 后端测试
python -m pytest tests/ -v
# 前端类型检查
cd frontend && npx tsc --noEmit
# 前端构建
cd frontend && npx vite build

参考项目

贡献

License