用途
该技能用于通过 Rube MCP（Composio）自动化 Google Sheets 的常见操作，包括读取和写入数据、管理电子表格与工作表标签、格式化单元格、筛选行以及按唯一键更新或插入记录。
主要能力
- 读取与写入数据：支持批量读取一个或多个范围，批量写入或追加行，也可更新单个指定范围。
- 创建与管理电子表格：可新建电子表格、添加工作表标签、重命名、隐藏、重排或设置标签颜色，获取电子表格元数据，检查特定标签是否存在。
- 搜索与筛选行：可按精确单元格值查找首行匹配项，或对范围应用筛选与排序，也可清除已有筛选。
- 按唯一键 Upsert 行：根据指定键列更新已有行或追加新行，适用于 CRM 同步、库存更新和去重场景。
- 格式化单元格：可对范围应用加粗、斜体、下划线、删除线、背景色、字号等格式。
使用方式
- 前置条件：Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）；通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit googlesheets 建立有效的 Google Sheets 连接；每次操作前先调用 RUBE_SEARCH_TOOLS 获取当前工具模式。
- 设置：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥；确认 RUBE_SEARCH_TOOLS 有响应；调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit googlesheets；若连接未激活，按返回的授权链接完成 Google OAuth；确认连接状态为 ACTIVE 后再运行工作流。
- 核心工作流示例：
- 读取与写入数据：先搜索电子表格、获取工作表名称，再批量读取或批量更新；关键参数包括 spreadsheet_id、ranges（A1 表示法，建议使用有界范围）、sheet_name、values（二维数组）、first_cell_location、valueInputOption（USER_ENTERED 或 RAW）。
- 创建与管理电子表格：创建新表、添加标签、更新标签属性、获取元数据、按标题查找工作表；注意标签名需唯一，默认标签名依赖语言环境，并行创建多个工作表时不要使用 index。
- 搜索与筛选行：使用精确匹配查找行，或设置基本筛选与排序；注意查找匹配整个单元格内容，含空格的工作表名在范围中需用单引号包裹。
- 按唯一键 Upsert：指定 keyColumn 为实际列标题名（如 'Email' 而非 'A'），提供 headers 和 rows；strictMode 默认 true，列数不匹配会报错；会自动添加缺失列。
- 格式化单元格：需先获取数字 worksheet_id，再对范围应用格式；颜色通道为 0.0-1.0 浮点数，非 0-255 整数；每次调用格式化一个范围。
适用场景
- 需要批量读取或写入 Google Sheets 数据的自动化流程。
- 创建和管理电子表格结构，如添加、重命名、隐藏标签。
- 在表格中查找特定行或应用筛选与排序。
- 基于唯一键同步 CRM、更新库存或去重。
- 对单元格应用格式以提升可读性。
限制
- Google Sheets 有严格速率限制：每分钟最多 60 次读取和 60 次写入，超出会报错，建议使用批量操作。
- 标签名依赖语言环境，非英语账户可能没有 'Sheet1'。
- 含空格的工作表名在 A1 表示法中需用单引号包裹。
- 无界范围（如 'A:Z'）在大表上可能超时，应指定行边界。
- 所有值参数必须为二维数组（列表的列表），即使只有一行。
- 颜色值为 0.0-1.0 浮点数，不是 0-255 整数。
- 格式化需要数字 sheetId，而非标签标题。
- 删除行列操作不可逆，需仔细检查边界。
- 部分操作可能返回空回复对象，需通过读回验证。
- 若账户无权限，获取电子表格信息可能返回 403。