Gemini Search Watcher & Claude Skill

Dieses Projekt stellt eine Brücke (Bridge) zwischen Claude Desktop und der Google Gemini CLI her. Da Web-Suchen und externe CLIs in isolierten AI-Umgebungen oft Timeouts verursachen oder nicht direkt verfügbar sind, nutzt dieses System einen asynchronen "File-Watcher"-Ansatz.

Das System besteht aus zwei Hauptteilen:

1. Einem Hintergrund-Skript (gemini_watcher.py), das auf Suchaufträge wartet und die Gemini CLI steuert.
2. Einer Dateisystem-Schnittstelle, die es Claude (oder dir manuell) erlaubt, Suchen zu beauftragen und Ergebnisse abzuholen.

---

📋 Voraussetzungen

1. Python 3.x: Muss installiert sein.
2. Google Gemini CLI: Das Tool gemini muss im System-PATH verfügbar sein und funktionieren (d.h. Authentifizierung muss bereits erfolgt sein).
3. API Key: Ein gültiger Google API Key muss für die CLI konfiguriert sein (Standardumgebungsvariablen).

---

🚀 Starten des Systems

Bevor Anfragen verarbeitet werden können, muss der "Watcher" gestartet werden. Dieser läuft permanent im Hintergrund.

Option A: Windows Batch-Datei (Empfohlen)

Doppelklicke auf:

• start_watcher.bat: Öffnet ein Fenster, in dem du die Logs siehst. (Gut zum Testen)
• start_watcher_hidden.bat: Startet den Prozess komplett im Hintergrund.

Option B: Direkt über Python

Öffne ein Terminal im Projektordner und führe aus:

python gemini_watcher.py

Du solltest die Meldung sehen: 🚀 Gemini Search Watcher gestartet.

---

✍️ Manuelle Nutzung / Anfrage triggern

Du kannst das System testen oder manuell nutzen, indem du einfach eine Textdatei erstellst. Du musst dazu keine Programmierkenntisse haben, nur Textdateien speichern können.

Schritt 1: Datei erstellen

Erstelle eine neue Textdatei im Ordner: requests/

Der Dateiname muss auf .request.json enden, zum Beispiel meine_suche.request.json.

Schritt 2: Inhalt einfügen

Der Inhalt muss valides JSON sein. Kopiere diese Vorlage:

{
  "id": "manuelle_suche_01",
  "query": "Wie ist das Wetter in Berlin heute?",
  "format": "md"
}

Erklärung der Felder:

• id: Eine beliebige ID, um deine Anfrage wiederzufinden (optional, wird sonst generiert).
• query: Deine eigentliche Suchanfrage an Gemini.
• format: Entweder "md" (für Markdown-Text) oder "json" (für strukturierte Daten).

Schritt 3: Speichern & Warten

Sobald du die Datei speicherst, passiert folgendes:

1. Der Watcher bemerkt die neue Datei sofort.
2. Er benennt sie um oder löscht sie, um zu zeigen, dass sie in Bearbeitung ist.
3. Er startet die Gemini CLI im Hintergrund.
4. Du siehst den Status live in der Datei results/status.json.

---

📂 Ergebnisse abrufen

Alle Ausgaben landen im Ordner results/.

Datei	Beschreibung
status.json	Zeigt den aktuellen Systemzustand (idle, searching, complete, error). Hier schaut man zuerst rein.
gemini_result.md	Das fertige Suchergebnis als lesbarer Text (wenn format="md").
gemini_result.json	Das fertige Suchergebnis als JSON-Objekt (wenn format="json").
ready.flag	Eine Hilfsdatei für Skripte, die signalisiert: "Fertig, du kannst lesen".

Fehlerbehebung

Falls etwas nicht klappt:

1. Prüfe die Datei watcher.log im Hauptverzeichnis.
2. Stelle sicher, dass gemini in deiner Konsole funktioniert (Befehl gemini --version).