Plaud录音笔官方API接入方案，支持录音下载、转录文本与AI摘要获取，需从浏览器提取认证令牌。
说明：
## 核心用法
Plaud API Skill 专为访问 Plaud AI 录音笔数据设计，提供录音文件（MP3）、转录文本（含说话人分离）及 AI 生成摘要的一站式获取能力。核心依赖 `plaud_client.py` 命令行工具，封装了认证管理、错误处理与响应解析，无需直接调用底层 HTTP API。
**认证流程**：用户需登录 https://web.plaud.ai，通过 Chrome DevTools 的 Application → Local Storage 提取 `tokenstr`（Bearer Token）与 `plaud_user_api_domain`（区域 API 端点），写入 `~/.claude/skills/plaud-api/.env` 文件后方可使用。
**主要命令**：
– `list` / `list –json`：列出所有录音
– `details `：获取转录详情与 AI 摘要
– `download `：下载 MP3 音频
– `download-all -o `：批量下载
– `tags`：获取文件标签/文件夹信息
## 显著优点
1. **官方数据源**：直接对接 Plaud 云服务，非第三方逆向工程，数据完整性有保障
2. **结构化输出**：JSON 模式便于与 `jq` 等工具链集成，支持批量自动化处理
3. **完整数据栈**：单一接口覆盖音频、转录、摘要三层数据，省去多源整合成本
4. **长周期 Token**：认证令牌有效期约 10 个月，维护成本低
## 潜在缺点与局限性
1. **认证门槛高**：需手动从浏览器 DevTools 提取令牌，无 OAuth 流程，用户体验不佳
2. **区域锁定风险**：API 域名随用户注册区域变化（如 EU 用户为 `api-euc1`），跨区迁移可能导致配置失效
3. **无实时能力**：仅支持已上传云端的历史录音，无法实时流式获取
4. **Token 无自动刷新**：过期后需重复手动提取流程，无程序化续期机制
## 适合人群
– Plaud 录音笔硬件用户，需批量导出或自动化处理录音数据
– 需要将会议/访谈录音转录文本导入知识库、Notion、Obsidian 等工具的效率工作者
– 开发者构建基于语音数据的自动化工作流（如自动摘要、待办提取）
## 常规风险
– **Token 泄露风险**：Bearer Token 长期有效，若 `.env` 文件未妥善保管（如误提交 Git），可导致账户数据完全暴露
– **单点依赖**：Plaud 云服务不可用或 API 变更将直接中断数据访问
– **隐私合规**：转录数据可能包含敏感对话，本地存储与后续处理需符合 GDPR/个人信息保护法规
