GitHub-Projekt- und Mitwirkenden-Finder-API-Skill

GitHub Projekt & Mitwirkenden-Finder-API Skill

📖 Kurzbeschreibung

Dieser Skill nutzt die BrowserAct GitHub Project & Contributor Finder API, um Projektdetails und Kontaktinformationen von Mitwirkenden aus GitHub zu extrahieren. Gib einfach Schlüsselwörter, eine Mindestanzahl an Sternen und einen Aktualitätsfilter an – BrowserAct durchsucht die Ergebnisse, extrahiert Repository-Metriken und ruft detaillierte Mitwirkendenprofile ab und gibt alles direkt über die API zurück, ohne dass eigene Crawler-Skripte oder der Umgang mit Ratenbegrenzungen nötig sind.

✨ Funktionen

1. Keine Halluzinationen: Voreingestellte Arbeitsabläufe vermeiden KI-Halluzinationen und gewährleisten stabile, präzise Datenextraktion.
2. Keine Captcha-Probleme: Keine Notwendigkeit, reCAPTCHA oder andere Verifikationsherausforderungen zu handhaben.
3. Keine IP-Beschränkungen: Keine Notwendigkeit, regionale IP-Sperren oder Geofencing zu umgehen.
4. Schnellere Ausführung: Aufgaben werden im Vergleich zu rein KI-gesteuerten Browserautomatisierungslösungen schneller ausgeführt.
5. Kosteneffizient: Senkt die Datenerfassungskosten im Vergleich zu KI-Lösungen mit hohem Tokenverbrauch erheblich.

🔑 API-Schlüssel einrichten

Vor der Ausführung muss die Umgebungsvariable BROWSERACT_API_KEY gesetzt sein. Ist sie nicht gesetzt, ergreife keine anderen Maßnahmen; frage den Benutzer und warte auf seine Angabe. Der Agent muss den Benutzer informieren:

"Da Sie noch keinen BrowserAct-API-Schlüssel konfiguriert haben, besuchen Sie bitte die BrowserAct-Konsole, um Ihren Schlüssel zu erhalten."

🛠️ Eingabeparameter

Der Agent sollte die folgenden Parameter basierend auf den Benutzeranforderungen flexibel konfigurieren:

1. KeyWords

   • Typ: string
   • Beschreibung: Schlüsselwörter für die Repository-Suche.
   • Beispiel: browser automation, react framework, machine learning
   • Standard: browser automation

2. stars

   • Typ: number
   • Beschreibung: Mindestanzahl an Sternen, die das Repository haben sollte.
   • Beispiel: 100, 1000
   • Standard: 100

3. updated

   • Typ: string
   • Beschreibung: Filtert Repositorys nach dem Datum der letzten Aktualisierung (Format: YYYY-MM-DD).
   • Beispiel: 2026-01-01, 2025-06-01
   • Standard: 2026-01-01

4. Page_Turns

   • Typ: number
   • Beschreibung: Anzahl der zu durchblätternden Suchergebnisseiten. Wenn es z. B. 39 Seiten gibt und Sie die ersten 2 möchten, geben Sie 2 ein.
   • Beispiel: 1, 2
   • Standard: 1

5. date_limit_per_page

   • Typ: number
   • Beschreibung: Anzahl der Datenpunkte, die pro Seite in der Suchergebnisliste extrahiert werden sollen.
   • Beispiel: 5, 10
   • Standard: 5

🚀 Aufrufmethode

Der Agent soll den folgenden Befehl ausführen, um den Skill aufzurufen:

# Beispielaufruf (alle Parameter)
python -u ./scripts/github_project_contributor_finder_api.py "browser automation" 100 "2026-01-01" 1 5

# Minimaler Aufruf (nur Schlüsselwörter, alle anderen Standardwerte)
python -u ./scripts/github_project_contributor_finder_api.py "react framework"

⏳ Ausführungsüberwachung

Da diese Aufgabe automatisierte Browseroperationen umfasst, kann sie mehrere Minuten dauern. Das Skript gibt kontinuierlich Zeitstempel-Statusprotokolle aus (z. B. [14:30:05] Task Status: running). Richtlinien für den Agenten:

• Überwache die Terminalausgabe während des Wartens.
• Solange neue Statusprotokolle erscheinen, läuft die Aufgabe normal; bewerte sie nicht fälschlicherweise als eingefroren.
• Eine Wiederholung sollte nur in Betracht gezogen werden, wenn der Status längere Zeit unverändert bleibt oder die Ausgabe ohne Endergebnis stoppt.

📊 Datenausgabe

Bei erfolgreicher Ausführung parst das Skript die strukturierten Ergebnisse aus der API-Antwort und gibt sie aus.

Projektfelder:

• repository_name: Der Name des GitHub-Repositorys.
• repository_url: Der Link zum Repository.
• repository_owner_name: Der Besitzer/Ersteller des Repositorys.
• repository_description: Eine Kurzbeschreibung des Repositorys.
• star_count: Die Anzahl der Sterne, die das Repository erhalten hat.

Mitwirkendenfelder:

• user_name: Der GitHub-Benutzername des Mitwirkenden.
• profile_url: Der Link zum Profil des Mitwirkenden.
• bio: Die Biografie oder Kurzbeschreibung des Mitwirkenden.
• repositories_summary: Eine Zusammenfassung anderer Repositories des Mitwirkenden.
• personal_website: Der Link zur persönlichen Website des Mitwirkenden.
• twitter: Der Twitter-Handle des Mitwirkenden.

⚠️ Fehlerbehandlung & Wiederholung

Wenn während der Skriptausführung ein Fehler auftritt (z. B. Netzwerkschwankungen oder Aufgabenfehler), soll der Agent dieser Logik folgen:

1. Ausgabeinhalt prüfen:

   • Enthält die Ausgabe "Invalid authorization", ist der API-Schlüssel ungültig oder abgelaufen. Nicht wiederholen; den Benutzer auffordern, den korrekten API-Schlüssel zu überprüfen und anzugeben.
   • Enthält die Ausgabe "concurrent" oder "too many running tasks", wurde das Limit für gleichzeitige Aufgaben erreicht. Nicht wiederholen; den Benutzer auffordern, seinen Tarif zu aktualisieren. Der Agent muss den Benutzer informieren:

     "Die aktuelle Aufgabe kann nicht ausgeführt werden, da Ihr BrowserAct-Konto das Limit für gleichzeitige Aufgaben erreicht hat. Bitte besuchen Sie die BrowserAct-Tarif-Upgrade-Seite, um Ihren Tarif zu aktualisieren."

   • Wenn die Ausgabe keine der oben genannten Fehlerschlüsselwörter enthält, die Aufgabe jedoch fehlschlägt (z. B. Ausgabe beginnt mit Error: oder gibt leere Ergebnisse zurück), soll der Agent das Skript automatisch einmal erneut ausführen.

2. Wiederholungsgrenze:

   • Automatische Wiederholungen sind auf einmal beschränkt. Schlägt der zweite Versuch fehl, die Wiederholung beenden und den spezifischen Fehler dem Benutzer melden.

🌟 Typische Anwendungsfälle

1. Technische Personalbeschaffung: Sammle Mitwirkendenprofile und Social Links aus beliebten Repositories, um Kandidatenpipelines aufzubauen.
2. Open-Source-Entdeckung: Suche nach trendenden Repositories nach Schlüsselwörtern und Sternanzahl, um wertvolle Projekte zu finden.
3. Entwickleransprache: Sammle persönliche Websites und Twitter-Handles aktiver Mitwirkender für das Marketing von Entwicklertools.
4. Community-Aufbau: Identifiziere und vernetze dich mit aktiven Open-Source-Mitwirkenden in bestimmten Bereichen.
5. Wettbewerbsanalyse: Überwache, welche Entwickler zu konkurrierenden Projekten beitragen.
6. Partnersuche: Finde Repository-Besitzer für potenzielle Zusammenarbeit oder Sponsoring.
7. Marktforschung: Analysiere Repository-Metriken und -Beschreibungen, um Technologietrends zu verstehen.
8. Lead-Generierung: Generiere gezielte Leads für Entwicklertools, indem du Projekte mit relevanten Tech-Stacks findest.
9. Akademische Forschung: Entdecke kürzlich aktualisierte Repositories in bestimmten Forschungsbereichen.
10. Talent-Mapping: Baue eine Datenbank qualifizierter Entwickler basierend auf ihren GitHub-Beiträgen und -Profilen auf.