如何为舆情分析助手设置每日定时舆情推送任务:APScheduler调度实战
如何为舆情分析助手设置每日定时舆情推送任务:APScheduler调度实战
LLM-Based-Intelligent-Public-Opinion-Analytics-Assistant(舆情分析助手)是一款结合 15 个主流平台 26 个榜单实时数据与大模型分析能力的开源项目。其中最受好评的功能之一,就是每日定时舆情推送:你只需指定一个主题和时间,系统就会在每天固定时刻自动检索热点、生成分析报告,并推送到邮箱、企业微信、Telegram 等渠道。
本文带你从配置到源码逐层拆解,看看这套推送任务是如何用 APScheduler 调度框架实现的,以及如何快速创建属于自己的每日定时舆情推送。
一、定时推送是如何实现的?
项目基于 APScheduler(版本 3.10.4,见 requirements.txt)实现任务调度,核心就三步:
- 启动后台调度器:应用启动时创建
BackgroundScheduler并立即start(),见 app.py; - 注册 cron 任务:创建推送任务时,把
HH:MM时间注册为 cron 触发器,每天同一时刻重复执行; - 任务到期自动执行:系统自动完成「检索热点 → 话题聚类 → 抓取详情页内容 → 大模型生成报告 → 多渠道推送」的完整链路。
调度核心逻辑在 PushTaskManager._schedule_push_task 中,见 app.py:
scheduler.add_job(
self._execute_push_task,
'cron',
hour=early_time.hour,
minute=early_time.minute,
args=[task_id, user_prompt],
id=task_id,
replace_existing=True
)
这里有一个巧妙的细节:实际触发时间比你设置的时间早 10 分钟。因为报告生成需要抓取新闻详情页(视频类新闻也能提取内容)并调用大模型,提前触发才能保证报告在预期时间前送达。
二、推送通道准备:配置多渠道推送参数
系统支持 4 种推送渠道,参数统一通过 .env 环境变量配置,读取逻辑见 hotsearch_analysis_agent/config/settings.py:
| 推送渠道 | 配置参数 | 说明 |
|---|---|---|
| 企业微信群机器人 | WECOM_WEBHOOK |
群聊中添加机器人获取 |
| 企业微信应用(个人微信) | WECOM_CORP_ID / WECOM_AGENT_ID / WECOM_SECRET / WECOM_USER_ID |
多用户用 | 分隔 |
| Telegram 机器人 | TELEGRAM_BOT_TOKEN / TELEGRAM_CHAT_ID |
通过 @BotFather 创建 |
| 邮箱(SMTP) | EMAIL_HOST / EMAIL_PORT / EMAIL_USER / EMAIL_PASSWORD / EMAIL_TO |
推荐新手使用,最简单 |
💡 官方建议优先配置邮箱推送:只需一个 SMTP 授权码即可,QQ 邮箱授权码在「设置 → 账户 → POP3/IMAP 服务」中生成。各渠道参数的详细获取步骤可参考 README.md。
只要配置了对应参数,报告就会自动投递到所有已配置的渠道(未配置的渠道会静默跳过),发送逻辑见 app.py。
三、三步创建每日定时推送任务
第 1 步:启动爬虫
创建推送任务前,系统要求爬虫必须先运行(否则接口直接返回 Start crawler first,见 app.py)。打开前端页面后,在右侧「爬虫控制」面板点击 启动爬虫,或通过接口:
curl -X POST http://localhost:5000/api/crawler/start
第 2 步:设置主题与时间
两种方式任选:
- 前端页面:右侧「热点定时推送」区域点击「🚀 设置热点推送」按钮,填写推送类别(如"科技新闻、财经动态"),从下拉框选择推送时间(05:00 起每 30 分钟一档,默认 09:00),界面代码见 templates/index.html;
- API 调用:
curl -X POST http://localhost:5000/api/push_tasks \
-H 'Content-Type: application/json' \
-d '{"user_prompt": "人工智能与前沿科技", "push_time": "09:00"}'
第 3 步:查看与删除任务
任务创建后会存入 MySQL 的 push_tasks 表(表结构见 init.sql),并在页面任务列表中展示。随时可以:
# 查看所有活跃任务
curl http://localhost:5000/api/push_tasks
# 删除指定任务(会同时移除调度器中的任务)
curl -X DELETE http://localhost:5000/api/push_tasks/<task_id>
四、任务执行链路:从触发到送达
当 cron 时间到达,_execute_push_task 会被调度器调用(app.py),完整链路如下:
- 语义检索:
SemanticSearchTool按主题检索最近 30 条相关内容; - 话题聚类:
TopicClusteringTool自动识别关联话题并聚类; - 内容抽取:
ContentExtractor抓取新闻详情页正文,视频类页面也能挖掘出信息; - 报告生成:大模型生成 800–1000 字的热点报告,并落盘为
hotspot_report_*.md文件; - 多渠道推送:自动分发到已配置的 Telegram、企业微信、个人微信、邮箱。
报告推送示例(节选自 README.md):
🔹 大模型上下文能力迈入新阶段:网传GPT-6提前曝光,200万超长上下文窗口引发技术社区热议…… 🔹 国产算力与大模型深度协同:DeepSeek V4确认采用华为昇腾算力底座……
五、用测试脚本一键验证推送功能
项目自带测试脚本 test_push_task.py,可以自动完成「检查服务 → 检查/启动爬虫 → 创建 2 个测试任务 → 验证任务列表 → 测试聊天接口」的全流程:
# 快速测试(会在当前时间约 11 分钟后执行推送,注意观察接收端)
python test_push_task.py
# 测试完成后清理测试任务
python test_push_task.py --cleanup
测试提示词可在 PushTaskTester.test_prompts 中修改,适合验证自己的主题词和推送渠道是否正常。
六、常见问题排查 🛠️
| 现象 | 原因与解决 |
|---|---|
创建任务返回 Start crawler first |
爬虫未启动,先通过页面或接口启动爬虫 |
| 到点没收到报告 | 任务实际提前 10 分钟触发(留给生成时间),请提前到对应时间查看日志 |
| 报告已生成但没收到推送 | 检查 .env 中对应渠道参数是否完整;企业微信个人推送需将服务器 IP 加入白名单 |
| 邮箱发送失败 | 确认使用的是 SMTP 授权码而非登录密码,端口建议 465/587 |
| 推送后数据不更新 | 推送基于爬虫实时榜单数据,确认爬虫持续运行中 |
小结
通过 APScheduler 的 cron 触发器,这个项目把「定时舆情推送」变得非常轻量的:一个 add_job 调用即可让分析助手每天按时工作。你只需要:
- ✅ 配置至少一个推送渠道(推荐邮箱)
- ✅ 保持爬虫运行以获取实时榜单数据
- ✅ 在页面或 API 中指定主题 + 时间
每天固定时刻,一份由大模型生成的热点分析报告就会自动出现在你的收件箱里。想进一步定制?可以从 app.py 中的 PushTaskManager 入手,它是整个推送调度的核心。
