Google Sheets Agent

核心用法

Google Sheets Agent 是一款轻量级命令行工具，专为需要与Google Sheets交互的AI Agent和工作流自动化设计。它采用纯Node.js实现，利用内置的https和crypto模块完成OAuth 2.0 JWT认证，彻底摆脱了对googleapis等重型依赖的束缚。

关键配置：用户需在Google Cloud Console创建服务账号，启用Sheets API与Drive API，下载JSON密钥后通过环境变量GOOGLE_SA_KEY_JSON、GOOGLE_SA_KEY_FILE或1Password CLI安全存储。随后将目标表格分享给服务账号邮箱即可。

命令体系：

• list — 列出服务账号可访问的所有表格
• meta — 获取表格元数据（工作表名称、行列范围）
• read — 读取指定范围数据，默认Sheet1!A:ZZ
• append — 从stdin接收JSON数组，追加到表格
• write — 覆盖写入指定范围

所有输出均为JSON格式，便于与jq等工具链式处理。

显著优点

1. 零依赖架构：对比googleapis包的200+依赖、约50MB体积，本工具单文件仅8KB，消除供应链攻击面，实现秒级安装
2. 认证简化：仅需3行配置即可完成服务账号JWT认证，无需复杂的OAuth流程
3. 内存安全：访问令牌缓存1小时，避免重复请求
4. 权限分离：读写命令自动切换scope，最小权限原则

潜在局限

• 功能边界：不支持格式设置、公式计算、批量更新等高级Sheets功能
• 认证方式：仅限服务账号，不支持用户OAuth（即无法操作"我的云端硬盘"中未共享的个人文件）
• 错误处理：依赖Google API原生错误返回，调试信息较简略
• 长期维护：零依赖意味着需手动跟进Google API变更

适合人群

• 构建自动化工作流的独立开发者与Solopreneur
• 需在CI/CD管道中快速读写表格数据的DevOps工程师
• 追求极简部署、厌恶npm依赖地狱的技术团队
• 需要将表格作为轻量级数据库或配置存储的后端场景

常规风险

• 密钥泄露：服务账号JSON密钥一旦暴露，攻击者可永久访问关联表格；务必使用1Password或密钥管理服务
• 权限蔓延：write/append命令请求完整spreadsheets scope，建议为不同用途创建独立服务账号
• 数据覆盖：write命令无确认机制，误操作可能导致数据丢失
• API配额：Google Sheets API有默认配额限制，高频写入需申请扩容