跳到主要内容

获取邮件

指令说明

通过 IMAP 获取邮箱中的邮件,支持 QQ邮箱、163邮箱、126邮箱,也可以配置其他邮箱的 IMAP 服务器。

授权码不是邮箱登录密码,需要在邮箱设置中开启 IMAP/SMTP 服务后获取。

默认从收件箱 INBOX 中获取最近的邮件,可选择只获取未读邮件、获取后标记为已读、保存附件,或按发件人、收件人、主题、正文包含的文本进行筛选。

指令输入参数

输入参数输入参数类型说明
邮箱类型枚举项QQ邮箱、163邮箱、126邮箱、其他邮箱
IMAP服务器str邮箱类型为其他邮箱时需要,例如 imap.example.com
IMAP端口number 或 str邮箱类型为其他邮箱时需要,默认 993
邮箱账号str登录邮箱账号
授权码str邮箱授权码
邮件数量number 或 str最多获取的邮件数量,从最新邮件开始读取
仅未读邮件boolTrue 时只获取未读邮件
保存附件boolTrue 时保存邮件附件
附件保存目录str保存附件为 True 时需要
文件夹指定方式枚举项默认、动态指定
文件夹名称str文件夹指定方式为动态指定时需要,收件箱通常为 INBOX
标记为已读boolTrue 时获取后将邮件标记为已读
发件人包含str可选,为空时不筛选
收件人包含str可选,为空时不筛选
主题包含str可选,为空时不筛选
正文包含str可选,为空时不筛选

指令输出参数

输出参数输出参数类型说明
邮件列表list[map]每封邮件是一个映射,包含 subject、sender、receiver、cc、date、text、html、attachments、message_id

生成注意

  • 使用 IMAP 授权码,不是网页登录密码;仅“其他邮箱”需要填写 IMAP 服务器和端口。
  • 保存附件为 True 时必须填写附件保存目录。