SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场google-drive

google-drive

办公与效率

查看项目

更新于 10-15 13:59

技能介绍

Google Drive 是一个轻量级的 Google Drive 集成技能，提供独立的 OAuth 认证，无需 MCP 服务器，具备完整的读写访问权限。该工具需要 Google Workspace 账号，不支持个人 Gmail 账号。

用途 该技能用于通过命令行与 Google Drive 进行交互，涵盖文件搜索、文件夹查找、内容列表、下载、上传、创建文件夹、移动、复制、重命名以及将文件移入回收站等操作。

主要能力

  • 搜索文件：支持全文搜索、仅按标题搜索、使用 Google Drive URL 自动提取 ID 搜索、搜索共享给你的文件，并支持分页。
  • 查找文件夹：按精确名称查找文件夹。
  • 列出内容：列出根目录或指定文件夹中的文件。
  • 下载文件：将文件下载到本地路径。
  • 上传文件：上传文件到根目录或指定文件夹，可自定义名称。
  • 创建文件夹：在根目录或指定父文件夹下创建新文件夹。
  • 移动文件：将文件移动到目标文件夹。
  • 复制文件：复制文件，可指定新名称和目标文件夹。
  • 重命名：重命名文件或文件夹。
  • 移入回收站：将文件移入回收站。

使用方式 首次设置需进行认证：

  • 登录（打开浏览器）：python scripts/auth.py login
  • 检查认证状态：python scripts/auth.py status
  • 登出：python scripts/auth.py logout

所有操作通过 scripts/drive.py 执行，首次使用时会自动认证。

读取命令示例：

  • 全文搜索：python scripts/drive.py search "quarterly report"
  • 仅按标题搜索：python scripts/drive.py search "title:budget"
  • 使用 URL 搜索：python scripts/drive.py search "https://drive.google.com/drive/folders/1ABC123..."
  • 搜索共享文件：python scripts/drive.py search --shared-with-me
  • 分页搜索：python scripts/drive.py search "report" --limit 5 --page-token "..."
  • 按精确名称查找文件夹：python scripts/drive.py find-folder "Project Documents"
  • 列出根目录：python scripts/drive.py list
  • 列出指定文件夹：python scripts/drive.py list 1ABC123xyz --limit 20
  • 下载文件：python scripts/drive.py download 1ABC123xyz ./downloads/report.pdf

写入命令示例：

  • 上传到根目录：python scripts/drive.py upload ~/Documents/report.pdf
  • 上传到指定文件夹：python scripts/drive.py upload ~/Documents/report.pdf --folder 1ABC123xyz
  • 上传并自定义名称：python scripts/drive.py upload ~/Documents/report.pdf --name "Q4 Report.pdf"
  • 创建文件夹：python scripts/drive.py create-folder "Project Documents"
  • 在父文件夹下创建：python scripts/drive.py create-folder "Attachments" --parent 1ABC123xyz
  • 移动文件：python scripts/drive.py move FILE_ID DESTINATION_FOLDER_ID
  • 复制文件：python scripts/drive.py copy FILE_ID
  • 复制并指定名称和文件夹：python scripts/drive.py copy FILE_ID --name "Report Copy" --folder 1ABC123xyz
  • 重命名：python scripts/drive.py rename FILE_ID "New Name.pdf"
  • 移入回收站：python scripts/drive.py trash FILE_ID

搜索查询格式 搜索命令支持多种查询格式：

  • 全文："quarterly report"，搜索文件内容和名称。
  • 标题："title:budget"，仅搜索文件名。
  • URL：https://drive.google.com/...，提取并使用文件/文件夹 ID。
  • 文件夹 ID：1ABC123...，列出文件夹内容（25 个字符以上的 ID）。
  • 原生查询：mimeType='application/pdf'，直接传递 Drive 查询语法。

文件 ID 格式 Google Drive 使用长 ID，如 1ABC123xyz_-abc123。可从以下位置获取 ID：搜索结果、find-folder 结果、list 结果、Google Drive URL。

下载限制

  • 普通文件（PDF、图片等）可直接下载。
  • Google Docs/Sheets/Slides 无法通过此工具下载。
  • 对于 Google Workspace 文件，请使用导出或专用工具。

令牌管理 令牌通过系统钥匙串安全存储：

  • macOS：Keychain
  • Windows：Windows Credential Locker
  • Linux：Secret Service API（GNOME Keyring、KDE Wallet 等）
  • 服务名称：google-drive-skill-oauth
  • 使用 Google 的云函数自动刷新过期令牌。

适用场景 适用于需要通过命令行自动化管理 Google Drive 文件的场景，例如批量搜索、上传、下载、整理文件夹等，尤其适合 Google Workspace 用户。

限制

  • 需要 Google Workspace 账号，不支持个人 Gmail 账号。
  • Google Docs/Sheets/Slides 无法直接下载。
  • 其他功能细节暂未提供。