STAC Universal Search

Search any SpatioTemporal Asset Catalog (STAC) endpoint for geospatial data.

Features

• Pre-configured endpoints: Planetary Computer, AWS Earth Search, Element84, Google Earth Engine
• Custom endpoint support
• Collection, bbox, date range, cloud cover filters
• Text table or JSON output
• Asset listing and collection info

Usage

# Search with preset
python stac-search.py --preset planetary-computer --collection sentinel-2-l2a --bbox 120 30 121 31

# Search custom endpoint
python stac-search.py --endpoint https://earth-search.aws.element84.com/v1 --collection sentinel-2-l2a --limit 5

# List collections
python stac-search.py --list-collections --preset aws-earth-search

# Get collection info
python stac-search.py --collection-info sentinel-2-l2a --preset planetary-computer

# With filters
python stac-search.py --preset planetary-computer --collection landsat-c2-l2 --bbox -122.5 37.5 -122.0 38.0 --datetime 2024-01-01/2024-06-30 --max-cloud-cover 20 --limit 5

# JSON output
python stac-search.py --preset planetary-computer --collection sentinel-2-l2a --json

# List assets
python stac-search.py --preset planetary-computer --collection sentinel-2-l2a --list-assets

Arguments

Argument	Description
--preset	Use a preset: planetary-computer, aws-earth-search, element84, gee
--endpoint	Custom STAC endpoint URL
--collection	Collection ID(s) to search
--bbox	Bounding box: minx miny maxx maxy
--datetime	Date range: 2024-01-01/2024-12-31
--max-cloud-cover	Max cloud cover %
--limit	Max results (default: 10)
--json	Output as JSON
--verbose	Show asset details
--list-assets	List assets for first result
--list-collections	List available collections
--collection-info	Get info for a collection

Installation

pip install requests

---

中文说明

通用 STAC 搜索工具，支持在任何 STAC 端点搜索地理空间数据。

特性

• 预配置端点：Planetary Computer、AWS Earth Search、Element84、Google Earth Engine
• 自定义端点：支持任意 STAC API
• 过滤条件：集合、边界框、日期范围、云量
• 输出格式：文本表格或 JSON

使用方法

# 使用预设搜索
python stac-search.py --preset planetary-computer --collection sentinel-2-l2a --bbox 120 30 121 31

# 搜索自定义端点
python stac-search.py --endpoint https://earth-search.aws.element84.com/v1 --collection sentinel-2-l2a --limit 5

# 列出所有集合
python stac-search.py --list-collections --preset aws-earth-search

# 获取集合信息
python stac-search.py --collection-info sentinel-2-l2a --preset planetary-computer

# 带过滤条件
python stac-search.py --preset planetary-computer --collection landsat-c2-l2 --bbox -122.5 37.5 -122.0 38.0 --datetime 2024-01-01/2024-06-30 --max-cloud-cover 20 --limit 5

# JSON 输出
python stac-search.py --preset planetary-computer --collection sentinel-2-l2a --json

# 列出资产
python stac-search.py --preset planetary-computer --collection sentinel-2-l2a --list-assets