用途:为隔离浏览器 MCP 智能体管理 Cookie 持久化。隔离浏览器启动时会从 ~/.claude/browser-sessions.json 加载 Cookie,但不会自动保存变更,本技能负责导出/导入循环。
存储:Cookie 文件为 ~/.claude/browser-sessions.json,格式为 Playwright storageState JSON(含 cookies 与 origins)。所有隔离浏览器智能体(isolated-browser、reddit-agent、twitter-agent、linkedin-agent)都通过配置中的 storageState 读取该文件。
工作流一:从隔离浏览器保存 Cookie。在新服务登录后,通过 mcp__isolated-browser__browser_run_code 调用 page.context().cookies() 导出当前 Cookie,再解析并合并进 browser-sessions.json,合并时以 domain + name + path 为键,导出值优先。随后关闭并重新打开隔离浏览器以加载更新后的 Cookie。
工作流二:从真实 Chrome 播种 Cookie。通过 mcp__playwright-extension__browser_run_code 导出 Cookie,然后整体替换 browser-sessions.json 中的 cookies 数组,再重启隔离浏览器。
工作流三:每次隔离浏览器会话后保存。凡涉及登录、表单提交或认证的任务,结束前都应先执行工作流一,确保下次会话拿到最新 Cookie。
限制:Cookie 仅在上下文创建时加载一次,会话中的变更只存在于内存,需显式保存;所有隔离浏览器智能体共享同一 browser-sessions.json,一个智能体保存会影响全部;部分 httpOnly 会话绑定 Cookie 可能无法迁移(如 GitHub user_session),需每会话重新登录;Google 会话 Cookie(SID、HSID、SSID、APISID、SAPISID 等)可以正常迁移并持久保存。