ufret

name	ufret
description	Ufretからコード譜を取得・参照する
argument-hint	<URL or 'login' or 'list'>
allowed-tools	["Bash","Read","Write","Edit","Glob"]

Ufret コード譜取得

Ufret (www.ufret.jp) からギターコード譜を取得して .info/ref/ufret/ に保存・参照する。

コマンド

ログイン（初回 or セッション切れ時）

uv run python scripts/fetch_ufret.py login

ブラウザが開くので、ユーザーに手動ログインしてもらう。 auth state が .info/ufret_auth.json に保存される。

コード譜の取得

uv run python scripts/fetch_ufret.py fetch "https://www.ufret.jp/song.php?data=12345"

保存済み一覧

uv run python scripts/fetch_ufret.py list

引数の解釈

• $ARGUMENTS が login → ログインフロー
• $ARGUMENTS が list → 一覧表示
• $ARGUMENTS が URL を含む → fetch として処理
• $ARGUMENTS が曲名やアーティスト名 → WebSearch で Ufret の該当ページを探してから fetch

取得後の活用

コード譜を取得したら、ユーザーの学習に活かす:

1. コード進行の分析: 使われているコードを分析し、キーやコード機能を解説
2. 難しいコードの特定: ユーザーのレベル (.info/level.md) と照らし合わせ、難しそうなコードを特定
3. 練習メニューへの組み込み: /train で使う練習素材として活用
4. 理論との紐付け: コード進行パターンを理論的に解説

保存先

• .info/ref/ufret/{song_id}.md - コード譜テキスト
• .info/ref/ufret/{song_id}.json - 構造化データ（コード配列、カポ情報等）

注意

• ログインしていなくても基本的なコード譜は取得可能
• プレミアム機能（キー変更等）が必要な場合は login を案内
• 取得済みの曲は .info/ref/ufret/ から直接読む（再取得しない）