Claude Skill voor Laposta

Bouw je een app en wil je Laposta daarin integreren of maak je een koppeling met een eigen systeem en Laposta? Dan komt de Claude Skill voor Laposta goed van pas.

Met de Laposta Claude Skill kun je een AI-assistent (zoals Claude) door te chatten laten samenwerken met de API van Laposta. Je kunt jouw AI bijvoorbeeld vragen om relaties toe te voegen, campagneresultaten op te vragen of een webhook in te stellen.

De AI die onze skill gebruikt doet niet zomaar wat: voor ingrijpende acties zoals het verwijderen van gegevens of het verzenden van een campagne wordt altijd eerst om jouw expliciete bevestiging gevraagd.

Installatie

Om de skill te gebruiken, heb je een Laposta API-sleutel nodig. Deze kun je in Laposta aanmaken onder Koppelingen.

Je kunt de skill op verschillende manieren installeren, afhankelijk van hoe je Claude gebruikt:

Via Claude Code (Terminal)

Omdat de repository ook een plugin-marketplace is, kun je de skill met twee commando's installeren:

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

Let op: het /plugin -commando werkt alleen in Claude Code in de terminal, niet in de desktop-app of browser.

Handmatige installatie

Kopieer je de bestanden liever zelf? Gebruik dan Git:

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

Via Claude.ai (Browser)

Voor gebruik in de webversie van Claude, zip je de skill-map en upload je deze via de instellingen:

cd laposta-skill/plugins/laposta/skills && zip -r laposta.zip laposta

Upload het resulterende laposta.zip -bestand vervolgens onder Skills in je Claude.ai-instellingen. Zorg ervoor dat netwerktoegang is ingeschakeld, zodat de assistent api.laposta.nl  kan bereiken.

Up-to-date houden (Regenerate)

De skill kent de volledige Laposta API. De referentiebestanden (endpoints.md  en schemas.md ) worden gegenereerd vanuit dezelfde bron als de officiële API-documentatie van Laposta.

Wanneer de API verandert, kun je deze bestanden eenvoudig regenereren zodat de skill weer volledig up-to-date is. Vernieuw de specificatie in de spec/ -map en voer het volgende script uit:

python3 scripts/generate-reference.py

Dit script (vereist Python 3 en PyYAML) herschrijft de referentiebestanden en werkt de index bij, zonder handgeschreven regels aan te tasten.

Veiligheid en beperkingen

• Veiligheid: Je API-sleutel wordt nooit naar een bestand of log geschreven. Acties zoals verzenden of verwijderen vereisen altijd een extra bevestiging.
• Geen sandbox: Elke API-call voert echte acties uit in het account achter de API-sleutel. Gebruik bij voorkeur een aparte API-sleutel voor deze skill en trek deze in wanneer je hem niet meer nodig hebt.
• Licentie: Deze skill is uitgebracht onder de MIT-licentie en is een onofficiële tool, geen officiële Laposta-release.