pdauth 是一个专为 AI Agent 设计的 OAuth 授权代理工具，通过 Pipedream 平台桥接超过 2500 个第三方 API，解决 AI 代理访问用户私有数据的身份验证难题。
核心用法遵循「配置-搜索-授权-调用」四步流程。首次使用需运行 pdauth config 完成 Pipedream 凭证配置；通过 pdauth apps --search 查找目标应用（如 Spotify、Notion、GitHub）；使用 pdauth connect <app> --user <ID> 生成专属 OAuth 链接，用户点击完成授权后，代理即可通过 pdauth call <app.tool> 以用户身份调用 API。系统支持 --json 结构化输出，便于 Agent 解析处理。
显著优点在于其标准化的授权体验与庞大的生态覆盖。相比传统 API Key 方式，OAuth 2.0 流程让用户完全掌控数据访问范围，支持随时撤销授权；Pipedream 平台预集成 2500+ 应用，无需开发者逐个对接不同厂商的 OAuth 文档，大幅降低集成门槛。此外，通过 --user 参数实现的会话隔离机制，确保多用户场景下凭证管理互不干扰。
潜在局限主要集中在供应链依赖与来源可信度。该 Skill 为纯文档型资产，实际执行依赖用户本地安装的 pdauth Node.js 包及 Pipedream 云服务，形成双重外部依赖；项目由个人开发者（T3 来源）维护，长期更新稳定性存疑；OAuth Token 由 Pipedream 云端托管而非本地存储，对数据主权要求严格的场景不适用；授权链接 4 小时过期的设计虽提升安全性，但也增加了长时任务中断风险。
适合群体包括需要快速为 AI 助手集成第三方服务的开发者、构建个人自动化工作流的技术用户，以及进行多 API 原型验证的产品团队。特别适用于客服机器人需要查询用户 Notion 文档、个人助手管理 Spotify 播放列表、自动化工具操作 GitHub Issue 等场景。
使用风险需关注第三方平台可靠性：Pipedream 服务中断将直接影响全部 API 调用；用户授权时若未仔细审查 Scope 范围，可能导致 AI 获得过度权限（如 Gmail 的邮件发送权）；CLI 工具作为个人项目，若存在未审计的安全漏洞，可能导致 Token 泄露。建议在生产环境部署前，审查 pdauth 开源代码并建立 Token 失效应急预案。