race-finder
Find upcoming races — running, trail, triathlon, cycling, swimming, and obstacle courses. Search by location, distance, sport, and date. Returns race details with registration links.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/nftechie/race-finderRace Finder Skill
Search for upcoming races across the US and internationally. Data sourced from RunSignUp, the largest endurance event registration platform.
API
Base URL: https://api.racefinder.net
Search Races
GET /api/v1/races
All parameters are optional. Returns upcoming races sorted by date.
Query Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
q | string | Search by race name | q=Austin Marathon |
city | string | City name | city=Austin |
state | string | US state code | state=TX |
country | string | Two-letter country code (default: US) | country=CA |
sport | string | Sport type (see below) | sport=running |
distance | string | Distance category (see below) | distance=marathon |
start_date | string | Races on or after this date (YYYY-MM-DD, default: today) | start_date=2026-06-01 |
end_date | string | Races on or before this date (YYYY-MM-DD) | end_date=2026-12-31 |
zipcode | string | US zipcode (requires radius) | zipcode=78701 |
radius | string | Miles from zipcode | radius=25 |
page | int | Page number (default: 1) | page=2 |
per_page | int | Results per page (default: 20, max: 50) | per_page=10 |
Sport Values
| Value | Description |
|---|---|
running | Road running races |
trail | Trail running & ultras |
triathlon | Triathlons & duathlons |
cycling | Bike races & rides |
swimming | Swimming & open water |
obstacle | Obstacle courses & mud runs |
Distance Values
| Value | Range |
|---|---|
5k | ~2–4 miles |
10k | ~5–8 miles |
half-marathon | ~12–15 miles |
marathon | ~25–28 miles |
ultra | 30+ miles |
Response Format
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-nftechie-race-finder": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
apple-health-skill
Talk to your Apple Health data — ask questions about your workouts, heart rate, activity rings, and fitness trends using AI.
transition-mcp
AI-powered multisport coaching — get personalized workouts, training plans, and performance analytics for running, cycling, swimming, and triathlon.
garmin-skill
Talk to your Garmin data — ask questions about your activities, training load, VO2 Max, heart rate zones, and more using AI.
strava-skill
Talk to your Strava data — ask questions about your activities, fitness trends, PRs, and training load using AI.