Firstcycling MCP

🚀 第一騎行API

這是一個非官方的Python API封裝庫，用於訪問 firstcycling.com 的數據。藉助該庫，用戶能夠輕鬆獲取和處理第一騎行網站上的比賽、車手和排名信息。

🚀 快速開始

這是一個非官方的Python API封裝庫，用於訪問 firstcycling.com 的數據。該庫旨在幫助用戶輕鬆獲取和處理第一騎行網站上的比賽、車手和排名信息。

✨ 主要特性

• 獲取比賽結果
• 獲取車手錶現數據
• 獲取排名信息
• 支持多個年份和賽季

📦 安裝指南

要安裝此庫，請運行以下命令：

pip install firstcyclingapi

💻 使用示例

基礎用法

比賽結果示例

以下是一個如何使用 API 獲取比賽結果的示例：

from firstcyclingapi import RaceResult

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

print(results.head())

車手錶現示例

以下是一個如何使用 API 獲取車手錶現的示例：

from firstcyclingapi import RiderPerformance

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

print(performance.head())

排名頁面示例

以下是一個如何使用 API 獲取排名信息的示例：

from firstcyclingapi import RankingPage

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

print(rankings.head())

📚 詳細文檔

歡迎貢獻！請隨時提交問題、拉取請求或討論。

特別需要幫助的地方包括：

• 添加更多端點（例如：https://firstcycling.com/team.php?）
• 解析更多頁面的結果（例如：比賽名單，比賽統計）

要運行測試，請先安裝 pytest 和 vcrpy。然後在根目錄下運行 python -m pytest。

📄 許可證

見 LICENSE 文件。此項目與 firstcycling.com 無任何關聯。