如何利用 AI 实现 Google Sheets 表格自动化读写 #

解决手动录入和导出数据的低效问题：通过轻量化的 Python 脚本与 OAuth 认证，让 AI 能够直接读取、搜索、更新和追加 Google Sheets 表格内容。

为什么需要这个技能 #

在处理业务数据时，Google Sheets 经常被用作轻量级数据库。但传统的自动化方式要么需要复杂的 GCP 项目配置，要么需要运行一个沉重的 MCP 服务器。

本技能提供了一套轻量化的集成方案，支持独立的 OAuth 身份验证，让 AI 可以通过简单的命令行指令完成从“读取单元格”到“批量更新数据”的所有操作。它直接将表格内容转换为 AI 易于理解的文本、CSV 或 JSON 格式，极大地简化了数据同步工作流。

适用场景 #

• 自动化报表：AI 自动从其他来源收集数据并将其追加（Append）到 Google 表格中。
• 数据分析：AI 读取特定范围（Range）的单元格数据，进行分析并直接将结果写回表格。
• 快速搜索：通过关键词快速定位公司内部的多个 Spreadsheet 文件。
• 动态更新：根据实时触发条件，自动修改表格中的特定数值或状态。

核心工作流 #

1. 身份认证 #

首次使用需通过浏览器完成 Google Workspace 账号授权（注意：不支持个人 Gmail 账号）：

python scripts/auth.py login

可通过 python scripts/auth.py status 检查登录状态。

2. 数据读取 #

AI 可以通过 scripts/sheets.py 获取不同格式的数据。支持直接输入 Spreadsheet ID 或完整的 URL。

# 获取纯文本内容（默认）
python scripts/sheets.py get-text SPREADSHEET_ID

# 以 JSON 格式获取，方便 AI 进行结构化处理
python scripts/sheets.py get-text SPREADSHEET_ID --format json

# 读取特定区域（如 Sheet1 的 A1 到 D10）
python scripts/sheets.py get-range SPREADSHEET_ID "Sheet1!A1:D10"

3. 数据写入与更新 #

支持将数据以二维数组的形式写入，可选择解析模式（USER_ENTERED）或原始文本模式（RAW）。

# 更新指定范围的值
python scripts/sheets.py update-range SPREADSHEET_ID "Sheet1!A1:B2" '[["Hello","World"],["Foo","Bar"]]'

# 在表格末尾追加新行
python scripts/sheets.py append-rows SPREADSHEET_ID "Sheet1!A:Z" '[["New Row Col A","New Row Col B"]]'

下载和安装 #

下载 google-sheets-automation 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