strava-python

# Strava Python

Query your Strava activities, stats, and workout data through OpenClaw using Python and stravalib.

**Why this skill vs others:** Uses Python/stravalib with an interactive setup wizard (vs curl-based skills requiring manual JSON configuration).

## Requirements

- Python 3.7+
- `stravalib` package
- Strava API credentials (free)

## Setup

1. **Install dependencies:**
   ```bash
   pip install stravalib
   ```

2. **Run setup:**
   ```bash
   python3 setup.py
   ```

   This will:
   - Guide you through creating a Strava API app
   - Handle OAuth authentication
   - Save credentials to `~/.strava_credentials.json`

## Commands

**Recent activities:**
```bash
python3 strava_control.py recent
```

**Weekly/monthly stats:**
```bash
python3 strava_control.py stats
```

**Last activity:**
```bash
python3 strava_control.py last
```

## Examples

Ask OpenClaw:
- "Show my recent Strava activities"
- "What are my Strava stats this week?"
- "What was my last Strava workout?"

## Files

- `strava_control.py` - Main controller script
- `setup.py` - Interactive setup wizard
- `SKILL.md` - This file
- `~/.strava_credentials.json` - Credentials (auto-generated)

## Notes

- Requires Strava account (free)
- API credentials are personal and should not be shared
- Rate limits: 100 requests per 15 minutes, 1,000 daily

# Strava Python - OpenClaw Skill

Query your Strava activities, stats, and workout data through OpenClaw using Python and stravalib.

## Why This Skill?

**Compared to other Strava skills:**
- ✅ **Python-based** (not curl) - easier to extend and maintain
- ✅ **Interactive setup wizard** - no manual JSON configuration
- ✅ **User-friendly** - simple commands, clear output
- ✅ **Auto-refresh tokens** - handles OAuth automatically

## Features

- 📊 View recent activities
- 🏃 Get weekly/monthly running stats
- 🚴 Get weekly/monthly cycling stats
- ⏱️ Check your last workout

## Quick Start

### 1. Install Dependencies

```bash
pip install stravalib
```

### 2. Create Strava API App

1. Go to https://www.strava.com/settings/api
2. Click **"Create App"**
3. Fill in:
   - **Application Name:** OpenClaw Strava
   - **Category:** Tool or Analytics
   - **Website:** `http://localhost`
   - **Authorization Callback Domain:** `localhost`
4. Click **"Create"**
5. Copy your **Client ID** and **Client Secret**

### 3. Run Setup

```bash
python3 setup.py
```

Follow the prompts to authorize your app.

### 4. Test It

```bash
python3 strava_control.py recent
python3 strava_control.py stats
python3 strava_control.py last
```

## Installation for OpenClaw

1. Copy this folder to `~/.openclaw/workspace/skills/strava/` or your OpenClaw skills directory
2. Run the setup script
3. Restart OpenClaw if needed

## Usage with OpenClaw

Ask your OpenClaw assistant:
- "Show my recent Strava activities"
- "What are my Strava stats this week?"
- "What was my last workout?"

## Commands

| Command | Description |
|---------|-------------|
| `recent` | Show recent activities (default: 5) |
| `stats` | Show weekly/monthly stats for running and cycling |
| `last` | Show details of your last activity |

## Requirements

- Python 3.7+
- `stravalib` package
- Strava account (free)
- Strava API credentials (free)

## Configuration

Credentials are stored in `~/.strava_credentials.json`. This file is...