@udondan/anton

Node.js-Paket zur Überwachung des Lernfortschritts von Kindern auf anton.app. Es kapselt die inoffizielle anton.app-API und bietet drei Schnittstellen über einen gemeinsamen Kern:

SDK — importierbare Anton-Klasse für Node.js-Projekte
CLI — anton-Befehl für das Terminal
MCP-Server — anton mcp stellt alle Funktionen als Tools für KI-Assistenten bereit
Agent Skill — bringt KI-Assistenten alle anton-Befehle bei (npx skills add udondan/anton)

Zweck: Dieses Paket dient ausschließlich dazu, den Lernfortschritt von Kindern zu verfolgen und Lektionen zu planen — als Unterstützung für Eltern und Erziehungsberechtigte. Es kann nicht dazu genutzt werden, beim Lernen zu schummeln oder Lektionen automatisiert abzuschließen. Das Paket stellt dafür keine Funktionen bereit!

Hinweis: Dieses Paket nutzt eine inoffizielle, durch Reverse Engineering ermittelte API. Endpunkte können sich jederzeit ohne Vorankündigung ändern.

Inhalt

Installation
Konfiguration
- Config-Datei (empfohlen)
- Umgebungsvariablen
SDK
CLI
- Einstieg
- Befehle
MCP-Server
Agent Skill
- Installation
- Verwendung
Lizenz

Installation

# Globale Installation (empfohlen für CLI-Nutzung)
npm install -g @udondan/anton

# Ohne Installation direkt nutzen
ANTON_LOGIN_CODE=DEIN-CODE npx @udondan/anton status

Konfiguration

Config-Datei (empfohlen)

Credentials können dauerhaft in ~/.config/anton/config gespeichert werden. Die Datei darf nicht für Gruppe oder andere lesbar sein (z.B. 0600) – auf POSIX-Systemen wird die Datei mit einer Warnung ignoriert, wenn Gruppe- oder andere-Bits gesetzt sind (chmod 0600 ~/.config/anton/config):

# ~/.config/anton/config
ANTON_LOGIN_CODE=DEIN-CODE
ANTON_GROUP=Family

Die Datei enthält KEY=VALUE-Zeilen. Zeilen, die mit # beginnen, werden als Kommentar ignoriert. Umgebungsvariablen haben Vorrang vor der Config-Datei.

# Datei anlegen und absichern
touch ~/.config/anton/config
chmod 0600 ~/.config/anton/config

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
`ANTON_LOGIN_CODE`	Ja (oder `ANTON_LOG_ID`)	Der 8-stellige Eltern-Login-Code aus der Anton-App
`ANTON_LOG_ID`	Alternative zu obigem	Interne Log-ID (z. B. `L-...`)
`ANTON_GROUP`	Nein	Wählt die Standardgruppe bei mehreren Gruppen (Groß-/Kleinschreibung egal)
`ANTON_ASSIGNMENTS_FILE`	Nein	Pfad zur Aufgaben-JSON-Datei (Standard: `~/.config/anton/assignments.json`)
`ANTON_NO_SESSION_CACHE`	Nein	Auf `1` setzen, um den CLI-Session-Cache zu deaktivieren

SDK

Agent Skill verfügbar: npx skills add udondan/anton — KI-Assistenten kennen dann alle SDK-Methoden und können beim Aufbau eigener Integrationen helfen.

Installation

npm install @udondan/anton

Schnellstart

import { Anton } from '@udondan/anton';

const anton = new Anton({ loginCode: 'DEIN-CODE' });
await anton.connect();

// Authentifizierungs- und Gruppenübersicht
console.log(anton.getStatus());

// Wochenzusammenfassung für ein Kind
console.log(await anton.getWeeklySummary({ childName: 'Emma' }));

API-Referenz

Authentifizierung

const anton = new Anton({ loginCode: 'ABCD-1234' });
// oder
const anton = new Anton({ logId: 'L-...' });

await anton.connect(); // muss vor allen anderen Methoden aufgerufen werden

Status & Gruppe

// Authentifizierungsstatus + Gruppenübersicht (kein Netzwerkaufruf)
anton.getStatus();

// Familienmitglieder + aktuell zugewiesene Blöcke
await anton.getGroup();

// Lernende auflisten
anton.listChildren();

Lektionen zuweisen

// Block per Kurs + Thema + Block zuweisen (wird intern aufgelöst)
await anton.pinBlock({
  project: 'c-mat-4',
  topicIndex: 6, // 0-basiert, aus listTopics()
  blockIndex: 1, // 0-basiert innerhalb des Themas
  weekStartAt: '2025-09-01', // Montag; Standard: aktuelle Woche
  childName: 'Emma', // weglassen = gesamte Gruppe
});

