pmctl

🖥️ 终端直连 Postman,API 发现更高效

pmctl 是 Postman 的官方命令行工具,支持从终端浏览集合、检查请求详情、解析环境变量并生成 curl 命令,适合自动化 API 发现与调试。

收藏
3.9k
安装
1.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能与用法

pmctl 是 Postman 官方推出的命令行工具(CLI),旨在让开发者无需打开图形界面即可高效管理 API 集合、请求和环境变量。其核心能力包括:

  • 集合管理:列出、搜索和展示 Postman 集合的树状结构
  • 请求检查:查看请求方法、URL、头部、请求体、查询参数等完整详情
  • 环境解析:读取环境变量并支持 --full 显示完整值(包括敏感信息)
  • 模糊搜索:支持字符顺序匹配,快速定位请求
  • JSON 输出:可管道至 jq 进行脚本化处理
  • 多配置管理:支持多 Profile 切换,适应个人/工作多账户场景

显著优点

1. 无需 GUI:纯终端操作,适合远程服务器、CI/CD 流水线或偏好命令行的开发者
2. 自动化友好:--json 输出格式标准化,便于与 shell 脚本、自动化工具集成

3. 高效发现:模糊搜索和树状展示大幅降低大型 API 集合的认知负担

4. curl 生成:可基于请求详情快速构造可执行的 curl 命令

潜在局限

  • 需 Postman API Key:依赖 Postman 账户和 API 密钥,对离线或隐私敏感场景不友好
  • Python 依赖:需通过 pip 安装,环境隔离不当可能引发依赖冲突
  • 变量解析非自动化:{{variable}} 需手动结合 environments show 解析,未提供一键替换功能
  • 权限受限于 Postman 账户:只能访问账户有权限的工作空间和集合

适合人群

  • 后端开发者在终端快速查阅 API 定义
  • DevOps 工程师构建 API 测试流水线
  • 需要批量处理或脚本化 Postman 数据的自动化场景
  • 多账户/多 workspace 管理需求的团队

常规风险

  • 密钥暴露:environments show --json 会以明文输出敏感变量(如 API 密钥),需谨慎处理输出
  • API 限流:频繁调用 Postman API 可能触发速率限制
  • 配置持久化:Profile 配置存储于本地,共享环境需注意 .pmctl 目录权限

pmctl 内容

手动下载zip · 3.0 kB
skill-card.mdtext/markdown
请选择文件