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 必须传 workspace ID，无法全局搜索，必须遍历所有 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 中生成。