Social Extension — AthenaBot Plugin

Einrichtung

Plugin installieren und die eigenen API-Zugänge für X und Instagram hinterlegen.

Einrichtung

1. Plugin installieren

  1. Den Plugin-Ordner in den Bot kopieren: plugins/social-extension/.
  2. Bot neu starten. Das Plugin registriert Konfiguration, Zeitplan, den /social-Befehl und die Dashboard-Seite automatisch.
  3. Im Dashboard die Seite Social öffnen.

2. RSS (einfachster Weg — ohne API-Keys)

Statt einer Plattform-API kannst du pro Account einfach eine RSS-/Atom-Feed-URL angeben. Ist sie gesetzt, crawlt das Plugin den Feed — ganz ohne API-Keys. Besonders praktisch für Instagram (z. B. ein Feed von RSS.app) und funktioniert genauso für X (RSS.app oder eine Nitter-Instanz).

  1. Erzeuge für den Account einen RSS-Feed (z. B. bei RSS.app).
  2. Trage die Feed-URL im Dashboard beim Account unter RSS feed URL ein.
  3. Kanal & Rolle wählen, speichern — fertig.
Mit RSS brauchst du weder ein X-Bearer-Token noch die Instagram Graph API. Die folgenden API-Abschnitte sind nur nötig, wenn du kein RSS verwendest.

3. Twitter / X

Für X wird die offizielle X API v2 mit einem App-only Bearer-Token genutzt. Ein Token reicht, um viele öffentliche Accounts zu beobachten.

  1. Unter developer.x.com ein Projekt/eine App anlegen.
  2. Das App-only Bearer Token kopieren.
  3. Im Dashboard unter API-Zugangsdaten → Twitter / X Bearer Token einfügen und speichern.
Pro X-Account trägst du anschließend nur noch den Benutzernamen (ohne @) ein — der Token gilt für alle.

4. Instagram

Nimm lieber die RSS-Variante oben — die braucht kein API-Setup. Die Graph API nur, wenn du sie bewusst möchtest.

Instagram wird über die offizielle Instagram Graph API gelesen. Das funktioniert mit Business-/Creator-Accounts.

Für jeden Instagram-Account brauchst du:

FeldBeschreibung
Instagram-Account-IDDie ID des Instagram-Business-Accounts
Access-TokenEin gültiges Access-Token für genau diesen Account

Diese beiden Werte trägst du direkt am Account im Dashboard ein (siehe Dashboard & Accounts).

API-Tokens sind Geheimnisse. Teile sie mit niemandem. Im Dashboard werden gespeicherte Tokens nie zurück an den Browser gesendet — ein leeres Feld beim Speichern lässt den vorhandenen Wert unverändert.
Drittanbieter-APIs sind rate-limitiert. Lass das Prüf-Intervall bei einem vernünftigen Wert (Standard: 5 Minuten).
Copyright © 2026