Communitygithub.com

Upload-Post/viraloop

OpenClaw KI-Agent-Fähigkeit für automatisiertes TikTok- und Instagram-Karussell-Wachstum. Analysiert jede Website-URL, extrahiert Marke, Konkurrenten und Wertversprechen, generiert virale Folien mit automatischer Veröffentlichung und trendender Musik über die Upload-Post-API. Integrierte Analyse-Feedback-Schleife.

Was ist viraloop?

Viraloop ist eine umfassende KI-Agent-Fähigkeit (Skill), die den gesamten Workflow zur Erstellung und Veröffentlichung von 6-teiligen Bilderkarussells auf TikTok und Instagram automatisiert. Sie analysiert automatisch jede beliebige Website, um Markenidentität, Konkurrenten und Wertversprechen zu extrahieren und generiert daraufhin visuell kohärente Folien mittels Googles Gemini 3.1 Flash Image Preview. Die Karussells werden direkt (ohne Entwürfe) auf die verbundenen Konten veröffentlicht, wobei trendende Musik automatisch hinzugefügt wird. Der Skill beinhaltet außerdem eine integrierte Analyse- und Lernschleife (`learnings.json`), die Erkenntnisse aus jedem veröffentlichten Beitrag sammelt, um Hooks, Veröffentlichungszeiten und visuelle Stile kontinuierlich zu verbessern. Unterstützt werden die Plattformen TikTok und Instagram über die Upload-Post-API, wobei beide Kern-APIs (Gemini und upload-post.com) kostenlose Tarife ohne Kreditkartenpflicht anbieten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add Upload-Post/viraloop

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht viraloop?

Analysiere jede Website und generiere ein 6-teiliges Karussell für TikTok/Instagram mit visueller Kohärenz. Veröffentlicht direkt in deinen Feed (keine Entwürfe) mit automatisch trendender Musik. Beide APIs (Gemini + upload-post.com) haben kostenlose Tarife – keine Kreditkarte erforderlich.

Philosophie: Täglicher Iterationszyklus

Der Schlüssel zum Wachstum ist Beständigkeit + Lernen:

  1. 1 Karussell pro Tag veröffentlichen – Beständigkeit schlägt Viralität
  2. Alles aufzeichnen – Jeder Beitrag generiert Daten
  3. Aus Daten lernen – Welche Hooks funktionieren? Welche Zeiten? Welche Visuals?
  4. Iterieren und verbessern – Jedes Karussell ist besser als das letzte
Tag 1: Veröffentlichen → Analysieren → Lernen
Tag 2: Veröffentlichen (verbessert) → Analysieren → Lernen  
Tag 3: Veröffentlichen (besser) → Analysieren → Lernen
...
Tag 30: Du hast 30 Datenpunkte und eine verfeinerte Strategie

Der Skill pflegt eine learnings.json, die Erkenntnisse über alle Beiträge hinweg ansammelt:

  • Beste performende Hooks
  • Optimale Veröffentlichungszeiten
  • Visuelle Stile, die funktionieren
  • CTAs, die konvertieren

Dies ist kein Einmal-Werkzeug. Es ist eine Wachstumsmaschine.

Schnellstart

# 1. Vollständige Unternehmensrecherche
node {baseDir}/scripts/analyze-web.js https://deine-website.de

# 2. 3 Hook-Varianten generieren (SCHOCK, NEUGIERDE, WIDERSPRUCH)
GEMINI_API_KEY="dein-key" bash {baseDir}/scripts/generate-hooks.sh

# 3. Hooks mit Vision überprüfen, den besten auswählen

# 4. Folien mit dem ausgewählten Hook-Typ generieren
GEMINI_API_KEY="dein-key" bash {baseDir}/scripts/generate-slides.sh [shock|curiosity|contradiction]

# 5. Folien überprüfen (Agent prüft Text und Qualität)
# Der Agent verwendet Vision, um jede Folie zu prüfen

# 6. Auf TikTok + Instagram veröffentlichen
UPLOADPOST_TOKEN="dein-token" bash {baseDir}/scripts/publish-carousel.sh

