Firstcycling MCP

🚀 First Cycling API

An unofficial Python API wrapper for accessing data from firstcycling.com, designed to help users easily retrieve and process race, rider, and ranking information.

🚀 Quick Start

This is an unofficial Python API wrapper for accessing data from firstcycling.com. The library is designed to help users easily retrieve and process race, rider, and ranking information from the First Cycling website.

📦 Installation

To install this library, run the following command:

pip install firstcyclingapi

💻 Usage Examples

Basic Usage

Race Results Example

Here is an example of how to use the API to get race results:

from firstcyclingapi import RaceResult

race = RaceResult(race_id=123, y=2023)
results = race.get_results()

print(results.head())

Rider Performance Example

Here is an example of how to use the API to get rider performance:

from firstcyclingapi import RiderPerformance

rider = RiderPerformance(rider_id=567, y=2023)
performance = rider.get_performance()

print(performance.head())

Ranking Page Example

Here is an example of how to use the API to get ranking information:

from firstcyclingapi import RankingPage

ranking = RankingPage(rank_type='general', y=2023, page=1)
rankings = ranking.get_ranking()

print(rankings.head())

✨ Features

• Retrieve race results
• Obtain rider performance data
• Get ranking information
• Support multiple years and seasons

🤝 Contribution

Contributions are welcome! Please feel free to submit issues, pull requests, or discussions.

Areas that particularly need help include:

• Adding more endpoints (e.g., https://firstcycling.com/team.php?)
• Parsing results from more pages (e.g., race lists, race statistics)

To run the tests, first install pytest and vcrpy. Then run python -m pytest in the root directory.

📄 License

See the LICENSE file. This project is not affiliated with firstcycling.com.