Arccos Golf Performance Analyzer

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 you@example.com --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