browser-act/skills

Business Contact & Social Links Extractor Skill

📖 Kurzbeschreibung

Dieses Skill integriert zwei BrowserAct-Vorlagen, um zwei häufige Szenarien abzudecken. Wenn der Benutzer einen Firmennamen bereitstellt, wird Google durchsucht, um die offizielle Website und die Social-Media-Kanäle des Unternehmens zu extrahieren. Wenn der Benutzer eine Website-URL bereitstellt, wird die Seite nach Social-Media-Profil-Links (LinkedIn, Facebook, X/Twitter, Instagram, YouTube, TikTok) durchsucht. Das Skript erkennt automatisch den Eingabetyp und leitet die Anfrage an die richtige Vorlage weiter.

✨ Funktionen

1. Keine Halluzinationen: Voreingestellte Workflows vermeiden generative KI-Halluzinationen und gewährleisten eine stabile und präzise Datenextraktion.
2. Keine Captcha-Probleme: Keine Notwendigkeit, reCAPTCHA oder andere Verifikationsherausforderungen zu handhaben.
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 Browserautomatisierungslösungen schneller ausgeführt.
5. Kosteneffizient: Reduziert die Kosten für die Datenerfassung im Vergleich zu KI-Lösungen mit hohem Tokenverbrauch erheblich.

🔑 API-Key-Einrichtung

Überprüfen Sie vor der Ausführung die Umgebungsvariable BROWSERACT_API_KEY. Wenn sie nicht gesetzt ist, ergreifen Sie keine anderen Maßnahmen; fragen Sie den Benutzer und warten Sie auf dessen Angabe. Der Agent muss den Benutzer informieren:

"Da Sie den BrowserAct API-Key noch nicht konfiguriert haben, besuchen Sie bitte die BrowserAct-Konsole, um Ihren Key zu erhalten."

🛠️ Eingabeparameter

Der Agent soll ermitteln, ob die Eingabe ein Firmenname oder eine Website-URL ist, und diese an das Skript übergeben. Das Skript leitet die Anfrage automatisch an die richtige Vorlage weiter.

1. Ziel (Firmenname oder Website-URL)
   • Erforderlich: Ja
   • Typ: string
   • Beschreibung: Der Name des zu suchenden Unternehmens oder die direkte Website-URL, von der Social-Media-Links extrahiert werden sollen.
   • Beispiel: OpenAI oder https://www.rotorooter.com/

🚀 Aufrufmethode

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

# Suche nach Firmennamen
python -u ./scripts/business_contact_social_links.py "OpenAI"

# Scrapen nach Website-URL
python -u ./scripts/business_contact_social_links.py "https://www.rotorooter.com/"

⏳ Ausführungsüberwachung

Da diese Aufgabe automatisierte Browseroperationen umfasst, kann sie mehrere Minuten dauern. Das Skript gibt kontinuierlich mit Zeitstempel versehene 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; beurteilen Sie sie nicht fälschlicherweise als eingefroren.
• Ziehen Sie einen erneuten Versuch nur in Betracht, wenn der Status längere Zeit unverändert bleibt oder die Ausgabe ohne Endergebnis stoppt.

📊 Datenausgabe

Bei erfolgreicher Ausführung gibt das Skript strukturierte JSON-Daten aus, die aus der API-Antwort extrahiert wurden.

Wenn ein Firmenname angegeben wurde, enthält die Ausgabe:

• Company Name: Der offizielle Name des Unternehmens.
• Current Page URL: Die URL der offiziellen Website.
• Social Media Information: Eine konsolidierte Liste der gefundenen Social-Media-Profile.

Wenn eine Website-URL angegeben wurde, enthält die Ausgabe ein Array von Objekten:

• platform: Name der Plattform (z.B. LinkedIn, YouTube).
• url: Kanonische URL des externen Profils.

⚠️ 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:

   • Wenn die Ausgabe enthält "Invalid authorization", ist der API-Key ungültig oder abgelaufen. Nicht wiederholen; den Benutzer anleiten, den Key erneut zu überprüfen und den richtigen Key bereitzustellen.
   • Wenn die Ausgabe enthält "concurrent" oder "too many running tasks", wurde das Limit für gleichzeitige Aufgaben erreicht. Nicht wiederholen; den Benutzer anleiten, 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 die oben genannten Fehlerschlüsselwörter nicht enthält, die Aufgabe aber fehlgeschlagen ist (z.B. Ausgabe beginnt mit Error: oder leere Ergebnisse zurückgibt), soll der Agent das Skript automatisch einmal erneut ausführen.

2. Wiederholungslimit:

   • Die automatische Wiederholung ist auf einmal beschränkt. Wenn der zweite Versuch fehlschlägt, Wiederholungen stoppen und den spezifischen Fehler dem Benutzer melden.

🌟 Typische Anwendungsfälle

1. Sales Lead Enrichment: Finden Sie die offizielle Website und Social-Media-Kanäle für eine Liste von Firmennamen.
2. Influencer Outreach: Extrahieren Sie alle Social-Media-Profile von der persönlichen Website eines Creators.
3. Wettbewerbsanalyse: Entdecken Sie, welche Social-Media-Plattformen ein Konkurrenzunternehmen priorisiert.
4. CRM-Datenbereinigung: Überprüfen und ergänzen Sie fehlende Social-Media-Links und offizielle URLs für bestehende Leads.
5. Multi-Channel-Marketing: Erstellen Sie zielgerichtete Listen von Unternehmen mit aktiver Social-Media-Präsenz.
6. Social Listening Einrichtung: Sammeln Sie schnell offizielle Accountnamen, um Markenerwähnungen zu überwachen.
7. B2B-Prospektion: Kombinieren Sie mit Gelbe-Seiten-Daten, um vollständige Business-Intelligence-Profile zu erstellen.
8. Partnerprüfung: Bewerten Sie den digitalen Fußabdruck eines potenziellen Geschäftspartners allein anhand seines Namens.
9. Verzeichniserstellung: Automatisieren Sie das Sammeln von Website- und Social-Media-Links für ein lokales Geschäftsverzeichnis.
10. Markenverfolgung: Verfolgen Sie alle offiziellen Kontaktkanäle bestimmter Marken im Web.