曲名・作曲家名のキーワードでピティナ曲事典の楽曲を検索する。

表記揺れ校正の中心ツール。手元の曖昧な曲名(例:「ブルクミュラー 25の練習曲」)を 渡すと、本家の正式タイトル・作曲家名・作品番号・演奏時間・曲IDの候補一覧を返す。

Args: keyword: 検索語(曲名/作曲家名/その断片)。 limit: 返す件数の上限(既定20)。

Returns: {"count": int, "results": [{piece_id, title, title_en, composer, composer_id, opus, duration, url}]}

楽曲IDから詳細(正式タイトル・作曲家・作品番号・解説冒頭・URL)を取得する。

search_pieces で見つけた piece_id を渡し、1曲の正式情報を確定する用途。

Args: piece_id: ピティナ曲事典の楽曲ID(URLの /musics/ の数字)。

Returns: {piece_id, title, opus, composer, composer_id, description, url}

作曲家名で検索し、本家の正式名・作曲家ID・URLの候補を返す。

作曲家名の表記揺れ校正用(例:「ブルグミュラー」→正式表記の確認)。 内部的には楽曲検索結果から作曲家をユニーク抽出する。

Args: name: 作曲家名またはその断片。 limit: 返す件数の上限(既定20)。

Returns: {"count": int, "composers": [{composer_id, name, url}]}

作曲家IDからプロフィール概要と作品リストを取得する。

Args: composer_id: ピティナ曲事典の作曲家ID(URLの /persons/ の数字)。

Returns: {composer_id, name, profile, works: [{piece_id, title, url}], url}