tools-only Explore Collection
Get statistical insights, aggregation metrics, and sample data from a collection.
Usage
uv run scripts/explore_collection.py "CollectionName" [--limit 5] [--no-metrics] [--json]
Parameters
| Parameter | Flag | Required | Default | Description |
|---|---|---|---|---|
name |
— | Yes (positional) | — | Collection name |
--limit |
-l |
No | 5 |
Number of sample objects to show |
--no-metrics |
— | No | false |
Skip calculating individual property metrics (faster) |
--json |
— | No | false |
Output in JSON format |
Metrics by Data Type
The script calculates aggregation metrics based on property data types:
| Data Type | Metrics |
|---|---|
| Text | count, top_occurrences (top 5 values with counts) |
| Int / Number | count, min, max, mean, median, mode, sum |
| Boolean | count, percentage_true, percentage_false, total_true, total_false |
| Date | count, min, max, median, mode |
Use --no-metrics to skip metric calculation for faster results when you only need sample objects.
Output
- Default: Markdown-formatted report with total count, per-property metrics tables, and sample objects
- JSON: Structured metrics and sample data
Examples
Explore with default settings:
uv run scripts/explore_collection.py "Articles"
More samples, skip metrics:
uv run scripts/explore_collection.py "Products" --limit 20 --no-metrics