动态OAuth授权工具

技能简介

pdauth 是一款面向 AI 代理的动态 OAuth 授权工具，基于 Pipedream 平台实现。它允许 AI 代理为超过 2500 个 API 生成 OAuth 授权链接，用户点击完成授权后，代理即可代表用户调用各类 MCP 工具。

业务背景

解决AI代理跨平台授权难题。企业部署AI助手时，常需对接员工日常使用的SaaS工具，但传统方式要求IT为每个应用单独配置API密钥，管理成本高且存在泄露风险。本工具让AI代理按需生成OAuth链接，员工自主点击授权即可，既保留用户对数据访问的控制权，又免去IT集中保管大量凭证的负担，实现安全与效率的平衡。

落地案例：某企业市场部使用AI助手分析竞品动态。助手需读取团队的Notion知识库和Slack讨论记录，但无法直接获取权限。运营人员运行指令后，AI向相关负责人推送Notion和Slack的授权链接，对方手机端确认后，助手即刻开始抓取指定页面的更新摘要和频道关键词，自动生成周报初稿。整个过程中，企业无需预先申请或存储任何平台的管理员令牌。

能做什么

• 为 Spotify、Slack、Notion、Gmail 等主流应用生成 OAuth 授权链接
• 查询用户已连接的应用状态
• 列出指定应用支持的工具接口
• 以命令行方式调用已授权应用的 API 功能
• 支持 JSON 格式输出，便于程序解析处理

使用说明

安装指令：

npm install -g pdauth

配置与使用步骤：

1. 首次运行配置：pdauth config，设置 Pipedream 凭证
2. 搜索目标应用：pdauth apps --search spotify
3. 生成授权链接：pdauth connect spotify --user USER_ID
4. 将链接发送给用户，用户点击完成授权
5. 确认连接状态：pdauth status --user USER_ID
6. 查看可用工具：pdauth tools spotify --user USER_ID
7. 调用具体工具：pdauth call spotify.get_my_playlists --user USER_ID

用户 ID 建议：保持同一用户在不同会话中使用一致的标识符，如 telegram:5439689035、邮箱地址或自定义字符串。

输入与输出

见下方输入与输出表格。

风险提示

• OAuth 链接有效期为 4 小时，过期需重新生成
• 需妥善保管 Pipedream 账户凭证，避免泄露
• 用户授权范围取决于各应用本身的权限设计
• 网络异常可能导致授权流程中断，需检查状态后重试

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/g9pedro/pdauth/SKILL.md
来源类型：GitHub 开源项目