get_player_preparation
Analyze a player's chosen moves and win rates in any opening position, using their actual game history to identify scoring weaknesses and low-variety lines for targeted preparation.
Instructions
For a given player, colour and starting position, return both the moves the player actually chose (frequency + win rate) and the underlying games. Position is specified either as a move sequence in SAN (line) or a raw FEN. Use line iteratively to walk the opening tree: call once with empty line, pick a move, call again with line extended by that move, etc. When preparing for a real game, weight recent games (last 12-24 months) more heavily than old ones, classical over-the-board > rapid/blitz > online, and look for variations the player scores poorly in (below ~40%) or plays with less variety (shallower prep).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fen | No | Alternative to `line` — raw FEN of the target position. | |
| line | No | Move sequence in SAN, space-separated, no move numbers required. Example: 'e4 e5 Nf3'. Leave empty for the starting position. | |
| color | Yes | Which colour the player is analysed with. | |
| limit | No | Number of games to return (max 10 per request; page with offset). | |
| offset | No | ||
| fide_id | Yes | FIDE ID from search_player. |