Erste Schritte

Für den Einstieg

Willkommen bei der offiziellen Dokumentation von **Keoxs Co-Pilot**, einer lokalen und quelloffenen Intelligenz-Engine zur Automatisierung, Auditierung und Optimierung Ihrer Amazon-PPC-Portfolios. Keoxs bringt diagnostische Wirtschaftspräzision und kognitive KI-Analysen auf Enterprise-Niveau direkt auf Ihren lokalen Rechner, wodurch absolute Datensicherheit und extrem schnelle Analysen gewährleistet sind.

💡

Absolute Datensicherheit (Local-First)

Im Gegensatz zu herkömmlichen SaaS-Plattformen, die einen Vollzugriff auf Ihr Verkäuferkonto verlangen und Ihre Finanzdaten auf Remote-Servern speichern, läuft Keoxs **vollständig lokal auf Ihrem Computer**. Ihre Suchbegriffberichte (STR), COGS, Preisstrukturen und API-Schlüssel verlassen Ihren Rechner zu keinem Zeitpunkt.

Wie funktioniert Keoxs Co-Pilot

Keoxs Co-Pilot basiert auf einer **Zwei-Engine-Architektur**, die mathematische Strenge mit qualitativen KI-Analysen verbindet:

1. Algorithmen für Stückkosten

Die Rechen-Engine analysiert Ihre Suchbegriffberichte (STR) Zeile für Zeile und vergleicht jede Kennzahl mit Ihren realen Verkaufspreisen, COGS und FBA-Gebühren, um unrentable Ziele zu identifizieren und optimale Gebote zu berechnen.

2. Kognitives KI-Gehirn

Angetrieben von Google Gemini überschreitet das KI-Gehirn starre mathematische Grenzen, um Suchintentionen, organisches Potenzial und Wettbewerber-Eroberungschancen zu analysieren und eine maßgeschneiderte PPC-Strategie zu entwickeln.

Voraussetzungen

Bevor Sie Keoxs Co-Pilot einrichten, stellen Sie sicher, dass Ihr Computer die folgenden Voraussetzungen erfüllt:

  • Node.js – Version 18+ empfohlen (v20+ voll unterstützt) zur Ausführung der Web-Frontend-Oberfläche.
  • Python – Version 3.10+ erforderlich für die Ausführung des lokalen FastAPI-Backends.
  • Google AI Studio API-Schlüssel – Erforderlich zur Aktivierung des Kognitiven KI-Gehirns. Sie können diesen kostenlos bei Google AI Studio generieren.
  • Git – Empfohlen, um Updates mühelos abzurufen und das lokale Repository zu verwalten.

Schnellstart-Installation

Wir bieten ein One-Line-Installationsskript an, das Ihre Voraussetzungen prüft, das neueste Repository klont, die lokale virtuelle Umgebung konfiguriert und beide Server automatisch startet.

Windows PowerShell (Empfohlen) Automatisch
powershell -ExecutionPolicy Bypass -Command "Invoke-Expression (New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/scalerify-keoxs/keoxs-website/main/install.ps1')"
macOS / Linux Terminal
curl -fsSL https://raw.githubusercontent.com/scalerify-keoxs/keoxs-website/main/install.sh | bash

Manuelles Setup für Entwickler

Wenn Sie Ihren Entwicklungsbereich manuell konfigurieren oder zum Open-Source-Projekt beitragen möchten, folgen Sie diesen Schritten.

1. Repository klonen

git clone https://github.com/scalerify-keoxs/keoxs-co-pilot.git
cd keoxs-co-pilot

2. FastAPI-Backend konfigurieren

cd backend
python -m venv venv
# Windows:
.\venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

pip install -r requirements.txt
python -m uvicorn api:app --host 127.0.0.1 --port 8001 --reload

3. React-Frontend konfigurieren

cd ../frontend
npm install
npm run dev
Kernmodule

Der Onboarding-Assistent

Beim Start führt Keoxs Sie durch einen umfassenden finanziellen Konfigurationsbereich. Geben Sie Ihre Parameter ein:

  • API-Schlüssel – Sichert die Verbindung mit den Gemini-Modellen. Wird ausschließlich im lokalen Speicher des Browsers gespeichert.
  • Mittelpreis & COGS – Ermöglicht dem Algorithmus, Ihren Break-Even-ACOS in Echtzeit zu berechnen (`Nettomarge = (Verkaufspreis - COGS - FBA-Gebühren) / Verkaufspreis`).
  • Schwelle für unrentable Ausgaben (Wasted Spend) – Standardwert: 10 Klicks ohne Conversion. Bestimmt, wann Keywords deaktiviert oder Gebote aggressiv gesenkt werden.

Ingestionsbereich (Drop Zone)

Ziehen Sie Ihre rohe Amazon **Suchbegriffbericht-Datei** (Sponsored Products oder allgemeine Kampagnenberichte) im CSV- oder XLSX-Format direkt per Drag-and-Drop in den Ingestionsbereich.

Keoxs normalisiert die Datei sofort (unabhängig vom Amazon-Herkunftsland), filtert beschädigte Daten heraus und zeigt ein übersichtliches Dashboard sortiert nach wirtschaftlicher Dringlichkeit:

🔴 Dringlichkeiten

Keywords, die Budget mit vielen Klicks, aber 0 Verkäufen verschwenden. Schlägt sofortige Negativ-Exakt-Ausschlüsse vor.

🟠 Optimierungen

Keywords, die konvertieren, deren ACOS jedoch Ihre berechnete Rentabilitätsmarge überschreitet. Schlägt schrittweise Gebotssenkungen vor.

🟢 Potenziale

Hochgradig profitable Keywords, saisonale Suchbegriffe oder Wettbewerber-Ziele mit hohem Potenzial. Schlägt Gebotserhöhungen vor.

Kognitives KI-Gehirn

Klassische mathematische Filter scheitern oft daran, Mikro-Chancen zu erkennen—wie z. B. ein Wettbewerber-Ziel, das ab dem ersten Klick konvertiert, oder frühe saisonale Suchtrends.

Die Registerkarte **KI-Gehirn** umgeht diese Einschränkungen, indem sie Gemini mit einem reichhaltigen geschäftlichen Kontext füttert:

  • Voller Konvertierer-Feed – Die KI analysiert jede Suchanfrage, die mindestens einen Verkauf generiert hat, und erfasst sofort konkurrierende ASINs (wie `b0fmzkwkx9`) mit hervorragendem ROAS.
  • Verlauf-Einspeisung – Speichert automatisch Ihre letzten 5 Analysen, um eine langfristige Optimierungskohärenz zu gewährleisten und gegensätzliche Entscheidungen zu verhindern.
  • Konvertierungs-/Traffic-Diagnose – Synthetisiert Konvertierungsraten gegenüber Impressionen, um anzuzeigen, ob eine Kampagne durch ihr Budget oder ihre Gebote begrenzt ist.

Massenexport von Aktionen

Wenden Sie Ihre Optimierungen in wenigen Sekunden in der Amazon Ads-Konsole an. Durch Klicken auf **Export Bulk Actions** filtern Sie all Ihre Zeilen, um nur die empfohlenen Aktionszeilen zu behalten.

Die flache CSV-Datei verwendet ein standardmäßiges Semikolon als Trennzeichen, das sofort von Excel oder Google Sheets gelesen werden kann. So können Sie Ihre Massenaktionen direkt in Ihren Amazon-Kampagnenmanager kopieren.

Best practices

Pro-Tipps & PPC-Strategie

📅 Wählen Sie den richtigen Analysezeitraum

Beim Herunterladen Ihrer Berichte empfehlen wir, einen Analysezeitraum der **letzten 30 Tage** zu wählen (unter Ausschluss der letzten 48 Stunden, um der Amazon-Verkaufszuordnungsverzögerung Rechnung zu tragen). Dies gibt der Engine ein solides statistisches Volumen.

✍️ Optimieren Sie den KI-Prompt-Kontext

Geben Sie dem KI-Gehirn gerne präzise qualitative Hinweise (z. B.: *"Wir bringen nächste Woche eine neue Geschmacksrichtung heraus und müssen bei der Eroberung der Konkurrenz aggressiv vorgehen"* oder *"Bestandsengpass bei ASIN B bis Juni, reduzieren Sie das Tempo bei den Kampagnen 3 und 4"*). Die KI wird ihre Roadmap entsprechend anpassen.

⚖️ Balancieren Sie TACoS & Nettomargen aus

Verfolgen Sie aufmerksam Ihren TACoS (Total Advertising Cost of Sales). Wenn Ihre organischen Verkäufe stark sind, Ihre Nettomargen jedoch leiden, nutzen Sie die Gebotsempfehlungen von Keoxs, um den Werbedruck schrittweise zu senken, bis Ihr TACoS wieder unter der Zielmarke von 15 % liegt.