| name | postman-collection-manager |
| description | Import, export, and manage Postman collections. Use when working with Postman collections, importing OpenAPI specs, exporting collections, or when user mentions Postman import, collection management, API collections. |
| allowed-tools | Bash, Read, Write |
Postman Collection Manager
This skill manages Postman collections including import, export, and conversion operations.
Instructions
Importing Collections
Import from OpenAPI
- Use script:
scripts/openapi-to-postman.sh <openapi.json> <output-collection.json> - Converts OpenAPI spec to Postman collection format
- Use script:
Import from URL
- Use script:
scripts/import-from-url.sh <collection-url> <output.json> - Downloads and saves Postman collection
- Use script:
Exporting Collections
Export Collection
- Use script:
scripts/export-collection.sh <collection.json> <format> - Formats: json, yaml, newman-ready
- Use script:
Extract Endpoints
- Use script:
scripts/extract-endpoints.sh <collection.json> - Lists all endpoints in collection
- Use script:
Managing Collections
Merge Collections
- Use script:
scripts/merge-collections.sh <collection1.json> <collection2.json> <output.json> - Combines multiple collections
- Use script:
Filter Collection
- Use script:
scripts/filter-collection.sh <collection.json> <pattern> <output.json> - Filters requests by name or folder
- Use script:
Available Scripts
scripts/openapi-to-postman.sh- Convert OpenAPI to Postmanscripts/import-from-url.sh- Download collection from URLscripts/export-collection.sh- Export in various formatsscripts/extract-endpoints.sh- List all endpointsscripts/merge-collections.sh- Merge multiple collectionsscripts/filter-collection.sh- Filter collection requests
Examples
Example 1: Import OpenAPI
# Convert OpenAPI spec to Postman collection
./scripts/openapi-to-postman.sh api-spec.json my-api-collection.json
Example 2: Manage Collections
# Extract all endpoints
./scripts/extract-endpoints.sh my-collection.json
# Filter to only GET requests
./scripts/filter-collection.sh my-collection.json "GET" filtered.json
Requirements
- jq for JSON processing
- curl for URL imports
- openapi-to-postmanv2 npm package (for OpenAPI conversion)
Success Criteria
- ✅ Collections imported successfully
- ✅ OpenAPI conversions accurate
- ✅ Exports valid and usable
- ✅ Merged collections maintain structure