Arccos Golf Performance Analyzer

Name: Arccos Golf
Author: pfrederiksen

Fetches live data from the Arccos Golf API and generates performance analysis: strokes gained, club distances, scoring, putting, pace of play, and recent rounds.

⚠️ Privacy & Security Notice

This skill makes authenticated network requests to Arccos Golf API servers using your account credentials:

Credentials: Your Arccos email and password are used to authenticate. A session token is cached at ~/.arccos_creds.json (mode 0600, readable only by your user).
Network: The script calls authentication.arccosgolf.com (login) and api.arccosgolf.com (data). No other endpoints are contacted.
No data leaves your machine beyond the API calls needed to fetch your own golf data.
External dependency: Requires the arccos library from github.com/pfrederiksen/arccos-api (MIT licensed, authored by the same user who published this skill).

Review the arccos library source before installing if you have concerns: <https://github.com/pfrederiksen/arccos-api>

Prerequisites

# 1. Install the arccos library
git clone https://github.com/pfrederiksen/arccos-api
pip install -e arccos-api/

# 2. Authenticate — opens a prompt for email + password
#    Credentials cached to ~/.arccos_creds.json (0600)
arccos login

Alternatively, pass credentials directly at runtime (see Usage below).

Usage

Full report (uses cached credentials)

python3 scripts/arccos_golf.py

Pass credentials explicitly (no cached creds required)

python3 scripts/arccos_golf.py --email [email protected] --password secret

Specific sections

python3 scripts/arccos_golf.py --summary
python3 scripts/arccos_golf.py --strokes-gained
python3 scripts/arccos_golf.py --clubs           # all clubs
python3 scripts/arccos_golf.py --clubs iron       # filter by type
python3 scripts/arccos_golf.py --pace
python3 scripts/arccos_golf.py --recent-rounds 10

JSON output

python3 scripts/arccos_golf.py --format json

Offline / no credentials (cached JSON file)

python3 scripts/arccos_golf.py --file /path/to/arccos-data.json

System Access

| Resource | Details |

|----------|---------|

| Network | authentication.arccosgolf.com — login/token refresh |

| Network | api.arccosgolf.com — rounds, handicap, clubs, stats, courses |

| File read | ~/.arccos_creds.json — cached session token (created by arccos login) |

| File read | Optional --file path for offline JSON analysis |

| File write | ~/.arccos_creds.json — updated on token refresh |

| Subprocess | None |

| Shell exec | None |

API Calls Made

| Data | Endpoint |

|------|----------|

| Rounds list | GET /users/{userId}/rounds |

| Course names | GET /courses/{courseId} |

| Handicap | GET /users/{userId}/handicaps/latest |

| Club distances | GET /v4/clubs/user/{userId}/smart-distances |

| Strokes gained | GET /v2/sga/shots/{roundIds} |

All calls are authenticated with a Bearer JWT. The JWT is obtained from and refreshed against authentication.arccosgolf.com using your arccos session credentials.

Dependencies

Python ≥ 3.11
arccos library: github.com/pfrederiksen/arccos-api (MIT) — wraps requests, click, rich
Standard library only in the analysis script itself