race-finder

Race Finder Skill 是一款专注于耐力运动赛事搜索的实用工具，依托 RunSignUp 这一全球最大的耐力赛事报名平台数据，为用户提供覆盖跑步、越野跑、铁人三项、骑行、游泳及障碍赛等多类型的赛事检索服务。通过简单的 API 调用，用户可以快速发现身边或目标城市的 upcoming races，并直接获取报名链接。

核心用法

该 Skill 通过 RESTful API 提供赛事查询服务，基础端点为 https://api.racefinder.net/api/v1/races。用户可通过多种维度精确筛选赛事：地理位置支持城市名、州代码或邮编+半径搜索；运动类型涵盖跑步、越野、铁人三项、骑行、游泳及障碍赛六大类别；距离范围从 5K 到超级马拉松（Ultra）均可指定；时间范围支持起始和结束日期限定。API 无需认证即可使用，返回结果包含赛事名称、日期、起止时间、具体距离（英里/公里）、报名费用、赛事海报及直接注册链接等完整信息。

显著优点

首先，数据源权威全面，RunSignUp 作为北美最大的耐力赛事报名平台，拥有超过 30,000 场活跃赛事数据，确保信息的准确性和时效性。其次，搜索维度极为灵活，支持地理半径搜索（如邮编 25 英里范围内）、多距离组合查询（如同一场赛事可能同时包含全程和半程马拉松），以及跨运动类型的综合检索。第三，即搜即用的报名链路设计，API 直接返回 register_url，用户无需二次跳转即可直达报名页面，极大提升了转化效率。此外，国际化支持覆盖美国及加拿大等市场，且完全开放的 API 策略免去了繁琐的密钥申请流程。

潜在缺点与局限性

需要注意的是，该 Skill 的数据覆盖范围受限于 RunSignUp 平台的合作赛事，对于使用其他报名系统（如 Eventbrite、Active.com 或本地小众平台）的赛事可能无法收录，存在数据盲区。其次，虽然支持国际查询，但数据丰富度明显偏向北美市场，其他地区的赛事收录可能不够全面。另外，作为 T3 来源的个人开发者项目，长期维护稳定性和 API 服务的持续性存在一定不确定性。技术层面，当前 API 仅支持读取操作，无法提供报名状态实时同步或个性化推荐等高级功能。

适合的目标群体

该工具特别适合马拉松及路跑爱好者规划赛季赛事、铁人三项运动员寻找认证比赛、越野跑和障碍赛参与者发现挑战活动，以及骑行爱好者寻找 organized rides。对于旅行跑步（racecation）爱好者，可通过目的地+日期组合提前规划跑步旅行。赛事教练和跑团组织者也可利用此工具为学员或团员批量筛选合适的比赛。

使用风险

主要风险在于对外部 API 服务（racefinder.net）的依赖性，若该服务出现宕机或数据更新延迟，将直接影响查询结果的可用性。由于是个人开发者维护的项目（T3 来源），存在因维护者精力有限导致文档更新滞后或服务中断的潜在风险。此外，虽然 API 本身无需认证且不收集用户隐私数据，但用户在通过注册链接跳转至 RunSignUp 等第三方平台时，需注意这些平台的隐私政策和个人数据保护条款。建议用户将查询结果作为参考，重要赛事信息应通过官方渠道二次确认。