capmetro-skill

# CapMetro Austin Transit

Real-time Austin CapMetro transit data - vehicle positions, next arrivals, service alerts, and route information. No API key required.

## When to Use

- User asks about Austin bus or train schedules, arrival times, or delays
- User asks "when is the next bus/train" or "is the 801 running"
- User asks about CapMetro service alerts, detours, or disruptions
- User wants to know where a bus/train currently is
- User asks about nearby stops or route information
- User mentions MetroRail (Red Line), MetroRapid (801/803), or any Austin bus route
- User asks about CapMetro fares, how to ride, or general transit info

## Data Sources

All feeds are **open access, no API key required**, hosted on the Texas Open Data Portal.

### GTFS-RT (Real-Time) Feeds - Updated every 15 seconds

| Feed | Format | URL |
|------|--------|-----|
| Vehicle Positions | JSON | `https://data.texas.gov/download/cuc7-ywmd/text%2Fplain` |
| Vehicle Positions | Protobuf | `https://data.texas.gov/download/eiei-9rpf/application%2Foctet-stream` |
| Trip Updates | Protobuf | `https://data.texas.gov/download/rmk2-acnw/application%2Foctet-stream` |
| Service Alerts | Protobuf | `https://data.texas.gov/download/nusn-7fcn/application%2Foctet-stream` |

### GTFS Static Feed - Route/Stop/Schedule data

| Feed | Format | URL |
|------|--------|-----|
| GTFS Static (zip) | ZIP | `https://data.texas.gov/download/r4v4-vz24/application%2Fx-zip-compressed` |

## Implementation

### Quick Start: Use the helper scripts

The scripts in this skill's `scripts/` directory handle fetching, parsing, and presenting CapMetro data.

### Script: `scripts/capmetro.mjs`

Main entry point. Supports these commands:

```bash
# Get current service alerts
node scripts/capmetro.mjs alerts

# Get real-time vehicle positions (optionally filter by route)
node scripts/capmetro.mjs vehicles [--route 801]

# Get next arrivals at a stop (by stop_id)
node scripts/capmetro.mjs arrivals --stop <stop_id>

# Get arrival...

# :bus: CapMetro Austin Transit — OpenClaw Skill

> **Real-time Austin public transit data for your OpenClaw agent.** Get vehicle positions, next arrivals, service alerts, and route info for MetroBus, MetroRapid, and MetroRail.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Node.js 18+](https://img.shields.io/badge/node-18%2B-green.svg)](https://nodejs.org)
[![ClawdHub](https://img.shields.io/badge/ClawdHub-Skill-green.svg)](https://clawhub.ai)

---

## Why This Skill?

**For anyone who rides CapMetro and wants:**
- Real-time arrival predictions — no more guessing when the bus comes
- Live vehicle tracking — see exactly where your bus or train is
- Service alerts — know about detours and disruptions before you leave
- Stop and route lookup — find the nearest stop or explore a route's path
- Zero setup friction — no API keys, no accounts, no credentials

**How it works:**
All data comes from the [Texas Open Data Portal](https://data.texas.gov), which publishes CapMetro's GTFS and GTFS-RT feeds as open-access public data. This skill fetches, parses, and presents that data — updated every 15 seconds.

---

## Quick Start (2 Minutes)

### Step 1: Install the Skill

```bash
# Copy to your skills directory
cp -r capmetro-skill ~/.openclaw/skills/capmetro

# Or for a workspace-specific install:
cp -r capmetro-skill <workspace>/skills/capmetro
```

### Step 2: Install Dependencies

```bash
cd ~/.openclaw/skills/capmetro && npm install
```

### Step 3: Download Transit Data

```bash
# One-time download of routes, stops, and schedules
node scripts/capmetro.mjs refresh-gtfs

# You're ready! 🎉
```

No API keys. No accounts. No environment variables. Just install and go.

---

## What You Can Do

### :clock3: Real-Time Arrivals
- See when the next bus or train arrives at any stop
- Filter by route or direction (headsign)
- Search for stops by name instead of memorizing IDs
- Falls back to scheduled times when real-time data is unavailable

###...