用途:该技能用于在 Gmail 中搜索、获取和下载邮件,适用于“搜索 Gmail 中的会议记录”“查找某人发来的邮件”等请求。
主要能力:支持自由文本查询及 Gmail 原生搜索语法;提供 from、to、subject、label、after、before 等过滤辅助参数;支持未读、星标、含附件等状态过滤,可限制结果数量、显示完整正文或附件信息。可列出 Gmail 全部标签,并可下载指定邮件的附件。输出格式为 Markdown(默认)或 JSON(加 --json)。
使用方式:凭据需配置在 ~/.gmail_credentials/。先检查状态:python3 scripts/gmail_search.py setup;再进行认证:python3 scripts/gmail_search.py auth。搜索示例:python3 scripts/gmail_search.py search "meeting notes";带过滤:python3 scripts/gmail_search.py search --from "boss@company.com" --unread;下载附件:python3 scripts/gmail_search.py download MESSAGE_ID --output /path/to/folder。权限范围可用 scope 命令查看或设置,可选 readonly(默认,只读)、modify(可改标签、读写状态)、full(含删除)。依赖通过以下命令安装:pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib。
适用场景:检索历史邮件、按发件人或日期筛选、查找带附件邮件并下载附件、列出标签等。
限制:需先创建 Google Cloud 项目、启用 Gmail API 并配置 OAuth,测试应用须发布,否则会出现 403 access_denied;测试令牌 7 天后过期,生产需 Google 验证。相关凭据文件包括 credentials.json、token.pickle 与 scope.txt。具体平台与价格信息暂未提供。