postman-explore skill
探索 Postman collection 结构，避免一次性拉取全量数据导致响应过大。
调用方式
/postman-explore [collection 名称]
示例：
/postman-explore shopman/postman-explore（不传名称则列出所有 collection）
执行步骤
1. 获取所有 Workspace
调用 getWorkspaces，拿到所有 workspace 的 ID 和名称。
2. 并行搜索 Collection
对每个 workspace 并行调用 getCollections：
- 若用户传了名称，加上
name参数过滤 - 若未传名称，列出所有 collection 供用户选择
注意：
getCollections必须传workspaceID，无法全局搜索，必须遍历所有 workspace。
3. 获取 Collection 结构（轻量模式）
找到目标 collection 后，调用 getCollection：
- 不传
model参数（默认返回轻量结构图：metadata + 递归 itemRefs） - 绝对不要用
model=full，会返回完整 JSON（可能 60KB+），超出工具结果显示限制
collectionId 格式必须为 {ownerId}-{uuid}，从 getCollections 返回的 uid 字段取。
4. 展示结构，按需深入
将 folder / request 树状结构展示给用户，询问是否需要查看某个请求的详情。
如需查看详情，再调用：
getCollectionRequest：查看单个请求的 method、URL、headers、body 等getCollectionFolder：查看 folder 下的子项目
工具对照
| 目标 | 工具 | 关键参数 |
|---|---|---|
| 列出所有 workspace | getWorkspaces | 无必填 |
| 搜索 collection | getCollections | workspace（必填）, name（可选） |
| 查看 collection 结构 | getCollection | collectionId，不传 model |
| 查看单个请求详情 | getCollectionRequest | collectionId, requestId |
| 查看 folder 详情 | getCollectionFolder | collectionId, folderId |
MCP 配置前提
使用本 skill 前需先配置 Postman MCP：
claude mcp add --transport http postman https://mcp.postman.com/mcp \
--header "Authorization: Bearer <YOUR_POSTMAN_API_KEY>"
API Key 在 Postman → 右上角头像 → Settings → API keys 中生成。