// Oder Block direkt über PUID angeben
await anton.pinBlock({
  blockPuid: 'c-mat-4/ro9ajj',
  blockPath: '/../c-mat-4/topic-07-brueche/block-02-brueche-zuordnen/block',
  weekStartAt: '2025-09-01',
});

// Zuweisung entfernen
await anton.unpinBlock({
  blockPuid: 'c-mat-4/ro9ajj',
  weekStartAt: '2025-09-01',
});

// Aktuelle Gruppenzuweisungen abrufen
await anton.getGroupAssignments({ week: '2025-09-01', childPublicId: 'P-...' });

Fortschritt & Ereignisse

// Fortschrittsübersicht (abgeschlossene Level + Sterne)
await anton.getProgress({ childName: 'Emma', since: '2025-01-01' });

// Rohes Ereignisprotokoll
await anton.getEvents({
  childName: 'Emma',
  eventType: 'finishLevel',
  limit: 50,
});

// Performance pro Level (reviewReport-API)
await anton.getLevelProgress({
  levelPuid: 'c-mat-4/abc123',
  childName: 'Emma',
});

Analysen

// Wochenrückblick: Level, Zeit, Sterne, zugewiesen vs. selbstgewählt
await anton.getWeeklySummary({ childName: 'Emma', weekStartAt: '2025-09-01' });

// Pro Fach: Trefferquote, Sterne, Zeit, Trend
await anton.getSubjectSummary({ childName: 'Emma', subject: 'mat' });

// Aktive Tage, Lernsträhnen, Lücken
await anton.getActivityTimeline({ childName: 'Emma', since: '2025-01-01' });

// Welche zugewiesenen Blöcke hat das Kind abgeschlossen?
await anton.checkAssignmentCompletion({
  childName: 'Emma',
  week: '2025-09-01',
});

// Alle Kinder im Vergleich
await anton.compareChildren();

Lernkatalog

// ~285 Kurse durchsuchen
await anton.listPlans({ subject: 'mat', grade: 4, language: 'de' });

// Themen eines Kurses (leichtgewichtig — vor getTopicBlocks verwenden)
await anton.listTopics({ project: 'c-mat-4' });

// Blöcke + Level eines einzelnen Themas
await anton.getTopicBlocks({ project: 'c-mat-4', topicIndex: 6 });
// oder per Titel:
await anton.getTopicBlocks({ project: 'c-mat-4', topicTitle: 'Brüche' });

// Vollständige Hierarchie Thema→Block→Level (groß — lieber listTopics + getTopicBlocks)
await anton.getPlan({ project: 'c-mat-4' });

// Lektionsinhalt (Aufgaben, Trainer)
await anton.getLesson({ fileId: 'level/c-mat-4/...' });

Lokale Aufgaben

Lokale Aufgaben werden in einer JSON-Datei gespeichert und sind unabhängig von der anton.app-API — nützlich für eigene Notizen und Tracking.

// Erstellen
const a = anton.assignLesson({
  childName: 'Emma',
  fileId: 'level/...',
  lessonTitle: 'Brüche 1',
});

// Auflisten
anton.listAssignments({ childName: 'Emma', status: 'pending' });

// Aktualisieren
anton.updateAssignment(a.id, {
  status: 'completed',
  note: 'Auf Anhieb geschafft!',
});

// Löschen
anton.deleteAssignment(a.id);

CLI

Agent Skill verfügbar: npx skills add udondan/anton — KI-Assistenten kennen dann alle Befehle, Flags und den vollständigen Planungsprozess und können direkt anton-Befehle ausführen.

Einstieg

export ANTON_LOGIN_CODE='DEIN-CODE'
anton status

Befehle

Statusbefehle

anton status        # Authentifizierungsinfo + Gruppenübersicht
anton group         # Familiengruppe + aktuell zugewiesene Blöcke
anton children      # Kinder auflisten

Kursbefehle

anton plans                               # alle ~285 Kurse
anton plans --subject mat --grade 4       # gefiltert nach Fach und Klasse
anton topics c-mat-4                      # Themen eines Kurses
anton blocks c-mat-4 --topic-index 6      # Blöcke eines Themas (per Index)
anton blocks c-mat-4 --topic-title Brüche # Blöcke eines Themas (per Titel)
anton plan c-mat-4                        # vollständige Hierarchie (große Ausgabe)
anton lesson level/c-mat-4/...            # Lektionsinhalt

Zuweisungsbefehle

# Zuweisung per Thema-/Block-Index
anton pin c-mat-4 --topic-index 6 --block-index 1 --child Emma --week 2025-09-01

# Zuweisung per Titelsuche
anton pin c-mat-4 --topic-title Brüche --block-title "zuordnen" --child Emma

# Aktuelle Gruppenzuweisungen anzeigen
anton pins
anton pins --week 2025-09-01 --child Emma

