Yahoo Fantasy Stats

If auth needed:

1. Call mcp__yahoo-fantasy__authenticate (no args) to open browser
2. Ask user to paste the code= value from the redirect URL
3. Call mcp__yahoo-fantasy__authenticate with the code
4. Retry get_leagues

0.2 League discovery

From get_leagues, identify the MLB league. If multiple, ask user which one. Save:

• league_key
• current_week (from league info)

0.3 Team list + nickname resolution

Get the raw team list:

mcp__yahoo-fantasy__get_league_teams(league_key)

Then resolve display nicknames by piping the Yahoo output through load_config.py:

echo '<yahoo_teams_json>' | python3 scripts/load_config.py --league-key <league_key>

This returns:

{
  "teams": {"469.l.103062.t.1": "子亘", ...},
  "display_order": ["子亘", "峻維", ...],
  "source": "config" | "fallback"
}

• source: "config" — the user has ~/.config/yahoo-fantasy-stats/{league_key}.json set up with custom nicknames. Use it as-is.
• source: "fallback" — no config file found. The mapping is just team_key → Yahoo team name. This works but doesn't give custom nicknames.

If source is fallback, ask the user:

沒有找到暱稱設定檔。要用 Yahoo 的 team name 繼續，還是先建一份 nickname 設定檔？

If they want to set up:

echo '<yahoo_teams_json>' | python3 scripts/load_config.py --init --league-key <league_key>

This writes a template at ~/.config/yahoo-fantasy-stats/{league_key}.json. Tell the user to edit the teams values (currently Yahoo team names) into their preferred nicknames, and adjust display_order for their preferred row ordering. Then re-run the skill.

Store the resolved teams dict and display_order — they are the canonical mapping and row order used by every subsequent phase.

Routing

Ask the user which output they want unless it's clear from the request:

• "週報" / "week N final" / "本週對戰結果" → Phase 1
• "累積" / "cumulative" / "賽季總和" → Phase 2
• "排名比較" / "rank comparison" / "強弱值" → Phase 3 (auto runs 1+2 first to get strength values)
• "全部" / "all three" → run all three sequentially

For Phase 3, you must have run Phase 1 (sum across weeks) and Phase 2 first to get the strength values per team.

Output convention

All scripts write PNG files to /tmp/yahoo-fantasy-stats/. Tell the user the absolute path when done so they can open it.

Computation rules (used across phases)

Stat categories — order matters for rendering:

• Batter (7, higher is better): R, HR, RBI, SB, BB, AVG, OPS
• Pitcher (7): W, SV, K, QS, BB, ERA, WHIP
  • Higher is better: W, SV, K, QS
  • Lower is better: BB, ERA, WHIP (BB here = walks issued)

H2H comparison between team_i and team_j for each stat:

+1 if team_i is better
-1 if team_j is better
 0 if tied

Strength score for team_i = sum over all (j ≠ i, all 14 stats) of the comparison value. Each H2H matchup contributes a number in [-14, +14]; total strength is in [-154, +154] for a 12-team league.

Sub-strengths:

• Batter strength: only sum the 7 batter cats
• Pitcher strength: only sum the 7 pitcher cats

Dependencies

Scripts use only Python stdlib + Chrome headless (already installed at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome). No pip install required.