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.

Security Scan

The skill is an instruction-only wrapper for a public race-search API and its requirements and instructions are consistent with that purpose.

Purpose & Capability

Name/description (find upcoming races) match the SKILL.md and README which document a public HTTP API (https://api.racefinder.net). No unrelated credentials, binaries, or platform access are requested. The README and docs reference racefinder.net and RunSignUp as data sources; while the publisher identity/homepage is missing, that is a transparency issue rather than an incoherence with the stated capability.

Instruction Scope

SKILL.md only documents GET requests to a public API and provides curl examples. It does not instruct the agent to read local files, access system credentials, or exfiltrate data to unexpected endpoints. It will send user query parameters to the documented external API (expected behavior).

Install Mechanism

There is no install spec and no code files; this is instruction-only documentation. No archives, third-party packages, or downloads are specified, which minimizes installation risk.

Credentials

The skill declares no required environment variables, credentials, or config paths. The documented API is public and explicitly 'No authentication required,' so there is no disproportionate secret access requested.

Persistence & Privilege

The skill does not request always:true and is user-invocable. It does not modify other skills or system configuration in the documentation. Autonomous invocation is allowed by platform default but the skill itself does not request elevated persistence.

Assessment

This skill is a documentation-only wrapper for a public race-search API and appears internally consistent. Things to consider before installing: 1) The skill will make outbound HTTPS requests to api.racefinder.net when used — if you have privacy concerns, avoid sending sensitive location or personally identifying data. 2) The package has no published homepage or verified publisher metadata in the registry; if you want higher assurance, verify the domain (racefinder.net), check the referenced GitHub repo (nftechie) and confirm the API is legitimate. 3) Registration links may redirect to third-party sites (e.g., runsignup); verify those links before submitting payment or personal information. Otherwise, no credentials or local file access are requested and the skill's behavior matches its description.

Race 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

{
  "races": [
    {
      "id": "12345",
      "name": "Austin Marathon",
      "date": "2026-03-15",
      "start_time": "7:00 AM",
      "sport": "running",
      "city": "Austin",
      "region": "Texas",
      "country": "US",
      "distances": [
        {"name": "Marathon", "miles": 26.2, "km": 42.2, "category": "marathon"},
        {"name": "Half Marathon", "miles": 13.1, "km": 21.1, "category": "half-marathon"}
      ],
      "prices": [
        {"name": "Marathon — $120", "price": 120, "currency": "USD", "available": true}
      ],
      "image_url": "https://...",
      "details_url": "https://racefinder.net/race/12345",
      "register_url": "https://runsignup.com/Race/12345?rsu_aff=..."
    }
  ],
  "page": 1,
  "total_results": 20
}

No authentication required.

Examples

Find races in a city

curl "https://api.racefinder.net/api/v1/races?city=Austin&state=TX"

Find marathons near a zipcode

curl "https://api.racefinder.net/api/v1/races?zipcode=78701&radius=50&distance=marathon"

Find trail races in Colorado this summer

curl "https://api.racefinder.net/api/v1/races?state=CO&sport=trail&start_date=2026-06-01&end_date=2026-08-31"

Search by race name

curl "https://api.racefinder.net/api/v1/races?q=Ironman"

Find 5Ks in California

curl "https://api.racefinder.net/api/v1/races?state=CA&sport=running&distance=5k"

Tips for Agents

• Use details_url when users want to learn more about a race — it links to the full race page on racefinder.net
• Use register_url when users are ready to sign up — it links directly to registration
• Default search returns races starting from today, sorted by date
• Combine zipcode + radius for location-based search (US only)
• Combine sport + distance to narrow results (e.g., sport=running&distance=half-marathon)
• The total_results field shows how many results were returned on this page; use page to paginate