Metadata-Version: 2.4
Name: dataset-scout
Version: 0.1.0
Summary: Find open climate & weather datasets for any research topic — searches across NOAA, Copernicus, NASA, ECMWF, and more.
Project-URL: Homepage, https://github.com/hardik/dataset-scout
Project-URL: Issues, https://github.com/hardik/dataset-scout/issues
Author-email: Hardik <f20240729@pilani.bits-pilani.ac.in>
License-Expression: MIT
License-File: LICENSE
Keywords: antarctic,climate,copernicus,dataset,ecmwf,era5,noaa,research,search,weather
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >=3.10
Requires-Dist: ddgs>=7.0
Requires-Dist: rich>=13.0
Provides-Extra: web
Requires-Dist: streamlit>=1.30; extra == 'web'
Description-Content-Type: text/markdown

# Dataset Scout

Find open climate & weather datasets for any research topic. Searches across NOAA, Copernicus, NASA Earthdata, ECMWF, NSIDC, PANGAEA, and more.

## Install

```bash
pip install dataset-scout
```

For the web interface:
```bash
pip install dataset-scout[web]
```

## Usage

### CLI

```bash
dataset-scout "Antarctic sea ice thickness"
dataset-scout "Indian Ocean SST reanalysis" --export results.json
dataset-scout "Arctic temperature trends" --limit 15
```

### Python API

```python
from dataset_scout import search_datasets

results = search_datasets("Antarctic blizzard frequency")
for r in results:
    print(f"{r.source} | {r.title}")
    print(f"  {r.url}")
```

### Web App (Streamlit)

```bash
dataset-scout-web
# or
streamlit run app.py
```

## What it does

1. Takes your research topic
2. Generates multiple targeted search queries (dataset download, reanalysis, open access, site-specific)
3. Searches DuckDuckGo across 12+ known climate/weather data repositories
4. Deduplicates results
5. Tags each result by type: Direct Download, Data Catalog, Documentation, Publication
6. Identifies the source repository (NOAA, ERA5, NASA, etc.)
7. Sorts known data repositories to the top

## Repositories searched

- NOAA
- Copernicus Climate Data Store (ERA5)
- NASA Earthdata
- ECMWF
- NSIDC
- PANGAEA
- Zenodo
- British Antarctic Survey
- India Meteorological Department
- Arctic Data Center
- Australian Antarctic Data Centre
- World Meteorological Organization

## License

MIT