# 7. Analysen prüfen (nach 24-48h)
UPLOADPOST_TOKEN="dein-token" bash {baseDir}/scripts/check-analytics.sh 7

# 8. Aus Daten für nächste Karussells lernen
node {baseDir}/scripts/learn-from-analytics.js

Hook-Kategorien (System der visuellen Neuheit)

Der Schlüssel, um die 1000-Aufrufe-Decke zu durchbrechen, ist visuelle Neuheit in der ersten Folie. Wir generieren 3 Hook-Typen:

TypZielVisueller Stil
SCHOCKScrollen stoppen durch Unmögliches/AbsurdesSurreal, chaotisch, "Moment mal...?"
NEUGIERDEInformationslücke schaffenGeheimnisvoll, Geheimnisse werden gelüftet
WIDERSPRUCHUnmögliche Kombination zeigenEntspannt + intensiv, "Wie ist das möglich?"

Anti-Stock-Filter

Alle Hooks enthalten Anti-Stock-Anweisungen, um Folgendes zu vermeiden:

  • Generische Stock-Foto-Ästhetik
  • Das Klischee der schockierten hübschen Frau
  • Typische Influencer-Posen
  • Überstrapazierte Laptop-Kaffee-Setups
  • Corporate-Handshake-Szenen

Hook-Test-Workflow

  1. 3 Varianten mit generate-hooks.sh generieren
  2. Mit Vision überprüfen, jede 1-5 nach Neuheit bewerten
  3. Alles, was bekannt vorkommt, verwerfen
  4. Besten Hook für Karussell verwenden
  5. Im Laufe der Zeit verfolgen, welcher Hook-TYP am besten abschneidet

Bildmodell

Verwendet gemini-3.1-flash-image-preview zur Generierung von Folien.

  • Lokales Skript: {baseDir}/scripts/generate_image.py
  • Unterstützt Bild-zu-Bild für visuelle Kohärenz zwischen Folien

Schritt 1: Vollständige Recherche (analyze-web.js)

Führt eine KOMPLETTE Unternehmensuntersuchung durch:

1. Markenanalyse

  • Markenname (aus Domain oder Titel)
  • Logo (URL oder SVG)
  • CSS-Farben (Hintergrund, Primär, Links, Überschriften)
  • Typografie (Textkörper-Schriftart, Überschriften-Schriftart)
  • Favicon

2. Inhaltsanalyse

  • Überschrift und Slogan
  • Alle Überschriften (Seitenstruktur)
  • Funktionen/Vorteile (Titel + Beschreibung)
  • Preise/Pläne
  • Testimonials
  • Statistiken/Kennzahlen
  • CTAs
  • Meta-Tags (Titel, Beschreibung, og:image)

3. Interne Seiten

  • Navigiert zu Preisen, Funktionen, Über uns, Testimonials
  • Extrahiert zusätzliche Inhalte von jeder Seite

4. Konkurrenzerkennung

  • Sucht nach bekannten Konkurrenzerwähnungen im Inhalt
  • Liste von 20+ bekannten SaaS-Konkurrenten (Buffer, Hootsuite, Later, usw.)
  • Erkennt "vs", "Alternative", "Vergleiche"-Abschnitte
  • Keine externen Suchanfragen erforderlich – alles von der Website selbst

5. Storytelling

  • Erkennt Geschäftstyp (SaaS, E-Commerce, App)
  • Erkennt Nische (Social-Media-Tools, Entwickler-Tools, usw.)
  • Generiert Hooks basierend auf Kundenschmerzpunkten
  • Definiert Schmerzpunkte aus Funktionen
  • Erstellt Transformationserzählung (vorher → nachher)

6. Visueller Kontext

  • Markenfarben im CSS-Format
  • Farbbeschreibung für Prompts
  • Typografie für Folien
  • Bildthemen basierend auf Nische
  • Styleguide für Kohärenz

Ausgabe: /tmp/carousel/analysis.json

Schritt 2: Folien generieren (generate-slides.sh)

Generiert 6 Folien mit visueller Kohärenz mittels Bild-zu-Bild:

FolieTypInhalt
1HOOKFrage/Problem, das fesselt. Legt den GESAMTEN visuellen Stil fest.
2ProblemDen Schmerz ansprechen. "Du lädst auf TikTok hoch... dann auf Instagram..."
3ZuspitzungKonkurrenz zieht vorbei. Dringlichkeit.
4LösungDas Produkt mit seinem Wertversprechen präsentieren.
5FunktionHauptvorteil.
6CTA"Link in Bio 👆" + Handlungsaufforderung.

Visuelle Kohärenz

  • Folie 1 generiert den Basisstil (Farben, Typografie, Stimmung)
  • Folien 2-6 verwenden Bild-zu-Bild mit Folie 1 als Referenz
  • Behält dieselbe Farbpalette, Schriftarten und Ästhetik bei

Prompts pro Folie

Jede Folie hat:

  • Text: Die Hauptbotschaft
  • Szene: Detaillierte visuelle Beschreibung für den Hintergrund
  • Stil: Basierend auf der Markenanalyse

Ausgabe:

  • /tmp/carousel/slide-{1-6}.jpg
  • /tmp/carousel/caption.txt

Schritt 3: Mit Vision überprüfen

Nach der Generierung MUSS der Agent jede Folie überprüfen:

  • ✓ Text ist lesbar und korrekt
  • ✓ Wörter werden nicht abgeschnitten
  • ✓ Korrekte Rechtschreibung
  • ✓ Visuelle Kohärenz zwischen den Folien
  • ✓ Akzeptable Bildqualität

Bei Fehlern die entsprechende Folie neu generieren.

Bildformat

  • Auflösung: 768x1376 (9:16 Hochformat)
  • Format: JPG (TikTok akzeptiert KEIN PNG)
  • Text: Groß, fett, mit Schatten für Lesbarkeit
  • Hintergrund: Für das Unternehmen relevante Szene, nicht nur einfarbig

Schritt 4: Auf TikTok + Instagram veröffentlichen (publish-carousel.sh)

Veröffentlicht das Karussell auf TikTok und Instagram über die Upload-Post-API.

UPLOADPOST_TOKEN="dein-token" bash {baseDir}/scripts/publish-carousel.sh

Endpunkt: POST /api/upload_photos

Gesendete Parameter:

  • platform[]=tiktok + platform[]=instagram
  • auto_add_music=true – Fügt Musik auf TikTok automatisch hinzu
  • tiktok_title – Kurzer Titel (max. 90 Zeichen) + Hashtags
  • title – Vollständige Bildunterschrift für Instagram
  • privacy_level=PUBLIC_TO_EVERYONE
  • media_type=IMAGE – Fotokarussell auf Instagram
  • async_upload=true – Im Hintergrund verarbeiten
  • photos[] – Die 6 JPG-Folien

⚠️ WICHTIG Instagram: Nach der Veröffentlichung muss der Benutzer zu Instagram gehen und manuell virale Musik hinzufügen:

  1. Instagram öffnen → Profil → Der Beitrag
  2. Bearbeiten → Musik hinzufügen
  3. Nach trendigem/viralem Song suchen

Ausgabe: Speichert request_id in post-info.json zur Nachverfolgung.

Schritt 5: Leistung analysieren (check-analytics.sh)

Holt TikTok- und Instagram-Analysen, um zu sehen, was funktioniert.

UPLOADPOST_TOKEN="dein-token" bash {baseDir}/scripts/check-analytics.sh 7

Verwendete Endpunkte:

  1. Profilanalysen:

    GET /api/analytics/{user}?platforms=tiktok
    

    → Follower, Likes, Kommentare, Shares, Impressionen

  2. Gesamtimpressionen:

    GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true
    

    → Gesamtaufrufe pro Tag

  3. Pro-Beitrag-Analysen:

    GET /api/uploadposts/post-analytics/{request_id}
    

    → Aufrufe, Likes, Kommentare für das spezifische Karussell (TikTok + Instagram)

Docs: https://docs.upload-post.com/api/get-analytics

Schritt 6: Lernen und verbessern (learn-from-analytics.js)