# Zuweisung entfernen
anton unpin c-mat-4/ro9ajj 2025-09-01

Fortschritt & Analysen

anton progress Emma                          # alle abgeschlossenen Level + Sterne
anton events Emma --type finishLevel -n 20   # rohes Ereignisprotokoll
anton level-progress c-mat-4/abc123 Emma     # Performance pro Level
anton weekly Emma                            # Zusammenfassung der aktuellen Woche
anton weekly Emma --week 2025-09-01
anton subjects Emma                          # Trefferquote + Trend pro Fach
anton subjects Emma --subject mat
anton timeline Emma                          # Lernsträhnen, aktive Tage, Lücken
anton timeline Emma --since 2025-01-01
anton completion Emma                        # Abschlussstatus zugewiesener Blöcke
anton compare                                # alle Kinder im Vergleich

Aufgabenverwaltung

anton assign Emma level/c-mat-4/... --title "Brüche 1"
anton assignments --child Emma --status pending
anton update-assignment <id> --status completed
anton delete-assignment <id>

Globale Optionen

anton --no-cache <befehl>   # Session-Cache überspringen, immer neu anmelden

MCP-Server

Der MCP-Server stellt alle 24 Tools über stdio bereit und ermöglicht KI-Assistenten wie Claude, den Lernfortschritt der Kinder zu analysieren und Lektionen automatisch zuzuweisen.

Agent Skill empfohlen: npx skills add udondan/anton — mit dem Skill verstehen KI-Assistenten alle Tool-Parameter, kennen die richtigen Abfragereihenfolgen und können eigenständig Lernpläne erstellen.

Einrichtung in Claude Code

Mit globaler Installation:

claude mcp add --env ANTON_LOGIN_CODE=DEIN-CODE anton -- anton mcp

Ohne Installation, direkt über npx:

claude mcp add --env ANTON_LOGIN_CODE=DEIN-CODE anton -- npx @udondan/anton mcp

Für eine projektweite Konfiguration (.claude/settings.json):

claude mcp add --scope project --env ANTON_LOGIN_CODE=DEIN-CODE anton -- npx @udondan/anton mcp

Einrichtung in Claude Desktop

Mit globaler Installation — in claude_desktop_config.json:

{
  "mcpServers": {
    "anton": {
      "command": "anton",
      "args": ["mcp"],
      "env": {
        "ANTON_LOGIN_CODE": "DEIN-CODE"
      }
    }
  }
}

Ohne Installation, direkt über npx:

{
  "mcpServers": {
    "anton": {
      "command": "npx",
      "args": ["@udondan/anton", "mcp"],
      "env": {
        "ANTON_LOGIN_CODE": "DEIN-CODE"
      }
    }
  }
}

Anwendungsbeispiele mit Claude

Sobald der MCP-Server eingerichtet ist, kann Claude automatisch auf alle Daten zugreifen und komplexe Aufgaben übernehmen. Hier sind einige Beispiele für Prompts:

Fortschrittsanalyse:

„Wie hat sich Emma diese Woche beim Lernen geschlagen? Welche Fächer laufen gut, wo gibt es Schwächen?"

Claude ruft dabei get_weekly_summary, get_subject_summary und get_activity_timeline ab und liefert eine zusammenhängende Auswertung — Lernzeit, Trefferquoten, Lernsträhnen und Fächer mit Verbesserungs- oder Nachholbedarf.

Automatische Lektionszuweisung basierend auf Lernhistorie:

„Schau dir an, was Emma in Mathematik diese Woche gemacht hat, und weise ihr für nächste Woche die nächsten passenden Lektionen zu."

Claude analysiert dafür:

get_weekly_summary — was wurde diese Woche bearbeitet
get_subject_summary — Stärken und Schwächen pro Fach
check_assignment_completion — wurden die zugewiesenen Blöcke abgeschlossen
list_topics + get_topic_blocks — welche Blöcke kommen als nächstes im Kurs
pin_block — die nächsten passenden Blöcke direkt zuweisen

Alle Kinder auf einmal versorgen:

„Vergleiche alle Kinder und weise jedem für nächste Woche zwei Lektionen zu, die zu seinem aktuellen Stand passen — bei Schwächen Wiederholungsstoff, sonst das nächste Thema."

Claude nutzt compare_children für den Überblick, analysiert pro Kind die Fachtrends aus get_subject_summary und die Lernhistorie aus get_events, sucht dann in list_topics + get_topic_blocks passende Folgeblöcke oder Wiederholungseinheiten heraus und weist sie per pin_block zu.

Lernrückstand erkennen:

„Hat Emma in letzter Zeit Lernlücken? Wann hat sie zuletzt Mathematik gemacht und gibt es Themen, bei denen sie viele Fehler hatte?"

