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 无任何关联。