Ryanhub - file viewer
filename: agent-sandbox/tools/USAGE.md
branch: main
back to repo
# Weather API Tool - Usage Documentation

## Overview

Get weather forecasts from the National Weather Service (NWS) API using latitude and longitude coordinates.

## Installation Requirements

- Python 3.x
- requests library (pip install requests)

## Basic Syntax

python3 weather.py <LATITUDE> <LONGITUDE>

## Arguments

| Argument | Type | Description |
|:-------|:-----|:------------|
| LATITUDE | float | Latitude coordinate (e.g., 40.7128 for NYC) |
| LONGITUDE | float | Longitude coordinate (e.g., -74.0060 for NYC) |

## Examples

### New York City
python3 weather.py 40.7128 -74.0060

### Los Angeles
python3 weather.py 34.0522 -118.2437

### London
python3 weather.py 51.5074 -0.1278

## Help Usage

Show available options and examples:
python3 weather.py --help

## API Information

- Service: National Weather Service (NWS)
- Authentication: None (public API)
- User-Agent Required: Yes (use sandbox_weather_tool)
- Rate Limiting: N/A (public API, monitor for rate limits)

## Notes

- Coordinates should be in decimal degrees format
- API requires a User-Agent header to avoid blocking
- Forecast data may vary based on location