browser-act/skills

GitHub Project & Contributor Finder API Skill

📖 Kurzbeschreibung

Dieses Skill nutzt die BrowserAct GitHub Project & Contributor Finder API, um Projektinformationen und Kontaktdaten von Mitwirkenden aus GitHub zu extrahieren. Geben Sie einfach Schlüsselwörter, eine Mindestanzahl von Sternen und einen Aktualisierungsdatumsfilter an – BrowserAct durchsucht die Suchergebnisse, extrahiert Repository-Metriken und ruft detaillierte Mitwirkendenprofile ab. All dies wird direkt über die API zurückgegeben, ohne dass Crawler-Skripte erstellt oder Ratenlimits verwaltet werden müssen.

✨ Funktionen

1. Keine Halluzinationen: Vordefinierte Arbeitsabläufe vermeiden generative KI-Halluzinationen und gewährleisten stabile und präzise Datenextraktion.
2. Keine Captcha-Probleme: Keine Notwendigkeit, sich um reCAPTCHA oder andere Verifikationsherausforderungen zu kümmern.
3. Keine IP-Beschränkungen: Keine Notwendigkeit, regionale IP-Beschränkungen oder Geofencing zu handhaben.
4. Schnellere Ausführung: Aufgaben werden im Vergleich zu rein KI-gesteuerten Browser-Automatisierungslösungen schneller ausgeführt.
5. Kosteneffizient: Senkt die Datenbeschaffungskosten im Vergleich zu KI-Lösungen mit hohem Token-Verbrauch erheblich.

🔑 API-Schlüssel einrichten

Überprüfen Sie vor der Ausführung die Umgebungsvariable BROWSERACT_API_KEY. Wenn diese nicht gesetzt ist, ergreifen Sie keine anderen Maßnahmen; fragen Sie nach und warten Sie, bis der Benutzer sie bereitstellt. 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 Suche nach Repositories.
   • Beispiel: browser automation, react framework, machine learning
   • Standard: browser automation

2. stars

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

3. updated

   • Typ: string
   • Beschreibung: Filtert Repositories 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 Datenelemente, die pro Seite in der Suchergebnisliste extrahiert werden sollen.
   • Beispiel: 5, 10
   • Standard: 5

🚀 Aufrufmethode

Der Agent sollte den folgenden Befehl ausführen, um das 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, andere verwenden 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:

• Überwachen Sie die Terminalausgabe während des Wartens.
• Solange neue Statusprotokolle erscheinen, läuft die Aufgabe normal; bewerten Sie sie nicht fälschlicherweise als eingefroren.
• Erwägen Sie einen erneuten Versuch nur, wenn der Status längere Zeit unverändert bleibt oder die Ausgabe ohne Endergebnis stoppt.

📊 Datenausgabe

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

Projektfelder:

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

Mitwirkendenfelder:

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

⚠️ Fehlerbehandlung und Wiederholung

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

1. Ausgabeinhalt prüfen:

   • Wenn die Ausgabe "Invalid authorization" enthält, ist der API-Schlüssel ungültig oder abgelaufen. Nicht wiederholen; weisen Sie den Benutzer an, den Schlüssel erneut zu überprüfen und den richtigen API-Schlüssel bereitzustellen.
   • Wenn die Ausgabe "concurrent" oder "too many running tasks" enthält, wurde das Limit für gleichzeitige Aufgaben erreicht. Nicht wiederholen; weisen Sie den Benutzer an, sein Abonnement zu verbessern. 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-Plan-Upgrade-Seite, um Ihr Abonnement zu verbessern."

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

2. Wiederholungslimit:

   • Der automatische Wiederholungsversuch ist auf einmal beschränkt. Wenn der zweite Versuch fehlschlägt, brechen Sie die Wiederholungen ab und melden Sie dem Benutzer den spezifischen Fehler.

🌟 Typische Anwendungsfälle

1. Tech-Recruiting: Sammeln Sie Mitwirkendenprofile und soziale Links von beliebten Repositories, um Kandidaten-Pipelines aufzubauen.
2. Open-Source-Entdeckung: Durchsuchen Sie Trend-Repositories nach Schlüsselwörtern und Sternanzahl, um wertvolle Projekte zu finden.
3. Entwicklerkontaktaufnahme: Sammeln Sie persönliche Websites und Twitter-Handles von aktiven Mitwirkenden für das Marketing von Entwicklertools.
4. Community-Aufbau: Identifizieren und vernetzen Sie sich mit aktiven Open-Source-Mitwirkenden in bestimmten Bereichen.
5. Wettbewerbsanalyse: Überwachen Sie, welche Entwickler zu konkurrierenden Projekten beitragen.
6. Partnersuche: Finden Sie Repository-Besitzer für mögliche Zusammenarbeit oder Sponsoring.
7. Marktforschung: Analysieren Sie Repository-Metriken und -Beschreibungen, um Technologietrends zu verstehen.
8. Lead-Generierung: Generieren Sie gezielte Leads für Entwicklertools, indem Sie Projekte mit relevanten Tech-Stacks finden.
9. Akademische Forschung: Entdecken Sie kürzlich aktualisierte Repositories in bestimmten Forschungsbereichen.
10. Talent-Mapping: Erstellen Sie eine Datenbank qualifizierter Entwickler basierend auf ihren GitHub-Beiträgen und -Profilen.