Was macht viraloop?
Analysiere jede Website und erstelle ein 6-Folien-Karussell für TikTok/Instagram mit visueller Kohärenz. Veröffentliche direkt in deinem Feed (keine Entwürfe) mit automatischer, trendender Musik. Beide APIs (Gemini + upload-post.com) haben kostenlose Tarife – keine Kreditkarte nötig zum Starten.
Philosophie: Tägliche automatisierte Schleife
Der Schlüssel zum Wachstum ist Konsistenz + Lernen. Diese Fähigkeit wurde entwickelt, um jeden Tag, vollständig autonom, zu laufen. Der Agent führt die gesamte Pipeline ohne Bestätigungsabfrage aus – von der Recherche bis zur Veröffentlichung – und benachrichtigt dich erst am Ende mit den veröffentlichten TikTok- und Instagram-URLs.
- Poste 1 Karussell pro Tag – Konsistenz schlägt Viralität
- Verfolge alles – Jeder Beitrag generiert Daten
- Lerne aus Daten – Welche Hooks funktionieren? Welche Zeiten? Welche Visualisierungen?
- Wiederhole und verbessere dich – Jedes Karussell ist besser als das vorherige
Tag 1: Posten → Analysieren → Lernen
Tag 2: Posten (verbessert) → Analysieren → Lernen
Tag 3: Posten (besser) → Analysieren → Lernen
...
Tag 30: Du hast 30 Datenpunkte und eine verfeinerte Strategie
Die Fähigkeit verwaltet eine learnings.json, die Erkenntnisse aus allen Beiträgen sammelt:
- Beste Hooks (Aufhänger)
- Optimale Posting-Zeiten
- Visuelle Stile, die funktionieren
- CTAs, die konvertieren
Dies ist kein einmaliges Werkzeug. Es ist eine Wachstumsmaschine.
Bevor du loslegst: Account-Warmup
Wenn deine TikTok- oder Instagram-Konten brandneu sind, poste nicht am ersten Tag Karussells. Beide Plattformen drosseln die Reichweite von frischen Konten, die direkt mit dem Veröffentlichen von Inhalten beginnen.
TikTok (7-14 Tage Warmup)
- Verbringe täglich 30-60 Minuten damit, TikTok normal zu nutzen: scrolle, like (ungefähr jedes 10. Video), folge Accounts in deiner Nische
- Warte, bis deine „Für dich“-Seite von Inhalten deiner Nische dominiert wird – das bedeutet, der Algorithmus hat dein Konto profiliert
- Erst dann beginne mit dem Posten. Deine ersten Beiträge erreichen die richtige Zielgruppe, anstatt unterzugehen
Instagram (5-7 Tage Warmup)
- Durchstöbere täglich Reels und die Erkunden-Seite, interagiere mit Inhalten in deiner Nische
- Folge relevanten Accounts, like und kommentiere authentisch
- Poste 2-3 Stories vor deinem ersten Karussell, um zu signalisieren, dass das Konto aktiv ist
Warum das wichtig ist
Plattformen markieren Konten, die von null Aktivität zu automatisiertem Posten übergehen. Ein aufgewärmtes Konto erhält 5-10x mehr anfängliche Reichweite als ein kaltes. Dieser Schritt ist langweilig, aber er ist der Unterschied zwischen 500 Aufrufen und 50.000 Aufrufen bei deinem ersten Karussell.
Wenn deine Konten bereits aktiv und etabliert sind, überspringe dies und gehe direkt zum Schnellstart.
Schnellstart
Der Agent sollte die vollständige Pipeline automatisch ausführen. Frage nicht zwischen den Schritten nach einer Bestätigung.
# 0. ZUERST: Analysiere vorherige Beiträge + lerne
# (Überspringe dies nur beim allerersten Durchlauf, wenn es noch keine Beiträge gibt)
UPLOADPOST_TOKEN="dein-token" bash {baseDir}/scripts/check-analytics.sh 7
node {baseDir}/scripts/learn-from-analytics.js
# 1. Vollständige Geschäftsrecherche
node {baseDir}/scripts/analyze-web.js https://deine-website.com
# 2. Lese learnings.json und verwende die besten Hooks/Zeiten/Stile für dieses Karussell
# → Wähle einen Hook-Stil aus bestHooks (oder probiere eine Variation)
# → Verwende die empfohlene Posting-Zeit
# → Wende alle Erkenntnisse aus den Empfehlungen an
# 3. Generiere Folien mit visueller Kohärenz
GEMINI_API_KEY="dein-key" bash {baseDir}/scripts/generate-slides.sh
# 4. Überprüfe Folien mit Vision → korrigiere fehlerhafte automatisch
# Der Agent verwendet sein Bild-zu-Text-Modell, um jede Folie zu überprüfen
# Wenn eine Folie Probleme hat (abgeschnittener Text, schlechte Qualität, Rechtschreibfehler):
# → Generiere NUR diese Folie automatisch neu
# → Überprüfe erneut, bis alle 6 Folien bestehen
# 5. Veröffentliche auf TikTok + Instagram
UPLOADPOST_TOKEN="dein-token" bash {baseDir}/scripts/publish-carousel.sh
Der Agent benachrichtigt den Benutzer nur ganz am Ende, mit den veröffentlichten TikTok- und Instagram-Post-URLs. Alles andere läuft autonom.
Wie Lernerfahrungen jedes Karussell verbessern
Die learnings.json-Datei wird mit jedem Beitrag intelligenter. Bevor der Agent Folien generiert, liest er sie und wendet Folgendes an:
- Beste Hooks: Verwende Hook-Stile, die die meisten Aufrufe erzielt haben. Probiere Variationen der Gewinner aus.
- Beste Zeiten: Plane die Veröffentlichung zu der Zeit, die historisch gesehen die höchste Reichweite erzielt.
- Beste Tage: Bevorzuge Tage, die besser abschneiden.
- Schlechte Leistungen: Vermeide Hook-Stile, die konstant unterdurchschnittlich abschneiden.
- Engagement-Tipps: Wenn das Engagement niedrig ist, verwende provokativere Hooks oder andere visuelle Stile.
Das bedeutet, dass Karussell #30 deutlich bessere Prompts haben wird als Karussell #1.
Agenten-Ausführungsplan: Der Agent sollte nicht zu einer zufälligen Zeit laufen. Er sollte learnings.json lesen, sich das bestTimes-Array ansehen und seinen eigenen Cron-/Automatisierungsplan automatisch anpassen, sodass die morgige Ausführung genau zur optimalen Veröffentlichungszeit stattfindet.
Erste Durchläufe (noch keine Daten): Bei den ersten paar Malen gibt es noch keine Analysedaten – das ist in Ordnung. Der Agent verwendet die Standard-Hooks aus analyze-web.js und die allgemeinen Empfehlungen. Nach 5-10 Beiträgen hat learnings.json genug Daten, um aussagekräftige Empfehlungen zu geben. Je mehr du postest, desto intelligenter wird es.
Bildmodell
Verwendet gemini-3.1-flash-image-preview zum Generieren 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 Geschäftsuntersuchung durch:
1. Markenanalyse
- Markenname (aus Domain oder Titel)
- Logo (URL oder SVG)
- CSS-Farben (Hintergrund, Primär, Links, Überschriften)
- Typografie (Schriftart für Textkörper, Schriftart für Überschriften)
- 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. Wettbewerbererkennung
- Sucht nach bekannten Wettbewerbererwähnungen im Inhalt
- Liste von 20+ bekannten SaaS-Wettbewerbern (Buffer, Hootsuite, Later usw.)
- Erkennt Abschnitte mit "vs", "Alternative", "Vergleiche"
- Keine externen Suchen erforderlich – alles von der Website selbst
5. Storytelling
- Erkennt Geschäftstyp (SaaS, E-Commerce, App)
- Erkennt Nische (Social-Media-Tools, Developer-Tools usw.)
- Generiert Hooks basierend auf Kundenschmerzpunkten
- Definiert Schmerzpunkte aus Funktionen
- Erstellt Transformationsgeschichte (vorher → nachher)
6. Visueller Kontext
- Markenfarben im CSS-Format
- Farbbeschreibung für Prompts
- Typografie für Folien
- Bildthemen basierend auf der 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:
| Folie | Typ | Inhalt |
|---|---|---|
| 1 | HOOK | Frage/Problem, das fesselt. Etabliert den GESAMTEN visuellen Stil. |
| 2 | Problem | Den Schmerz verstärken. „Du lädst auf TikTok hoch... dann auf Instagram...“ |
| 3 | Agitation | Wettbewerb schreitet voran. Dringlichkeit. |
| 4 | Lösung | Präsentiere das Produkt mit seinem Wertversprechen. |
| 5 | Feature | Hauptvorteil. |
| 6 | CTA | „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
- Behalten 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: Überprüfung mit Vision (Autonom)
Nach der Generierung MUSS der Agent jede Folie mit seinem Vision-/Bild-zu-Text-Modell überprüfen. Dieser Schritt ist vollständig automatisch – bitte den Benutzer nicht um eine Überprüfung.
Überprüfe für jede Folie:
- ✓ Text ist vollständig lesbar und korrekt
- ✓ Keine Wörter an den Rändern abgeschnitten
- ✓ Produktname richtig geschrieben
- ✓ Visuelle Kohärenz zwischen allen Folien
- ✓ Kein Text in den unteren 20% (TikTok-Steuerungsbereich)
- ✓ Akzeptable Bildqualität (nicht unscharf oder verzerrt)
Wenn eine Folie nicht besteht: Generiere NUR diese spezifische Folie automatisch neu. Verwende dasselbe Eingabebild, das bei der ursprünglichen Generierung verwendet wurde:
- Folie 1: kein Eingabebild (es etabliert den Stil)
- Folien 2-6: verwende immer
slide-1.jpgals--input-image(die Originalreferenz)
Überprüfe nach der Neugenerierung erneut. Wiederhole, bis alle 6 Folien bestehen. Frage nicht den Benutzer – korrigiere es automatisch.
Bildformat
- Auflösung: 768x1376 (9:16 vertikales Verhältnis)
- Format: JPG (TikTok akzeptiert KEIN PNG)
- Text: Groß, fett, mit Schatten für Lesbarkeit
- Hintergrund: Szene, die zum Geschäft relevant ist, nicht nur einfarbig
Schritt 4: Auf TikTok + Instagram veröffentlichen (publish-carousel.sh)
Veröffentlicht das Karussell direkt im TikTok- und Instagram-Feed ü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[]=instagramauto_add_music=true– Fügt Musik auf TikTok automatisch hinzutiktok_title– Kurzer Titel (max. 90 Zeichen) + Hashtagstitle– Vollständige Bildunterschrift für Instagramprivacy_level=PUBLIC_TO_EVERYONEmedia_type=IMAGE– Fotokarussell auf Instagramasync_upload=true– Im Hintergrund verarbeitenphotos[]– Die 6 JPG-Folien
⚠️ WICHTIG Instagram: Nach der Veröffentlichung muss der Benutzer zu Instagram gehen und manuell virale Musik hinzufügen:
- Öffne Instagram → Profil → Der Beitrag
- Bearbeiten → Musik hinzufügen
- Suche nach trendigem/viralem Song
Ausgabe: Speichert request_id in post-info.json zur Nachverfolgung.
Schritt 5: Leistung analysieren (check-analytics.sh)
Ruft TikTok- und Instagram-Analysen ab, um zu sehen, was funktioniert.
UPLOADPOST_TOKEN="dein-token" bash {baseDir}/scripts/check-analytics.sh 7
Verwendete Endpunkte:
-
Profil-Analysen:
GET /api/analytics/{user}?platforms=tiktok→ Follower, Likes, Kommentare, Shares, Impressionen
-
Gesamtimpressionen:
GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true→ Gesamtaufrufe pro Tag
-
Analysen pro Beitrag:
GET /api/uploadposts/post-analytics/{request_id}→ Aufrufe, Likes, Kommentare für das spezifische Karussell (TikTok + Instagram)
Doku: 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. Dies muss am ANFANG jeder täglichen Schleife ausgeführt werden, nicht nur am Ende.
node {baseDir}/scripts/learn-from-analytics.js
Generiert/aktualisiert:
learnings.json– Angesammelte Wissensdatenbank- Beste Hooks (diejenigen, die die meisten Aufrufe generieren)
- Optimale Posting-Zeiten und -Tage
- Verfolgung der Engagement-Rate
- Empfehlungen für das nächste Karussell
Der Agent muss learnings.json lesen, bevor er jedes neue Karussell generiert, und die Erkenntnisse nutzen, um bessere Hooks auszuwählen, leistungsschwache Stile zu vermeiden und zu optimalen Zeiten zu planen.
Tägliche Schleife (Vollständiger Ablauf)
Dies ist die genaue Abfolge, die der Agent jeden Tag vollständig autonom ausführt:
# SCHRITT 0: Lerne aus vorherigen Beiträgen (beim ersten Durchlauf überspringen)
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="meinbenutzer" bash {baseDir}/scripts/check-analytics.sh 7
node {baseDir}/scripts/learn-from-analytics.js
# → Agent liest learnings.json und wählt den besten Hook-Stil aus
# → KRITISCH: Agent überprüft bestTimes und plant SEINE EIGENE NÄCHSTE AUSFÜHRUNG für genau diese Stunde morgen
# SCHRITT 1: Geschäft recherchieren
node {baseDir}/scripts/analyze-web.js https://mein-produkt.com
# SCHRITT 2: Folien generieren (unter Verwendung der Erkenntnisse aus learnings)
GEMINI_API_KEY="..." bash {baseDir}/scripts/generate-slides.sh
# SCHRITT 3: Mit Vision überprüfen → fehlerhafte Folien automatisch korrigieren
# Agent überprüft jede Folie, generiert alle, die nicht bestehen, neu
# SCHRITT 4: Veröffentlichen
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="meinbenutzer" bash {baseDir}/scripts/publish-carousel.sh
# → Benutzer NUR HIER benachrichtigen, mit TikTok- + Instagram-URLs
Dateien
{baseDir}/
├── SKILL.md # Diese Dokumentation
└── scripts/
├── analyze-web.js # Vollständige Geschäftsrecherche
├── generate-slides.sh # 6 Folien mit Kohärenz generieren
├── generate_image.py # Gemini 3.1 Flash Image
├── review-slides.js # Folien für Ü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
| Variable | Beschreibung |
|---|---|
GEMINI_API_KEY | Google-API-Schlüssel für Bildgenerierung |
UPLOADPOST_TOKEN | Upload-Post-Token für Veröffentlichung und Analysen |
UPLOADPOST_USER | Upload-Post-Benutzername (erforderlich) |
Hook-Beispiele nach Nische
| Nische | Hook-Beispiel |
|---|---|
| Social Media Tools | „Postest du immer noch EINEN NACH DEM ANDEREN auf Social Media? 😩“ |
| SaaS Allgemein | „Machst du das immer noch MANUELL?“ |
| E-Commerce | „Das Produkt, das TikTok nicht aufhören wird zu empfehlen“ |
| App | „Die App, die ich mir gewünscht hätte, früher entdeckt zu haben“ |
| Developer Tools | „Die API, die deinen Code verändern wird“ |
Warum Viraloop?
| Viraloop | Andere Fähigkeiten | |
|---|---|---|
| Veröffentlichung | Direkt im Feed | Nur Entwürfe |
| Musik | Automatische, trendende Musik | Manuell |
| Plattformen | TikTok + Instagram | Single-Plattform |
| Recherche | Automatische URL-Analyse | Manuelle Beschreibung |
| Bildkohärenz | Bild-zu-Bild-Referenz | Unabhängige Folien |
| Bildgenerierung | Gemini (kostenloser Tarif) | Kostenpflichtige Anbieter |
| Posten | upload-post.com (kostenlos, keine Kreditkarte) | Kostenpflichtig oder selbst gehostet |
| Textüberlagerung | KI-nativ (Gemini rendert) | Externe Skripte |
| Prompts | Strukturierte Vorlagen | Freiform |
| Einrichtung | 3 Umgebungsvariablen | Komplexes Multi-Tool-Setup |
Hinweise
- Die Analyse extrahiert Wettbewerber aus dem Website-Inhalt selbst (20+ bekannte SaaS)
- Bild-zu-Bild erhält die Kohärenz, dauert aber etwa 20s