Gmail 收件箱管理
目标
使用统一工具跨多个 Gmail 账户检查和管理电子邮件。
脚本
./scripts/gmail_unified.py- 检查和管理收件箱./scripts/gmail_multi_auth.py- 认证账户./scripts/gmail_bulk_label.py- 批量标签./scripts/gmail_create_filters.py- 创建过滤器./scripts/gmail_auth.py- 认证辅助工具
快速参考
# 检查所有账户的未读邮件
python3 ./scripts/gmail_unified.py --query "is:unread" --limit 50
# 仅检查特定账户
python3 ./scripts/gmail_unified.py --query "is:unread" --account yourcompany
# 列出已注册账户
python3 ./scripts/gmail_unified.py --accounts
# 标记并归档邮件
python3 ./scripts/gmail_unified.py --query "from:notifications@" --label "Notifications" --archive
# 标记为已读
python3 ./scripts/gmail_unified.py --query "from:noreply@" --mark-read
# 预演（预览）
python3 ./scripts/gmail_unified.py --query "subject:invoice" --label "Invoices" --dry-run
账户注册表
| 账户 | 邮箱 | 凭据 | 令牌 |
|---|---|---|---|
| youruser | [email protected] | credentials.json | token_youruser.json |
| yourcompany | [email protected] | credentials_yourcompany.json | token_yourcompany.json |
认证错误排除
“找不到令牌文件”
python3 ./scripts/gmail_multi_auth.py --account yourcompany --email [email protected]
“invalid_scope: 错误请求”
rm token_youruser.json
python3 ./scripts/gmail_multi_auth.py --account youruser --email [email protected]
“认证失败” 检查 credentials.json 是否存在于根目录。
必需的授权范围
gmail.modify- 读写邮件gmail.labels- 创建/管理标签gmail.settings.basic- 管理设置spreadsheets- Google Sheets 访问drive- Google Drive 访问
凭据位置
所有凭据文件应位于工作区根目录：
credentials.json/credentials_yourcompany.json- OAuth 客户端配置token_*.json- 认证令牌（自动生成）gmail_accounts.json- 账户注册表
模式
输入
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
query | string | 否 | Gmail 搜索查询（例如 'is:unread'） |
account | string | 否 | 注册表中的特定账户名称 |
limit | integer | 否 | 最多获取的邮件数（默认：50） |
输出
| 名称 | 类型 | 描述 |
|---|---|---|
emails | array | 包含主题、发件人、日期、摘要的邮件对象列表 |
凭据
| 名称 | 来源 |
|---|---|
credentials.json | 文件 |
token_*.json | 文件（自动生成） |
可组合
与该技能配合良好的技能：gmail-label、instantly-autoreply
费用
免费（Gmail API）