Pocket AI Transcripts

核心用法

Pocket Transcripts 是一个针对 Pocket AI 硬件录音设备的第三方数据访问工具，通过逆向工程官方 Web API 实现录音转录文本、智能摘要和行动项的检索功能。

主要功能：

• get_recordings() - 按时间范围列出录音，支持分页过滤
• get_recording_full() - 获取完整数据（转录文本 + 摘要 + 行动项）
• search_recordings() - 文本搜索历史录音
• 数据模型涵盖录音元信息（时长、位置、标签、说话人数量）及结构化摘要

技术实现：

• 依赖 Chrome 浏览器用户配置文件启动
• 从 app.heypocket.com 登录状态中提取 Firebase Bearer Token
• Token 有效期仅1小时，需手动刷新
• 调用 production.heypocketai.com/api/v1 端点

显著优点

• 硬件生态整合：直接对接 Pocket AI 专用录音设备，填补官方 API 开放度不足
• 结构化输出：提供 Markdown 格式摘要、行动项列表等即用型数据
• 元数据丰富：包含地理定位、说话人识别、自动标签等维度
• 搜索能力：支持跨录音内容检索

潜在缺点与局限性

1. 认证脆弱性：依赖浏览器手动登录 + Token 提取，流程繁琐且 Token 仅1小时有效期
2. 非官方方案：逆向工程 API 可能随时失效，无稳定性保障
3. 隐私风险：Token 存储于本地明文文件 ~/.pocket_token.json
4. 环境依赖：必须保持 Chrome 浏览器持续运行且登录状态有效
5. 无官方 SLA：数据访问受限于官方服务可用性

适合人群

• 已购买 Pocket AI 硬件设备的用户
• 需要将录音数据导入其他工作流（笔记、CRM、任务管理）的自动化需求者
• 能接受非官方方案风险的技术用户

常规风险

| 风险类型 | 说明 |

|---------|------|

| 服务中断 | 官方 API 变更将导致功能失效 |

| 数据安全 | Token 本地明文存储，存在泄露风险 |

| 隐私合规 | 录音内容涉及第三方时需注意 consent 合规 |

| 授权争议 | 逆向工程可能违反服务条款 |

> ⚠️ 此技能未经过正式安全扫描，实际部署前建议审查 scripts/reader.py 中的网络请求实现及 Token 存储机制。

核心功能

pocket-transcripts 是一款用于读取和管理 Pocket AI 录音设备数据的 Claude 技能。该技能通过反向工程 Pocket 官方 API，实现录音列表检索、转录文本提取、智能摘要获取及行动项提取等功能。

主要用法

1. 录音检索：get_recordings(days, limit) 获取近期录音列表，支持按时间范围和数量限制筛选
2. 完整数据获取：get_recording_full(id) 一次性获取转录文本、Markdown 摘要和行动项列表
3. 精准搜索：search_recordings(query) 支持按关键词搜索 90 天内录音
4. 分项获取：get_transcript() 和 get_summarization() 可单独提取原始文本或摘要

显著优点

• 纯标准库实现：仅依赖 Python 内置模块（json, urllib, pathlib 等），无第三方包引入，零 CVE 漏洞风险
• 功能完整：涵盖录音元数据、转录文本、AI 摘要、行动项等全量数据读取
• Token 自动管理：内置 1 小时过期机制，支持自动刷新流程
• 数据结构清晰：PocketRecording、PocketSummarization 等类型定义完善，便于二次开发

潜在局限与风险

| 风险项 | 说明 | 缓解措施 |

|--------|------|----------|

| **Token 本地存储** | Firebase Bearer token 以明文 JSON 存于 `~/.pocket_token.json` | 1 小时自动过期，建议使用后手动清理 |

| **browser skill 依赖** | 需配合 Anthropic 官方 browser skill 从 Chrome 提取 token | 确保从官方仓库安装，Chrome 以 `--profile` 模式安全运行 |

| **反向工程 API** | 非官方公开 API，Pocket 服务端变更可能导致失效 | 关注技能更新，遵守服务条款 |

| **T3 来源** | 个人开发者维护，长期支持存在不确定性 | 审查代码后使用，关注社区反馈 |

适合人群

• Pocket AI 录音设备的重度用户，需要批量导出或分析录音内容
• 希望将录音数据接入本地工作流（如知识库、笔记系统）的效率工具爱好者
• 具备基础 Python 和命令行操作能力的技术用户

使用建议

首次配置需完成三步：启动 Chrome profile 模式 → 登录 Pocket 网页版 → 运行 token 提取脚本。建议将 token 文件权限设为 600，避免在共享机器上使用，敏感录音内容注意输出脱敏。