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 Karussell pro Tag veröffentlichen – Beständigkeit schlägt Viralität
- Alles aufzeichnen – Jeder Beitrag generiert Daten
- Aus Daten lernen – Welche Hooks funktionieren? Welche Zeiten? Welche Visuals?
- 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:
| Typ | Ziel | Visueller Stil |
|---|---|---|
| SCHOCK | Scrollen stoppen durch Unmögliches/Absurdes | Surreal, chaotisch, "Moment mal...?" |
| NEUGIERDE | Informationslücke schaffen | Geheimnisvoll, Geheimnisse werden gelüftet |
| WIDERSPRUCH | Unmögliche Kombination zeigen | Entspannt + 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
- 3 Varianten mit
generate-hooks.shgenerieren - Mit Vision überprüfen, jede 1-5 nach Neuheit bewerten
- Alles, was bekannt vorkommt, verwerfen
- Besten Hook für Karussell verwenden
- 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:
| Folie | Typ | Inhalt |
|---|---|---|
| 1 | HOOK | Frage/Problem, das fesselt. Legt den GESAMTEN visuellen Stil fest. |
| 2 | Problem | Den Schmerz ansprechen. "Du lädst auf TikTok hoch... dann auf Instagram..." |
| 3 | Zuspitzung | Konkurrenz zieht vorbei. Dringlichkeit. |
| 4 | Lösung | Das Produkt mit seinem Wertversprechen präsentieren. |
| 5 | Funktion | 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
- 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[]=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:
- Instagram öffnen → Profil → Der Beitrag
- Bearbeiten → Musik hinzufügen
- 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:
-
Profilanalysen:
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
-
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
| Variable | Beschreibung |
|---|---|
GEMINI_API_KEY | Google-API-Schlüssel für die 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 | "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?
| Viraloop | Andere Skills | |
|---|---|---|
| Veröffentlichung | Direkt in den Feed | Nur Entwürfe |
| Musik | Automatisch trendende Musik | Manuell |
| Plattformen | TikTok + Instagram | Einzelplattform |
| Recherche | Automatische URL-Analyse | Manuelle Beschreibung |
| Bildkohärenz | Bild-zu-Bild-Referenz | Unabhängige Folien |
| Bildgen | Gemini (kostenloser Tarif) | Bezahlte Anbieter |
| Posten | upload-post.com (kostenlos, keine KK) | Bezahlt 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 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_musicauf 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)