tools-only Fetch and Filter
Fetch objects from a collection by UUID, with filters, or as a random sample. Supports complex nested filter logic (AND, OR).
Usage
uv run scripts/fetch_filter.py "CollectionName" [--id "UUID"] [--filters 'JSON'] [--limit 10] [--properties "prop1,prop2"] [--json]
Parameters
| Parameter | Flag | Required | Default | Description |
|---|---|---|---|---|
collection_name |
— | Yes (positional) | — | Collection name |
--id |
— | No | — | Fetch a specific object by UUID |
--filters |
-f |
No | — | JSON string defining filters (see filter syntax below) |
--limit |
-l |
No | 10 |
Number of objects to fetch |
--properties |
-p |
No | all | Comma-separated properties to include in output |
--json |
— | No | false |
Output in JSON format |
Modes
- Fetch by UUID: Use
--idto retrieve a specific object - Fetch with filters: Use
--filtersto retrieve filtered subsets - Fetch random sample: Omit both
--idand--filtersfor unfiltered results
Filter Syntax
Simple property filter
{"property": "category", "operator": "equal", "value": "Science"}
Logical operators (AND / OR)
{"operator": "and", "filters": [
{"property": "category", "operator": "equal", "value": "Science"},
{"property": "year", "operator": "greater_than", "value": 2020}
]}
List of filters (implicit AND)
[
{"property": "category", "operator": "equal", "value": "Science"},
{"property": "year", "operator": "greater_than", "value": 2020}
]
Supported operators
equal, not_equal, less_than, less_or_equal, greater_than, greater_or_equal, like, contains_any, contains_all, is_none
Output
- Default: Markdown table with object UUIDs and properties
- JSON: Array of objects with full metadata
Examples
Fetch by UUID:
uv run scripts/fetch_filter.py "Articles" --id "550e8400-e29b-41d4-a716-446655440000"
Filter by property:
uv run scripts/fetch_filter.py "Products" --filters '{"property": "price", "operator": "less_than", "value": 50}'
Complex filter with AND/OR:
uv run scripts/fetch_filter.py "Articles" --filters '{"operator": "or", "filters": [{"property": "category", "operator": "equal", "value": "Science"}, {"property": "category", "operator": "equal", "value": "Tech"}]}'
Select specific properties:
uv run scripts/fetch_filter.py "Products" --properties "name,price" --limit 5