Firstcycling MCP

🚀 第一骑行API

これは非公式のPython APIラッパーライブラリで、firstcycling.com のデータにアクセスするために使用されます。このライブラリは、ユーザーが第一サイクリングサイト上のレース、ライダー、ランキング情報を簡単に取得して処理できるように設計されています。

🚀 クイックスタート

第一骑行APIは、非公式のPython APIラッパーライブラリで、firstcycling.com のデータにアクセスするために使用されます。このライブラリを使用することで、ユーザーは第一サイクリングサイト上のレース、ライダー、ランキング情報を簡単に取得して処理することができます。

✨ 主な機能

• レース結果の取得
• ライダーの成績データの取得
• ランキング情報の取得
• 複数年やシーズンのサポート

📦 インストール

このライブラリをインストールするには、以下のコマンドを実行してください。

pip install firstcyclingapi

💻 使用例

基本的な使用法

レース結果の取得

from firstcyclingapi import RaceResult

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

print(results.head())

ライダーの成績の取得

from firstcyclingapi import RiderPerformance

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

print(performance.head())

ランキング情報の取得

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 とは一切関係ありません。