核心用法
Google Keep Skill 是一款基于 nodriver 库开发的自动化工具，利用真实的 Chrome 浏览器实例操控 Google Keep，完全规避传统自动化工具面临的机器人检测机制。用户通过命令行界面执行笔记管理操作，包括创建文本/清单笔记、读取、更新、删除、归档及批量列出笔记。
显著优点
1. 绕过反机器人检测：采用真实 Chrome 浏览器而非 headless 模式，配合 nodriver 的无头自动化方案，Google 难以识别为自动化脚本
2. 零 API 密钥依赖：无需申请 Google Cloud API 密钥，直接使用用户账号权限操作个人数据
3. 会话持久化：首次手动登录后，会话 cookies 加密保存于 ~/.config/google-keep-skill/，后续操作无需重复认证
4. 结构化 JSON 输出：所有操作返回标准 JSON 格式，便于 AI Agent 解析和二次处理
5. 双模式笔记支持：完整支持文本笔记和待办清单(checklist)两种 Google Keep 原生格式
潜在缺点与局限性
- 手动初始化门槛：必须人工执行一次登录流程，无法完全无人值守部署
- 单实例并发限制：同一 Chrome 用户配置无法多进程同时使用
- 内容更新非增量：
update命令为全量替换，修改清单中单个项目需先读取完整内容再重构 - 平台依赖性强：强制依赖系统级 Google Chrome 安装，Linux 需
google-chrome-stable - 会话过期风险：Google 账号安全策略可能导致会话失效，需重新手动登录
适合人群
- 需要自动化笔记管理但无法申请 Google API 的开发者
- 追求隐私、不愿将笔记数据通过第三方 API 传输的技术用户
- AI Agent 开发者需要集成个人知识管理功能的场景
常规风险
- 会话存储目录权限虽设为
700，但仍存在本地文件系统层面的凭证泄露风险 - 长期使用真实浏览器自动化可能触发 Google 账号异常活动检测
- 更新操作的全量替换特性存在误覆盖数据风险，需严格遵循"先读取后修改"流程
安全边界强调
开发者明确设置了关键数据外泄防护规则：AI Agent 严禁读取、复制或传输 ~/.config/google-keep-skill/ 目录下的任何会话文件内容，该约束以硬规则形式写入文档。