这是一个 Python 3.11+ 的异步 MVP 项目骨架,包含多账号基础架构、SQLite 数据库、Playwright 浏览器状态隔离、Scrapling 页面解析、DeepSeek 分析、私信草稿生成和 APScheduler 定时任务。
本项目只采集公开页面可见字段,并默认做去重、限速和日志脱敏。私信模块生成草稿并辅助打开页面,发送动作需要人工确认;项目不包含自动群发、检测规避、指纹伪装或绕过平台限制逻辑。
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
playwright install chromium
cp .env.example .env编辑 .env,填入 DEEPSEEK_API_KEY。如果需要定时抓取关键词,可设置:
CRAWL_KEYWORDS=明星,演唱会,追星启动图形界面:
python run_gui.py也可以通过主入口启动:
python main.py gui初始化数据库:
python main.py init-db添加账号:
python main.py add-account --name account_a
python main.py add-account --name account_b人工登录并保存 Cookie:
python main.py login-account --account-id 1抓取关键词搜索结果:
python main.py crawl --account-id 1 --keyword "明星"分析用户:
python main.py analyze --account-id 1生成私信草稿:
python main.py generate-messages --account-id 1打开待处理草稿并人工确认:
python main.py assist-send --account-id 1启动定时任务:
python main.py run-scheduler查看数据概览:
python main.py summary- 每个账号在
accounts表中有独立配置。 - 每个账号拥有独立
storage_state文件,默认位于data/accounts/。 users、posts、messages都绑定account_id,同一个公开用户可被不同账号独立记录。- 默认
MAX_CONCURRENT_ACCOUNTS=1,调度器按账号轮询;后续可提高到 3-5 做账号级并发。
- 第一阶段建议在本地或单台云主机运行,优先验证 7 天稳定性。
- 使用
screen、tmux或进程管理工具保持run-scheduler常驻。 - 定期备份
data/app.db和data/accounts/。 - 若账号数量增加,再迁移到 PostgreSQL,并把调度器拆成独立 worker。
- 日志位于
logs/app.log和logs/error.log。