Nikolaustis/Facebook-Community-Intelligence-Skill

Was macht Facebook-Community-Intelligence-Skill?

Ein wiederverwendbarer Codex-Skill für die zweistufige Überwachung von Facebook-Spielgruppen mit strikter Titelübereinstimmung, Ausschluss von verwandten Spielen, manueller Überprüfungswarteschlange und CSV/Excel-Export.

Übersicht

Dieser Skill automatisiert die Überwachung von Facebook-Gruppen, die einem bestimmten Spiel gewidmet sind. Er filtert Beiträge in zwei Stufen, um irrelevante oder verwandte Inhalte auszuschließen, und stellt sicher, dass nur Beiträge, die genau mit dem angegebenen Spiel übereinstimmen, gemeldet werden.

Funktionen

• Zweistufige Filterung: Erste Stufe filtert nach Schlüsselwörtern und Mindestinteraktionen. Zweite Stufe prüft den Beitragstitel auf strikte Übereinstimmung mit dem Spielnamen.
• Ausschluss von verwandten Spielen (Sibling-Games): Listen von verwandten Spielen werden ausgeschlossen, um Rauschen zu vermeiden.
• Manuelle Überprüfungswarteschlange: Beiträge, die die erste Stufe bestehen, aber nicht eindeutig zugeordnet werden können, werden zur manuellen Überprüfung vorgemerkt.
• Export: Ergebnisse werden in CSV oder Excel exportiert.

Verwendung

1. Konfiguration: Erstelle eine Konfigurationsdatei (config.json) mit den folgenden Parametern:

   • game_name: Der genaue Name des zu überwachenden Spiels.
   • sibling_games: Eine Liste von Spielnamen, die ausgeschlossen werden sollen.
   • fb_groups: Eine Liste von Facebook-Gruppen-IDs oder URLs.
   • min_interactions: Minimale Anzahl von Reaktionen/Kommentaren für einen Beitrag.
   • keywords: Schlüsselwörter, nach denen in Beiträgen gesucht werden soll.
   • export_format: csv oder xlsx.

2. Ausführung: Führe den Skill mit dem Befehl codex run nikolaustis/facebook-community-intelligence-skill --config config.json aus.

3. Ergebnisse: Die gefilterten Beiträge werden in der angegebenen Exportdatei gespeichert. Beiträge in der Überprüfungswarteschlange werden in einer separaten Datei (review_queue.csv oder .xlsx) abgelegt.

Konfigurationsbeispiel

{
  "game_name": "MeinSuperSpiel",
  "sibling_games": ["MeinSuperSpiel2", "MeinSuperSpielLite"],
  "fb_groups": ["1234567890", "0987654321"],
  "min_interactions": 5,
  "keywords": ["Update", "Bug", "Feature"],
  "export_format": "csv"
}

Ausgabeformat

Die exportierte CSV/Excel-Datei enthält die folgenden Spalten:

Spalte	Beschreibung
group_name	Name der Facebook-Gruppe
post_id	Eindeutige ID des Beitrags
author	Name des Autors
title	Titel des Beitrags
content	Inhalt des Beitrags (gekürzt)
interactions	Anzahl der Interaktionen
matched	Ob der Beitrag mit game_name übereinstimmt
timestamp	Zeitstempel der Erstellung

Fehlerbehandlung

• Falls die Facebook-API nicht erreichbar ist, wird der Skill eine Fehlermeldung ausgeben und die Ausführung abbrechen.
• Ungültige Konfigurationsparameter führen zu einem klaren Fehlerhinweis.
• Beiträge, die aufgrund von Zugriffsbeschränkungen nicht abgerufen werden können, werden übersprungen und in einem Log vermerkt.

Abhängigkeiten

• Python 3.8+
• requests für Facebook-API-Aufrufe
• pandas für Datenverarbeitung und Export
• openpyxl für Excel-Export (optional, für xlsx)

Lizenz

MIT