Claude kombiniert get_activity_timeline (Lücken und Strähnen), get_subject_summary (Fachtrend) und get_events (Fehlerrate pro Lektion), um gezielte Hinweise zu geben.

Wöchentlichen Lernplan erstellen:

„Erstelle für Emma und Jonas je einen Lernplan für die nächsten zwei Wochen — abgestimmt auf ihre bisherigen Fortschritte und offenen Lektionen."

Claude liest für jedes Kind den bisherigen Verlauf, prüft mit check_assignment_completion offene Aufgaben, sucht mit list_topics die nächsten Lernschritte und weist sie wochenweise per pin_block zu.

Verfügbare MCP-Tools

Tool	Beschreibung
`get_status`	Authentifizierungsstatus, Gruppeninfo, konfigurierte Kinder
`list_groups`	Alle Gruppen, denen der Elternteil angehört
`get_group`	Familienmitglieder + aktuell zugewiesene Blöcke
`get_group_assignments`	Zugewiesene Blöcke, filterbar nach Kind/Woche
`pin_block`	Lektionsblock der Gruppe oder einem Kind zuweisen
`unpin_block`	Zuweisung entfernen
`list_children`	Kinder auflisten
`get_progress`	Abgeschlossene Level + Sterne für ein Kind
`get_events`	Rohes Ereignisprotokoll für ein Kind
`get_level_progress`	Performance pro Level (reviewReport-API)
`check_assignment_completion`	Welche zugewiesenen Blöcke hat ein Kind abgeschlossen
`get_weekly_summary`	Wochenrückblick: Level, Zeit, Sterne
`get_subject_summary`	Pro Fach: Trefferquote, Sterne, Zeit, Trend
`get_activity_timeline`	Aktive Tage, Lernsträhnen, Lücken
`compare_children`	Alle Kinder im Vergleich
`list_plans`	~285 Kurse nach Fach/Klasse durchsuchen
`list_topics`	Thementitel + Indizes für einen Kurs
`get_topic_blocks`	Blöcke + Level für ein einzelnes Thema
`get_plan`	Vollständige Hierarchie Thema→Block→Level
`get_lesson`	Lektionsinhalt (Aufgaben, Trainer) per fileId
`list_assignments`	Lokale Aufgabenliste
`assign_lesson`	Lokale Aufgabe erstellen
`update_assignment`	Lokale Aufgabe aktualisieren
`delete_assignment`	Lokale Aufgabe löschen

Agent Skill

Ein Skill, der KI-Assistenten beibringt, wie man alle anton-CLI-Befehle korrekt verwendet — inklusive Authentifizierung, Befehlssyntax, ID-Ermittlung und wöchentlicher Lernplanung pro Kind.

Installation

npx skills add udondan/anton

Oder global für alle Projekte:

npx skills add udondan/anton -g

Verwendung

Sobald der Skill installiert ist, verstehen KI-Assistenten Anfragen wie:

„Wie hat sich Emma diese Woche in Mathe geschlagen?"
„Weise Emma und Jonas für nächste Woche passende Lektionen zu."
„Ich bekomme einen 401-Fehler bei anton progress — wie behebe ich das?"

Der Assistent wählt automatisch die richtigen anton-Befehle, kennt alle Flags und führt bei Bedarf durch den vollständigen Planungsprozess.

Lizenz

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
.github/workflows		.github/workflows
scripts		scripts
skills/anton		skills/anton
src		src
test		test
.gitignore		.gitignore
.mcp.json		.mcp.json
.prettierrc.json		.prettierrc.json
.release-please-manifest.json		.release-please-manifest.json
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
bun.lock		bun.lock
eslint.config.js		eslint.config.js
mise.toml		mise.toml
package-lock.json		package-lock.json
package.json		package.json
release-please-config.json		release-please-config.json
renovate.json		renovate.json
tsconfig.eslint.json		tsconfig.eslint.json
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Folders and files

Latest commit

History

Repository files navigation

@udondan/anton

Inhalt

Installation

Konfiguration

Config-Datei (empfohlen)

Umgebungsvariablen

SDK

Installation

Schnellstart

API-Referenz

Authentifizierung

Status & Gruppe

Lektionen zuweisen

Fortschritt & Ereignisse

Analysen

Lernkatalog

Lokale Aufgaben

CLI

Einstieg

Befehle

Statusbefehle

Kursbefehle

Zuweisungsbefehle

Fortschritt & Analysen

Aufgabenverwaltung

Globale Optionen

MCP-Server

Einrichtung in Claude Code

Einrichtung in Claude Desktop

Anwendungsbeispiele mit Claude

Verfügbare MCP-Tools

Agent Skill

Installation

Verwendung

Lizenz

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 6

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages