Zur Navigation springen

Den Laposta-Skill für Ihren KI-Assistenten installieren

Ein Skill ist ein Ordner mit Anweisungen für Ihren KI-Assistenten. Der Laposta-Skill umfasst die vollständige API: alle Endpunkte, Pflichtfelder, Fehlercodes und häufig gemachte Fehler. Sie müssen also nichts erklären, bevor Sie eine Anfrage stellen.

Der Skill ist kostenlos, Open Source und steht unter github.com/laposta/laposta-skill zur Verfügung. Die Endpunkt-Referenz im Skill wird aus derselben Quelle generiert wie diese Dokumentation. Wenn sich die API ändert, wird ein einziges Skript ausgeführt und der Skill ist wieder auf dem aktuellen Stand.

Beispiele für Befehle

Sie können alles, was die API kann, in normaler Sprache ausführen. Hier sind einige Beispiele für Befehle, die Sie direkt verwenden können:

  • „Wie viele aktive Abonnenten gibt es in jeder meiner Listen?“
  • „Trage diese zwölf E-Mail-Adressen in die Newsletter-Liste ein, mit dem Vornamen im richtigen Feld.“
  • „Wer hat sich letzten Monat abgemeldet?“
  • „Erstelle eine Kampagne aus dieser HTML-Datei und schicke mir eine Test-E-Mail.“
  • „Vergleiche die Öffnungs- und Klickrate meiner letzten fünf Kampagnen.“

Wenn Sie nach einem Endpunkt fragen, schlägt der Skill die Antwort in seiner eigenen Referenz nach, anstatt sie aus seinem Gedächtnis abzurufen.

In Claude Code installieren

Das Repository dient auch als Plugin-Katalog. Führen Sie diese beiden Zeilen aus:

/plugin marketplace add laposta/laposta-skill
/plugin install laposta@laposta-skill

Wählen Sie anschließend aus, wo der Skill abgelegt werden soll: für Sie persönlich, für ein einzelnes Projekt oder nur lokal. Updates können Sie später mit /plugin marketplace update laposta-skill abrufen.

Wenn Sie die Nachricht erhalten, dass /plugin nicht verfügbar ist, liegt das nicht am Skill. Diese Slash-Befehle funktionieren nur in Claude Code im Terminal, nicht in der Desktop-App oder im Browser. Verwenden Sie dort diese regulären Befehle:

claude plugin marketplace add laposta/laposta-skill
claude plugin install laposta@laposta-skill

Wenn Sie die Dateien lieber selbst ablegen möchten, kopieren Sie den Ordner laposta in Ihren persönlichen Skills-Ordner. Claude Code erkennt den Ordner sofort, ohne dass Sie das Programm neu starten müssen.

Handmatig installeren
git clone https://github.com/laposta/laposta-skill.git
mkdir -p ~/.claude/skills
cp -r laposta-skill/plugins/laposta/skills/laposta ~/.claude/skills/

Auf claude.ai installieren

Auf claude.ai gibt es keinen Katalog, daher können Sie dort eine ZIP-Datei hochladen. Achten Sie darauf, dass der Ordner laposta die oberste Ebene in der ZIP-Datei bildet, da er sonst nicht erkannt wird.

Het zipbestand maken
cd laposta-skill/plugins/laposta/skills && zip -r laposta.zip laposta

Laden Sie diese Datei in Ihren Einstellungen unter „Skills“ hoch.

Auf claude.ai muss der Netzwerkzugriff aktiviert sein, da der Assistent sonst api.laposta.nl nicht erreichen kann. Ob Sie diesen selbst aktivieren können, hängt von Ihren eigenen Einstellungen und den Vorgaben Ihres Administrators ab. Über die API von Claude funktioniert der Skill zwar grundsätzlich, kann aber api.laposta.nl nicht erreichen, da diese Umgebung keine Internetverbindung hat.

In anderen Assistenten installieren

Der Skill verwendet ausschließlich die Felder aus dem „Agent Skills“-Standard. Derselbe Ordner funktioniert daher in jedem Programm, das diesen Standard unterstützt, wie Gemini CLI, GitHub Copilot, Codex und Cursor. Wo sich der Skills-Ordner befindet, ist je nach Programm unterschiedlich. Sie finden diese Information in der Dokumentation des jeweiligen Programms.

Ihren API-Schlüssel übergeben

Der Skill fragt im Gespräch nicht nach Ihrem Schlüssel, sondern liest ihn aus der Umgebungsvariable LAPOSTA_API_KEY aus. Richten Sie diese wie folgt ein:

export LAPOSTA_API_KEY="ihr-schluessel"

Wie Sie einen Schlüssel erhalten, erfahren Sie unter API-Schlüssel erstellen. Erstellen Sie hierfür einen separaten Schlüssel. Warum das wichtig ist, wird unter KI-Assistenten verbinden erläutert.

Sicher arbeiten mit dem Skill

Die Sicherheitsregeln sind direkt im Skill integriert, sodass Sie sich darum nicht kümmern müssen.

SituationWas passiert
Etwas nachschlagenGeschieht sofort, ohne Rückfrage
Löschen, leeren, einplanen, versendenSie erhalten zunächst eine Bestätigungsfrage, in der auch die Anzahl der Abonnenten genannt wird
Viele Abonnenten gleichzeitig ändernAuch hier erfolgt zuerst eine Rückfrage, selbst wenn es sich um eine Reihe normaler Aufrufe handelt
Eine Kampagne versendenImmer zuerst eine Test-E-Mail
„Nimm jemanden von der Liste“Fragt nach, ob Sie abmelden oder löschen meinen, da dies nicht dasselbe ist
Ihr SchlüsselWird niemals angezeigt, gespeichert oder in einen Befehl eingefügt

Verwandte Artikel