Plaud Unofficial Skill

核心用法

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 <file_id>：获取转录详情与 AI 摘要
• download <file_id>：下载 MP3 音频
• download-all -o <path>：批量下载
• 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/个人信息保护法规

核心用法

Plaud API Skill 是一款面向 Plaud 智能录音笔用户的非官方 CLI 工具封装，提供录音数据的全流程访问能力。用户通过 Chrome DevTools 从 Plaud Web 应用提取 tokenstr 和 plaud_user_api_domain 两个凭证值，配置到本地 .env 文件后即可使用。核心入口为 plaud_client.py，封装了官方 API 的认证、错误处理和响应解析，无需直接编写 HTTP 请求代码。

主要功能包括：录音列表查询（支持 JSON 输出）、单文件详情获取（含转录文本与 AI 摘要）、音频 MP3 下载（单文件或批量）、以及文件标签/文件夹管理。典型工作流为：执行 list 获取文件 ID → 使用 details --json 提取转录内容 → 通过 jq 过滤所需字段（如 trans_result.segments[].text 或 ai_content）→ 按需下载音频归档。

显著优点

操作极简：封装了 OAuth Token 管理和 API 端点切换，用户只需关注业务逻辑；功能完整：覆盖 Plaud 官方 Web 应用的核心数据能力，包括带说话人分离的完整转录和结构化 AI 摘要；批处理友好：download-all 和 JSON 管道输出适合自动化脚本集成；数据自主：将云端录音数据拉取到本地存储，满足离线归档和二次加工需求；依赖安全：仅依赖 requests 和 python-dotenv 两个成熟开源库，无额外供应链风险。

潜在缺点与局限性

非官方性质：Skill 为社区开发者逆向工程官方 API 而来，Plaud 可能随时调整接口导致失效，无 SLA 保障；凭证获取门槛：需用户手动操作浏览器 DevTools 提取 Token，流程繁琐且 Token 有效期约 10 个月需定期更新；区域限制：API 域名分 EU/US 等区域，配置错误会导致连接失败；无实时同步：仅支持按需拉取，无 Webhook 或增量同步机制；功能边界固定：不支持录音编辑、分享链接生成等 Web 端功能。

适合的目标群体

• 知识工作者：需要将会议、访谈录音转录文本导出到本地知识库（Notion/Obsidian）的用户
• 内容创作者：批量获取播客素材或采访录音进行后期剪辑归档
• 企业合规人员：需离线留存语音会议记录以满足审计要求的场景
• 自动化爱好者：希望将 Plaud 数据接入自建 workflow（如 n8n、Make）的技术用户

使用风险

网络依赖：Skill 运行需外部网络可达 Plaud 官方 API（api-euc1.plaud.ai），代理或防火墙环境需额外配置；凭证泄露风险：.env 文件存储明文 Token，需确保不被提交至 Git 或共享目录；数据隐私：录音内容传输至 Plaud 云端处理，敏感场景需评估第三方云服务合规性；Token 失效：10 个月有效期需设置日历提醒更新，避免自动化流程中断；API 限流：官方未公开速率限制，批量操作建议添加延时避免账号异常。