usgs-data-download

Retrieve USGS NWIS streamflow and gage height data as pandas DataFrames.

317|40|Updated Jan 21, 2025
One-click install
npx skills add https://github.com/benchflow-ai/benchflow --skill usgs-data-download-benchflow-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usgs-data-download
Source: https://github.com/benchflow-ai/benchflow/tree/main/tests/fixtures/skillsbench_slice/flood-risk-analysis/environment/skills/usgs-data-download
Command: npx skills add https://github.com/benchflow-ai/benchflow --skill usgs-data-download-benchflow-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dataretrieval.

What problem does it solve?

This skill solves the complexity of interacting with the USGS National Water Information System (NWIS) API, allowing users to programmatically fetch streamflow and gage height data without manual web scraping.

Core Features & Use Cases

  • Automated Data Retrieval: Fetch instantaneous (15-minute) or daily water level and discharge measurements for specific USGS station IDs.
  • Metadata Access: Easily retrieve site information and statistical summaries for hydrological monitoring.
  • Use Case: A researcher needs to analyze historical flood risks for a specific river basin; this skill automates the batch download of multi-year gage height data across multiple stations into a clean, ready-to-analyze format.

Quick Start

Use the usgs-data-download skill to fetch the last 30 days of instantaneous gage height data for station ID 04119000.

Frequently Asked Questions about usgs-data-download

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download USGS streamflow data for a specific station ID?

To download USGS streamflow data, this skill uses the dataretrieval library to fetch instantaneous or daily discharge and gage height measurements from the NWIS API for specific station IDs, returning structured pandas DataFrames ready for analysis.

Can I retrieve historical water level data for multiple stations in batch?

Yes, you can batch download historical water level data across multiple USGS stations. The skill automates multi-year gage height collection via the dataretrieval package, providing clean, ready-to-analyze formats for environmental monitoring and flood risk analysis.

Does the dataretrieval Python package support accessing USGS site metadata?

Yes, the dataretrieval Python package supports accessing USGS site metadata. The skill facilitates retrieving site information and statistical summaries from the NWIS API alongside streamflow and gage height measurements for hydrological monitoring.

What's the best way to get instantaneous 15-minute gage height data from NWIS?

The best way to get instantaneous 15-minute gage height data from NWIS is using this skill, which leverages the dataretrieval library to programmatically fetch measurements for specific station IDs without manual web scraping, outputting structured pandas DataFrames.

Do I need the dataretrieval library to fetch NWIS hydrological data?

Yes, you need the dataretrieval library installed to fetch NWIS hydrological data. This skill depends on the dataretrieval package to handle API requests to the USGS National Water Information System and return structured pandas DataFrames.