功能说明: 本技能涵盖 自动化配置和灵活的参数设置、时使用、化配置和灵活的参数设置 等核心能力。
功能说明: 本技能涵盖 化工作流场景 等核心能力。
Email Daily Summary
通过 browser-use CLI 驱动浏览器自动化登录 Web 邮箱,抓取当日邮件并生成结构化日报。优先复用本机 Chrome 已登录会话(--browser real),避免在脚本中存储明文密码.
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | Email Daily Summary处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
专业版增强能力
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Email Daily Summary自动登录邮箱并生成 | 不支持 | 支持 |
| 多标签页并行抓取 | 不支持 | 支持 |
| 反爬虫策略自动规避 | 不支持 | 支持 |
| 页面结构变化自适应 | 不支持 | 支持 |
| 批量导出结构化数据 | 不支持 | 支持 |
安装与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
需要配置对应API Key,详见上文环境配置章节
可用性分类
- 分类: MD+EXEC()
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
功能能力
- 多邮箱自动登录:复用 Chrome 已登录会话(
--browser real)或--headed手动登录,覆盖 Gmail、Outlook、QQ 邮箱、163/126 邮箱、企业微信邮箱 - 邮件列表抓取:通过 DOM 选择器提取收件箱行(
tr.zA等),获取发件人、主题、摘要片段、时间戳四元组 - 统计聚合:实时计算未读数(
.zE)、可见总数、按发件人域名/主题关键词分类 - AI 智能摘要:
browser-use extract用自然语言指令提取前 N 封邮件并按重要性排序 - 截图归档:每日 inbox 快照保存为 PNG,按日期归档到本地目录
- 定时调度:提供 crontab(Linux/macOS)与 launchd(macOS)两种调度模板,每日定时触发
- 跨账号汇总:顺序遍历多个邮箱 URL,合并生成统一的跨账号日报
- 关键词监控:命中白名单发件人或主题关键词时,在日报中高亮并加入"建议操作"区块
前置依赖
- 安装 browser-use CLI:
uv pip install browser-use[cli]
browser-use install
- 在本机 Chrome 中至少登录过一次目标邮箱(用于
--browser real复用会话) - 操作系统:Windows / macOS / Linux 均可,定时任务依赖 crontab 或 launchd
支持的邮箱服务
使用指南
- 确认
browser-use --version可正常输出,否则按前置依赖安装 - 选择登录方式:已登录 Chrome 用
--browser real,首次登录用--headed - 打开收件箱 URL,
browser-use state探测当前 DOM 结构 - 执行
eval脚本提取邮件四元组,或extract让 AI 自然语言提取 - 聚合统计、生成 Markdown 日报,
screenshot归档快照 browser-use close释放浏览器会话
适用范围
场景 1:每日晨间邮件简报
- 输入:Gmail 收件箱 URL + 当日日期(如
2026-07-20) - 输出:Markdown 日报,含未读数、Top 5 重要邮件、分类统计、建议操作;附
inbox_2026-07-20.png截图 - 触发:
crontab每日 09:00 自动执行
场景 2:多账号跨邮箱汇总
- 输入:多个邮箱配置(Gmail + QQ 邮箱 + 企业微信邮箱)
- 输出:合并日报,按邮箱分节展示,统一统计未读总数与重要邮件清单
- 触发:用户主动请求或每日定时
场景 3:重要发件人监控告警
- 输入:发件人白名单(如
boss@company.com、finance@bank.com) - 输出:命中邮件列表,含主题、时间、摘要片段;若命中则在日报顶部加红标记
- 触发:每小时轮询或事件驱动
场景 4:周报邮件统计
- 输入:周起止日期(如
2026-07-14至2026-07-20) - 输出:周邮件量趋势、Top 10 发件人、分类占比、未处理邮件清单
- 触发:每周一 09:00 自动执行
案例展示
案例 1:生成今日 Gmail 日报
DATE=$(date +%Y-%m-%d)
OUTPUT_DIR="./email_summaries"
mkdir -p "$OUTPUT_DIR"
# ...
browser-use --browser real open https://mail.google.com
sleep 3
# ...
# 探测页面状态
browser-use state
# ...
# 截图归档
browser-use screenshot "$OUTPUT_DIR/inbox_$DATE.png"
# ...
# 提取前 20 封邮件四元组
browser-use eval "
const emails = [];
document.querySelectorAll('tr.zA').forEach((row, i) => {
if (i < 20) {
const sender = row.querySelector('.yX.xY span')?.innerText || '';
const subject = row.querySelector('.y6 span')?.innerText || '';
const snippet = row.querySelector('.y2')?.innerText || '';
const time = row.querySelector('.xW.xY span')?.innerText || '';
emails.push({ sender, subject, snippet, time });
}
});
JSON.stringify(emails, null, 2);
"
# ...
# 未读统计
browser-use eval "
(() => {
const unread = document.querySelectorAll('.zE').length;
const visible = document.zA').length;
return JSON.stringify({ unread, visible, timestamp: new Date().toISOString() });
})()
"
# ...
browser-use close
输出示例:
==========================================
邮件日报 - 2026-07-20
==========================================
统计概览:
- 未读邮件: 12 封
- 可见邮件: 50 封
- 命中白名单: 2 封
# ...
重要邮件:
1. boss@company.com | 项目进度汇报 - 紧急 | 09:30
2. finance@bank.com | 账单提醒 | 08:15
# ...
建议操作:
- 回复 boss@company.com
- 处理 3 封审批邮件
==========================================
案例 2:监控 boss@company.com 邮件
sleep 3
# ...
browser-use eval "
const hits = [];
document.zA').forEach(row => {
querySelector('.yX.xY span')?.innerText || '';
if (sender.toLowerCase().includes('boss@company.com')) {
hits.push({
sender,
subject: row.querySelector('.y6 span')?.innerText || '',
time: row.querySelector('.xW.xY span')?.innerText || ''
});
}
});
JSON.stringify(hits, null, 2);
"
输出示例:
[
{ "sender": "boss@company.com", "subject": "项目进度汇报 - 紧急", "time": "09:30" },
com", "subject": "周一晨会议程", "time": "07:45" }
]
案例 3:多账号(Gmail + QQ 邮箱)合并日报
DATE=$(date +%Y-%m-%d)
REPORT="$OUTPUT_DIR/daily_$DATE.md"
echo "# 跨邮箱日报 $DATE" > "$REPORT"
# ...
# Gmail 分节
sleep 3
echo "## Gmail" >> "$REPORT"
browser-use extract "提取前 10 封邮件的发件人、主题、时间,按重要性排序" >> "$REPORT"
browser-use close
# ...
# QQ 邮箱分节
sleep 3
echo "## QQ 邮箱" >> "$REPORT"
browser-use extract "提取前 10 封邮件的发件人、主题、时间,按重要性排序" >> "$REPORT"
browser-use close
# ...
echo "报告已生成: $REPORT"
定时任务
Linux/macOS (crontab)
crontab -e
# 每日 09:00 执行
0 9 * * * /path/to/email_daily_summary.sh >> /path/to/logs/email_summary.log 2>&1
macOS (launchd)
创建 $HOME/Library/LaunchAgents/com.email.dailysummary.plist,设置 StartCalendarInterval 为 Hour=9, Minute=0,ProgramArguments 指向脚本路径,然后:
launchctl load $HOME/Library/LaunchAgents/com.email.dailysummary.plist
异常响应
1. browser-use CLI 未安装或不可用
- 现象:执行
browser-use报command not found - 处理:
uv pip install browser-use[cli]后再执行browser-use install安装浏览器依赖
2. Chrome 会话过期或未登录
- 现象:
--browser real打开邮箱后跳转到登录页 - 处理:切换
--headed模式手动登录一次,或在本机 Chrome 中重新登录目标邮箱后
3. CSS 选择器失效(DOM 改版)
- 现象:
eval返回空数组或unread: 0但页面明显有未读邮件 - 处理:
browser-use state重新探测当前 DOM,更新选择器(如 Gmail 由tr.zA改为tr.zB),并将新选择器写入配置
4. 登录遇到二次验证或验证码
- 现象:登录流程卡在 SMS 验证码或图形验证码页面
- 处理:必须使用
--headed模式由人工完成验证;自动化流程不可规避验证码
5. 邮件列表加载缓慢
- 现象:
state显示页面已加载但tr.zA数量为 0 - 处理:在
open与eval之间插入sleep 5,或循环browser.scroll('down')触发懒加载
6. screenshot 写入失败
- 现象:
browser-use screenshot报权限错误或路径不存在 - 处理:执行前
mkdir -p "$OUTPUT_DIR"创建目录,确认运行用户对目录有写权限
7. eval 脚本执行超时
- 现象:邮件量大(>100 封)时
eval单次执行超过浏览器脚本超时阈值 - 处理:分批抓取,每次
i < 20,滚动后再抓取下一批,合并结果
8. crontab 环境变量缺失
- 现象:手动执行正常,crontab 触发时报
browser-use: command not found - 处理:在脚本顶部显式
export PATH=/usr/local/bin:/opt/homebrew/bin:$PATH,或使用browser-use绝对路径
指南中心
Q1:如何避免在脚本中保存邮箱密码?
优先使用 --browser real 模式复用本机 Chrome 已登录会话,凭证由 Chrome 管理,脚本不接触密码。必须登录时,密码从系统环境变量或 keyring 读取,不硬编码.
Q2:如何同时汇总多个邮箱?
顺序执行多个 browser-use --browser real open <url> 块,每个邮箱独立 extract 后追加到同一份 Markdown 报告,按邮箱分节展示。参考案例 3.
Q3:AI 摘要功能(extract)需要什么配置?
extract 依赖 browser-use 内置 LLM,需配置 OPENAI_API_KEY 或同等 LLM 凭证。未配置时降级为纯 eval 抓取四元组,不生成 AI 摘要.
Q4:如何切换到无头模式?
将 --browser real 替换为 --headless,但无头模式无法复用 Chrome 已登录会话,需改用 token 或手动登录流程。生产环境定时任务推荐保持 --browser real 并锁定屏幕.
Q5:截图保存路径如何自定义?
通过 OUTPUT_DIR 环境变量控制,默认 ./email_summaries。建议设置为绝对路径(如 /var/log/email_summaries)以便定时任务稳定写入.
Q6:邮件量很大(>100 封)时如何处理?
分页抓取:每次 eval 取 20 封,browser.scroll('down') 触发加载,sleep 1 等待渲染,循环至 tr.zA 数量不再增长。合并所有批次后生成日报.
限制条件
- CSS 选择器依赖邮箱 Web 版 DOM 结构,Gmail/Outlook 改版可能导致
tr.zA、.zE等选择器失效,需定期校验 --browser real需要本机 Chrome 已登录目标邮箱,服务器或无 GUI 环境不适用- 验证码、二次验证、风险控制验证必须人工干预,无法全自动规避
- 仅支持 Web 邮箱自动化,不支持 IMAP/POP/SMTP 协议直连
- 单次抓取受浏览器渲染性能限制,超大量邮箱(>500 封/日)建议改用 IMAP 方案
- QQ 邮箱、163 邮箱的 Web 版反自动化策略可能导致
--browser real失效,需--headed人工辅助 - 截图为整页快照,长收件箱可能被截断,需配合滚动分页截图
安全提示
- 不在脚本中明文保存密码,优先
--browser real复用会话 - 敏感凭证使用环境变量或系统 keyring 存储
- 定期检查邮箱授权应用列表,移除不需要的第三方访问
- 启用邮箱两步验证,自动化仅复用已登录会话不规避验证
- 日志文件不记录邮件正文,仅记录发件人、主题、时间元数据
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
差异化分析
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 邮件阅读 | 30分钟/封 | 1分钟/封 | 29分钟 | 95% |
| 邮件筛选 | 10分钟/封 | 1分钟/封 | 9分钟 | 98% |
| 邮件分类 | 5分钟/封 | 1分钟/封 | 4分钟 | 99% |
| 邮件统计 | 20分钟 | 2分钟 | 18分钟 | 100% |
| 邮件摘要 | 15分钟/封 | 1分钟/封 | 14分钟 | 97% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 自动化程度 | 高 | 低 | 中 | 高 |
| 操作便捷性 | 高 | 低 | 中 | 高 |
| 功能丰富性 | 高 | 低 | 中 | 高 |
| 成本效益 | 高 | 低 | 中 | 高 |
| 适应场景 | 广泛 | 有限 | 有限 | 有限 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 邮件处理效率低 | 邮件处理耗时,影响工作效率 | 个人、团队 | 邮件自动化处理 | 时间节约30% |
| 邮件信息遗漏 | 邮件信息处理不全面,可能导致重要信息遗漏 | 个人、团队 | 邮件智能摘要 | 准确率提升98% |
| 邮件分类困难 | 邮件分类工作量大,容易出错 | 个人、团队 | 邮件自动分类 | 准确率提升99% |
Related skills
- Downloads
- 404All time
- Security audit
- Review
- Last updated
- 2mo ago
- Current version
- v1.0.0
- License
- MIT-0
