Ghost Smart-Home-Integration, kostenlos und Open Source

Mitglieder, Beiträge und Newsletter deines Ghost-Blogs in Gladys, mit Szenen bei neuen Mitgliedern.
Ghost ist eine freie (MIT) Publishing-Plattform für Blogs und Newsletter, selbst gehostet oder auf Ghost(Pro). Diese Integration holt die Zahlen deines Blogs in Gladys: seine Mitglieder (kostenlos, zahlend, neu), seine Beiträge (veröffentlicht, Entwürfe, geplant, der neueste) und die Abonnenten jedes Newsletters. Szenen können auf ein neues Mitglied oder einen neuen Beitrag reagieren, ein Dashboard-Widget zeigt den Blog auf einen Blick, und eine Szenenaktion setzt seine Zahlen in eine Nachricht.
Getestet mit einem echten, selbst gehosteten Ghost 6.77 (Docker, SQLite); noch nicht auf Ghost(Pro), und zahlende Mitglieder konnten nicht getestet werden (kein Stripe-Konto): Rückmeldungen sind willkommen in den Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Einen Ghost-Blog, Version 5 oder 6, selbst gehostet oder auf Ghost(Pro), vom Gladys-Rechner aus erreichbar.
- Den Admin-API-Schlüssel einer eigenen Integration (ein Eigentümer oder Administrator des Blogs legt sie an). Der Schlüssel liest den ganzen Blog: die Integration liest nur, sie schreibt nie.
Bei jeder Aktualisierung schickt die Integration neun Anfragen an Ghost, unabhängig von der Größe des Blogs (die Zahlen stammen aus den Summen der API, ein Mitglied oder Beitrag pro Anfrage). Ghost veröffentlicht kein Kontingent für die Admin-API; alle 5 Minuten (Standard) liegt weit unter dem, was ein Blog verkraftet.
Erste Schritte
1. Eine eigene Integration in Ghost anlegen
- Öffne im Ghost-Admin Settings → Integrations (unter „Advanced“).
- Add custom integration, nenne sie „Gladys“, dann Create.
- Kopiere den Admin API key (er sieht aus wie
6a1b…:9f3c…, eine ID, ein Doppelpunkt und ein langes Geheimnis). Nicht den Content-API-Schlüssel: er kann die Mitglieder nicht lesen.
2. Die Integration konfigurieren
- In Gladys: Integrationen → Ghost → Konfiguration.
- Adresse des Blogs: die Adresse deiner Seite, zum Beispiel
https://blog.example.org(eine aus dem Admin kopierte Adresse,…/ghost/#/dashboard, geht auch). Ein lokales Ghost:http://192.168.1.10:2368. Hat der Admin deines Blogs eine eigene Domain, nimm diese. - Admin-API-Schlüssel: füge den Schlüssel ein.
- Aktualisierungsintervall: 1, 5 (Standard), 15 oder 30 Minuten. Es ist auch die Verzögerung der Szenen.
- Sprache der Namen: Sprache der Funktionsnamen, Datumsangaben und Szenensätze (Standard: Französisch).
- Speichere, dann Verbindung testen: die Antwort nennt die Ghost-Version, die Mitglieder und die veröffentlichten Beiträge.
3. Die Geräte anlegen
Öffne den Tab Entdecken: der Blog, seine Mitglieder, seine Beiträge und jeder aktive Newsletter werden als Geräte vorgeschlagen. Lege die an, die du willst.
Die Geräte
Der Blog (mit seinem Titel benannt):
- Online: 1, wenn Ghost antwortet, sonst 0.
- Ghost-Version: zum Beispiel
6.77.
„Mitglieder“:
- Mitglieder, Kostenlose Mitglieder, Zahlende Mitglieder (geschenkte Tarife inbegriffen).
- Neue Mitglieder (24 h) und Neue Mitglieder (7 Tage): Mitglieder, die in den letzten 24 Stunden bzw. 7 Tagen beigetreten sind.
„Beiträge“:
- Veröffentlichte Beiträge, Entwürfe, Geplante Beiträge.
- Neuester Beitrag: der Titel des neuesten veröffentlichten Beitrags, und Datum des neuesten Beitrags: sein Datum, in der Zeitzone von Gladys.
„Newsletter …“, einer pro aktivem Newsletter: Abonnenten.
Die Werte gehen nur bei einer Änderung an Gladys (und mindestens alle 12 Stunden), mit Verlauf für die Zähler.
Dashboard
Das Widget Ghost-Blog zeigt vier Kacheln (Mitglieder, zahlende, neu in 7 Tagen, Beiträge), den neuesten Beitrag mit Datum und eine Schaltfläche Aktualisieren, die Ghost sofort neu liest. Der neueste Beitrag und die Schaltfläche lassen sich in den Widget-Einstellungen ausblenden. Antwortet Ghost nicht, sagt das Widget unter den zuletzt gelesenen Zahlen, warum.
Szenen
Auslöser
- Neues Mitglied: jemand wird Mitglied des Blogs. Du kannst es auf einen Tarif beschränken (kostenlos, zahlend, geschenkt). Die Szene kann Name und E-Mail des Mitglieds, seinen Tarif und den Namen des Blogs nutzen.
- Beitrag veröffentlicht: ein Beitrag wird veröffentlicht, sofort oder zur geplanten Zeit. Die Szene kann Titel und Adresse des Beitrags nutzen.
Beide werden bei der nächsten Abfrage von Ghost erkannt (das Aktualisierungsintervall). Die erste Abfrage merkt sich nur den Bestand; was kam, während die Integration gestoppt war, wird bei ihrem Neustart gemeldet.
Aktionen
- Zahlen des Blogs lesen: liest Mitglieder und Beiträge neu (wenn die letzte Abfrage älter als 15 Sekunden ist) und gibt sie an die nächsten Aktionen weiter, mit einem fertigen Satz: „Mein Blog: 132 Mitglied(er), davon 12 zahlend, 3 neu in 24 h, 9 in 7 Tagen, neuester Beitrag „Hallo“ am 15.11.26, 21:22.“
Szenenideen
- Eine Benachrichtigung „Neues Mitglied: {{name}}“ bei Neues Mitglied, nur für zahlende.
- Jeden Montag um 8 Uhr Zahlen des Blogs lesen und den Satz an dein Handy schicken.
- Bleibt Online 10 Minuten lang auf 0, eine Benachrichtigung: der Blog ist ausgefallen.
Fehlerbehebung
- „Ghost antwortet nicht“: prüfe die Adresse und ob der Gladys-Rechner sie erreicht.
- „Admin-API-Schlüssel abgelehnt“: die eigene Integration wurde gelöscht oder ihr Schlüssel neu erzeugt: kopiere den Schlüssel erneut.
- „Das ist kein Admin-API-Schlüssel“: du hast den Content-API-Schlüssel kopiert.
- „kein Ghost-Blog unter dieser Adresse“: prüfe die Adresse; ein Ghost in
einem Unterverzeichnis (
https://example.org/blog) braucht es. - „die Adresse leitet woanders hin“: gib die Adresse des Ghost-Admins ein (die deines Browsers, wenn du dich bei Ghost anmeldest).
- „Zertifikat abgelehnt“: ein selbst signiertes Zertifikat wird nicht
akzeptiert: nutze die
http://-Adresse in deinem Netz. - Die Protokolle der Integration (Integrationen → Ghost) sagen mehr; bei einem normalen Lesezyklus wird dort nichts geschrieben.
Grenzen
- Nur lesend: die Integration ändert nichts in Ghost.
- Ein Blog pro Integration. Ein archivierter Newsletter behält sein Gerät und seinen letzten Wert: Lösche es in Gladys.
- „Zahlende Mitglieder“ sind alle Mitglieder minus die kostenlosen: zahlende und geschenkte Tarife zusammen.
- Ein mit vergangenem Datum (rückdatiert) veröffentlichter Beitrag löst Beitrag veröffentlicht nicht aus. Höchstens 20 neue Mitglieder und 10 neue Beiträge werden pro Abfrage gemeldet.
- Noch nicht auf Ghost(Pro) und mit Stripe getestet, und nicht mit der Ghost Foundation verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Ghost in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Ghost-Blog | section | Nein | In Ghost: Settings → Integrations → Add custom integration, dann kopiere den Admin-API-Schlüssel. Gib die Adresse des Blogs an und lege die Geräte im Tab „Entdecken“ an. |
| Adresse des Blogs | string | Ja | Die Adresse deiner Ghost-Seite (oder ihres Admins, falls getrennt). |
| Admin-API-Schlüssel | secret | Ja | Der Admin-API-Schlüssel der eigenen Integration (id:secret), nicht der Content-API-Schlüssel. |
| Aktualisierungsintervall | select | Nein | Wie oft Ghost gelesen wird (jedes Mal 9 Anfragen). Auch die Verzögerung der Szenen. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen, Datumsangaben und Szenensätze. |
So installierst du Ghost in Gladys
- Öffne in Gladys Integrationen: Ghost erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-ghost:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-ghost.
Ghost benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Ghost ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation