tfl

# TfL London Transit

Real-time London TfL transit data — Tube arrivals, bus predictions, line status, disruptions, journey planning, and route information. Uses TfL's single unified REST API for all modes. API key optional (free, recommended for higher rate limits).

## When to Use

- User asks about the Tube, London Underground, TfL, or London public transport
- User mentions specific Tube lines (Bakerloo, Central, Circle, District, Hammersmith & City, Jubilee, Metropolitan, Northern, Piccadilly, Victoria, Waterloo & City)
- User asks "is the Northern line running" or "when's the next Tube"
- User mentions London stations (King's Cross, Oxford Circus, Waterloo, Victoria, Paddington, etc.)
- User asks about London buses, DLR, Overground, Elizabeth line, or trams
- User asks about TfL service status, delays, disruptions, or planned closures
- User asks about Oyster, contactless, or TfL fares
- User asks about journey planning in London

## Data Sources

TfL has a **single unified REST API** (`api.tfl.gov.uk`) that returns JSON for ALL modes — Tube, bus, DLR, Overground, Elizabeth line, trams, river bus, cable car. No protobuf, no SIRI, no multiple feed formats. Just one clean REST API with consistent JSON responses.

**API key:** Register for a free `app_key` at https://api-portal.tfl.gov.uk/ — append `?app_key={KEY}` to requests. The API works without a key for basic usage but is rate-limited; with a key you get 500 requests per minute.

### Key Endpoints

| Endpoint | Description |
|----------|-------------|
| `/Line/Mode/tube/Status` | All Tube line statuses |
| `/Line/{lineId}/Status` | Specific line status |
| `/StopPoint/{naptanId}/Arrivals` | Arrivals at a stop |
| `/Line/{lineId}/Arrivals/{stopPointId}` | Arrivals filtered by line |
| `/StopPoint/Search/{query}` | Search stops by name |
| `/StopPoint?lat=&lon=&radius=` | Stops near location |
| `/Line/{lineId}/StopPoints` | Stops on a line |
| `/Line/{lineId}/Route/Sequence/{dir}` | Route stop sequence |
| `...

# TfL London Transit — OpenClaw Skill

> **Real-time London transit data for your OpenClaw agent.** Get Tube arrivals, bus predictions, line status, disruptions, journey plans, and route info for all TfL services.

[![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)
[![ClawHub](https://img.shields.io/badge/ClawdHub-Skill-green.svg)](https://clawhub.ai)

---

## Why This Skill?

**For anyone who rides TfL and wants:**
- Real-time Tube arrivals — know exactly when the next train comes
- Bus predictions — see when your bus will arrive at your stop
- Line status at a glance — check all Tube lines in one command
- Disruption alerts — know about delays, closures, and planned work
- Journey planning — step-by-step directions with fare estimates
- Stop and route lookup — find the nearest stop or explore a route's path

**How it works:**
All data comes from the [TfL Unified API](https://api.tfl.gov.uk/) — a single REST JSON API that covers Tube, bus, DLR, Overground, Elizabeth line, trams, river bus, and cable car. No protobuf, no GTFS parsing, no multiple APIs. Just clean JSON.

---

## Quick Start

### Step 1: Get an API Key (free, optional)

The TfL API works without a key (rate-limited). For 500 requests/minute:

1. Register at https://api-portal.tfl.gov.uk/
2. Create an app to get your `app_key`

### Step 2: Set Environment Variable

```bash
# Add to your shell profile or .env file:
export TFL_API_KEY=your-key-here
```

### Step 3: Install the Skill

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

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

No npm dependencies to install. No GTFS data to download. Ready to use immediately.

---

## What You Can Do

### Line Status
- Check all Tube lines at a glance — Good Service, Minor Delays, etc.
- See all TfL modes (Tube + DLR + Overground + Elizabeth...