📦 Google Voice — Google語音
v0.1.1Google Voice 网页客户端自动化和MCP集成,从HAR捕获开始。用于反向工程voice.google.com.har,列出/读取/导出接收...
运行时依赖
安装命令
点击复制技能文档
Google Voice 使用捆绑的MCP服务器进行Google Voice web-client呼叫,来源于~/Downloads/har/voice.google.com.har。 安全性:不要暴露HAR cookies、授权头、电话号码、消息内容或反滥用令牌。发送SMS是一个外部操作。在调用gv_send_sms之前,必须获得用户对收件人和消息文本的明确批准。更倾向于浏览器认证模式,以便凭据保持在登录的浏览器会话中。 文本消息支持:此技能支持接收/读取/导出Google Voice文本消息记录和通过HAR-derived MCP工具发送Google Voice SMS。读取/导出是安全的,当用户请求自己的记录时。发送是一个外部操作:在调用gv_send_sms之前,必须确认确切的收件人和确切的消息文本。 从消息URL或itemId拉取SMS记录:当用户提供Google Voice消息URL(如https://voice.google.com/u/2/messages?itemId=t.%2B17025038136)或任何原始itemId/线程id时,使用捆绑的CLI: GV_API_KEY='' GV_AUTH_MODE=browser GV_CDP_URL=http://127.0.0.1:19222 node skills/google-voice/scripts/google-voice-sms-records.js --url 'https://voice.google.com/u/2/messages?itemId=t.%2B17025038136' --limit 500 --out /tmp/gv-sms-records.json 等效的原始itemId形式,在需要时带有显式登录的Google帐户索引: node skills/google-voice/scripts/google-voice-sms-records.js --itemId 't.+17025038136' --authuser 1 --format md 对于/u/N URL,脚本推断x-goog-authuser=N,除非GV_AUTHUSER或--authuser设置。它更倾向于已经打开的voice.google.com/u/N标签页,并在没有合适标签页的情况下打开该帐户特定的URL。它在认证的浏览器会话中调用/voice/v1/voiceclient/api2thread/get,并返回带有id、timestampMs、ISO时间戳、from、type和text的归一化记录。 仅在调试时添加--raw,并且不要在用户授权的上下文之外暴露原始有效载荷或SMS内容。 MCP服务器: 服务器脚本:node /home/umbrel/.openclaw/workspace-realestate-ops/skills/google-voice/scripts/google-voice-mcp.js 等效源副本:node /home/umbrel/.openclaw/workspace-realestate-ops/mcp/google-voice-mcp/server.js 在调用之前,从当前Google Voice web会话/HAR中设置GV_API_KEY。不要写入或提交该密钥。 默认认证模式是浏览器/CDP: GV_API_KEY='' GV_AUTH_MODE=browser GV_CDP_URL=http://127.0.0.1:19222 node skills/google-voice/scripts/google-voice-mcp.js GWS OAuth模式可用于实验: GV_AUTH_MODE=gws node skills/google-voice/scripts/google-voice-mcp.js 这使用gws auth导出本地刷新OAuth bearer令牌。Google Voice web端点可能仍会拒绝它,因为捕获的HAR使用浏览器cookie,而不是bearer认证。头认证模式也可用,但GV_COOKIE或GV_AUTHORIZATION的安全性较低。 暴露的工具: gv_list_threads:列出Google Voice线程摘要。 gv_get_thread:通过threadId读取线程,例如t.22395。 gv_send_sms:发送Google Voice SMS/文本消息。在调用gv_send_sms之前,必须获得对确切收件人和确切消息文本的明确批准。 gv_raw_call:HAR-derived端点/正文调用的调试工具。 HAR逆向工程: 为了不泄露秘密而重新总结端点: python3 skills/google-voice/scripts/analyze_voice_har.py ~/Downloads/har/voice.google.com.har 对于端点注释,请阅读references/har-endpoints.md。 操作模式: 验证Google Voice标签/会话是否存在于用户浏览器中,或者手动/浏览器工具打开https://voice.google.com/。 以浏览器模式启动MCP服务器。 使用MCP工具列出/读取线程。 对于发送,询问确切的收件人和确切的消息,然后在获得批准后调用gv_send_sms。 如果调用失败,请检查references/har-endpoints.md,并谨慎使用gv_raw_call。