Analysiert Daten und speichert Erkenntnisse für zukünftige Karussells.

node {baseDir}/scripts/learn-from-analytics.js

Generiert:

  • learnings.json – Ansammelnde Wissensbasis
  • Beste Hooks (diejenigen mit den meisten Aufrufen)
  • Optimale Veröffentlichungszeiten
  • Empfehlungen für das nächste Karussell

Vollständiger Ablauf

# 1. Unternehmen recherchieren
node {baseDir}/scripts/analyze-web.js https://mein-produkt.de

# 2. Folien generieren
GEMINI_API_KEY="..." bash {baseDir}/scripts/generate-slides.sh

# 3. Mit Vision überprüfen (Agent prüft Text)
# Agent prüft jedes Folienbild

# 4. Veröffentlichen
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="meinbenutzer" bash {baseDir}/scripts/publish-carousel.sh

# 5. (Nach einigen Stunden/Tagen) Analysieren
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="meinbenutzer" bash {baseDir}/scripts/check-analytics.sh 7

# 6. Für nächste Karussells lernen
node {baseDir}/scripts/learn-from-analytics.js

Dateien

{baseDir}/
├── SKILL.md                      # Diese Dokumentation
└── scripts/
    ├── analyze-web.js            # Vollständige Unternehmensrecherche
    ├── generate-slides.sh        # 6 Folien mit Kohärenz generieren
    ├── generate_image.py         # Gemini 3.1 Flash-Bildgenerierung
    ├── review-slides.js          # Folien zur Überprüfung vorbereiten
    ├── publish-carousel.sh       # Über Upload-Post-API veröffentlichen
    ├── check-analytics.sh        # Analysen abrufen (TikTok + Instagram)
    ├── learn-from-analytics.js   # Aus Daten lernen
    └── search-competitors.js     # Optionale externe Suche

Umgebungsvariablen

VariableBeschreibung
GEMINI_API_KEYGoogle-API-Schlüssel für die Bildgenerierung
UPLOADPOST_TOKENUpload-Post-Token für Veröffentlichung und Analysen
UPLOADPOST_USERUpload-Post-Benutzername (erforderlich)

Hook-Beispiele nach Nische

NischeHook-Beispiel
Social Media Tools"Immer noch EINEN NACH DEM ANDEREN auf Social Media posten? 😩"
SaaS Allgemein"Machst du das immer noch MANUELL?"
E-Commerce"Das Produkt, das TikTok nicht mehr aufhört zu empfehlen"
App"Die App, von der ich wünschte, ich hätte sie früher entdeckt"
Entwickler-Tools"Die API, die deinen Code verändern wird"

Warum Viraloop?

ViraloopAndere Skills
VeröffentlichungDirekt in den FeedNur Entwürfe
MusikAutomatisch trendende MusikManuell
PlattformenTikTok + InstagramEinzelplattform
RechercheAutomatische URL-AnalyseManuelle Beschreibung
BildkohärenzBild-zu-Bild-ReferenzUnabhängige Folien
BildgenGemini (kostenloser Tarif)Bezahlte Anbieter
Postenupload-post.com (kostenlos, keine KK)Bezahlt oder selbst gehostet
TextüberlagerungKI-nativ (Gemini rendert)Externe Skripte
PromptsStrukturierte VorlagenFreiform
Einrichtung3 UmgebungsvariablenKomplexes Multi-Tool-Setup

Hinweise

  • Die Analyse extrahiert Konkurrenten aus dem Website-Inhalt selbst (20+ bekannte SaaS)
  • Bild-zu-Bild erhält Kohärenz, dauert aber ~20s pro Folie
  • Generierte Bildunterschrift enthält nischenrelevante Hashtags
  • Folientext immer überprüfen – manchmal wird er abgeschnitten
  • auto_add_music auf TikTok verbessert das Engagement
  • Analysen nach 24-48h für aussagekräftige Daten prüfen
  • Erkenntnisse sammeln sich an und verbessern sich mit jedem veröffentlichten Karussell
  • TikTok-Titel max. 90 Zeichen (automatisch mit Hashtags gekürzt)

Verwandte Skills