gas-price-alert

# Gas Price Alert

## Overview

Automatically search for the cheapest gas prices in your area, with a focus on Costco and other discount stations. Get daily notifications with the best options within a specified radius.

## Quick Start

1. **Configure location** - Set your city/coordinates and search radius
2. **Run search** - Find gas stations and estimated prices
3. **Schedule daily alerts** - Get morning notifications with cheapest options
4. **Focus on Costco** - Costco typically has gas $0.15-0.25 below market average

## Workflow

### Step 1: Configure Your Location

**Option A: Use ZIP code (recommended)**

```bash
# Search by ZIP code
python3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --summary
```

**Option B: Use coordinates**

Default locations are pre-configured for Columbus, Ohio:

```bash
# Columbus, OH (downtown)
lat: 39.9612
lon: -82.9988
radius: 20 miles
```

To use a different location:

```bash
python3 scripts/gas_alternative.py --lat <latitude> --lon <longitude> --radius <miles>
```

**Common US cities:**
- Columbus, OH: 39.9612, -82.9988
- Chicago, IL: 41.8781, -87.6298
- New York, NY: 40.7128, -74.0060
- Los Angeles, CA: 34.0522, -118.2437
- Miami, FL: 25.7617, -80.1918

### Step 2: Search for Gas Stations

```bash
# Search with summary output
python3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --summary

# Save to file
python3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --output gas_prices.json
```

**Parameters:**
- `--zip`: ZIP code (overrides lat/lon, e.g., `--zip 43215`)
- `--lat`: Latitude (default: 39.9612 - Columbus, OH)
- `--lon`: Longitude (default: -82.9988 - Columbus, OH)
- `--radius`: Search radius in miles (default: 20)
- `--fuel`: Fuel type - 87, 89, 91, diesel (default: 87)
- `--base-price`: Base price for estimation (default: 2.89)
- `--output`: Output file (default: gas_prices.json)
- `--summary`: Print human-readable summary to stdout

### S...

# Gas Price Alert / Alerta de Preço de Combustível

**⛽ Find cheapest gas prices with daily notifications / Encontre os preços mais baratos de combustível com alertas diários**

This OpenClaw skill helps you find and monitor gas prices, with special focus on Costco and other discount stations.

Este skill do OpenClaw ajuda você a encontrar e monitorar preços de combustível, com foco especial em Costco e outros postos com desconto.

## Features / Funcionalidades

- 🔍 **ZIP code search** - Search by any US ZIP code / Busca por qualquer CEP dos EUA
- 💰 **Best price detection** - Shows cheapest options first / Mostra opções mais baratas primeiro
- 📏 **Configurable radius** - Set your preferred search range / Defina o raio de busca preferido
- 🏠 **Costco support** - Special tracking of Costco locations / Rastreamento especial de locais da Costco
- ⏰ **Daily alerts** - Schedule automated notifications / Agende notificações automatizadas
- 🌍 **Works anywhere** - Supports any US location / Funciona em qualquer lugar dos EUA

## Quick Start / Início Rápido

### English

```bash
# Search by ZIP code
python3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --summary

# Save to file
python3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --output gas_prices.json
```

### Português

```bash
# Buscar por CEP
python3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --summary

# Salvar em arquivo
python3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --output gas_prices.json
```

## Installation / Instalação

1. **Clone this repository / Clone este repositório:**

```bash
git clone https://github.com/GustavoZiaugra/gas-price-alert-skill.git
cd gas-price-alert-skill
```

2. **Install dependencies / Instale dependências:**

```bash
pip install requests geopy
```

3. **Load skill into OpenClaw / Carregar skill no OpenClaw:**
   - Open OpenClaw Control UI
   - Go to Skills → Import Skill
   - Select this directory

## Usage Exam...