Extractor de Contactos Comerciales y Enlaces Sociales

¿Qué hace Extractor de Contactos Comerciales y Enlaces Sociales?

📖 Breve

Esta habilidad integra dos plantillas de BrowserAct para cubrir dos escenarios comunes. Cuando el usuario proporciona un nombre de empresa, busca en Google para extraer el sitio web oficial y los canales de redes sociales de la empresa. Cuando el usuario proporciona una URL de sitio web, raspa el sitio para extraer enlaces a perfiles de redes sociales (LinkedIn, Facebook, X/Twitter, Instagram, YouTube, TikTok). El script detecta automáticamente el tipo de entrada y enruta a la plantilla correcta.

✨ Características

1. Sin alucinaciones: Los flujos de trabajo predefinidos evitan alucinaciones generativas de IA, asegurando una extracción de datos estable y precisa.
2. Sin problemas de CAPTCHA: No es necesario manejar reCAPTCHA u otros desafíos de verificación.
3. Sin restricciones de IP: No es necesario manejar restricciones regionales de IP o geocercas.
4. Ejecución más rápida: Las tareas se ejecutan más rápido en comparación con soluciones de automatización de navegador puramente impulsadas por IA.
5. Rentable: Reduce significativamente los costos de adquisición de datos en comparación con soluciones de IA de alto consumo de tokens.

🔑 Configuración de la Clave API

Antes de ejecutar, verifica la variable de entorno BROWSERACT_API_KEY. Si no está configurada, no tomes otras medidas; pregunta y espera a que el usuario la proporcione. El agente debe informar al usuario:

"Como aún no has configurado la clave API de BrowserAct, visita la Consola de BrowserAct para obtener tu clave."

🛠️ Parámetros de Entrada

El agente debe determinar si la entrada es un nombre de empresa o una URL de sitio web y pasarla al script. El script enruta automáticamente la solicitud a la plantilla correcta.

1. Objetivo (Nombre de Empresa o URL de Sitio Web)
   • Requerido: Sí
   • Tipo: cadena
   • Descripción: El nombre de la empresa a buscar, o la URL directa del sitio web del cual extraer enlaces sociales.
   • Ejemplo: OpenAI o https://www.rotorooter.com/

🚀 Método de Invocación

El agente debe ejecutar el siguiente comando para invocar la habilidad:

# Buscar por nombre de empresa
python -u ./scripts/business_contact_social_links.py "OpenAI"

# Raspar por URL de sitio web
python -u ./scripts/business_contact_social_links.py "https://www.rotorooter.com/"

⏳ Monitoreo de Ejecución

Dado que esta tarea implica operaciones automatizadas del navegador, puede tardar varios minutos. El script genera registros de estado con marca de tiempo continuamente (por ejemplo, [14:30:05] Estado de la tarea: ejecutando). Directrices del agente:

• Monitorea la salida del terminal mientras esperas.
• Mientras aparezcan nuevos registros de estado, la tarea se está ejecutando normalmente; no la juzgues erróneamente como congelada.
• Solo considera activar un reintento si el estado permanece sin cambios durante mucho tiempo o la salida se detiene sin un resultado final.

📊 Salida de Datos

Tras una ejecución exitosa, el script imprime datos JSON estructurados extraídos de la respuesta de la API.

Si se proporcionó un Nombre de Empresa, la salida incluye:

• Nombre de la Empresa: El nombre oficial de la empresa.
• URL de la Página Actual: La URL del sitio web oficial.
• Información de Redes Sociales: Una lista consolidada de los perfiles de redes sociales descubiertos.

Si se proporcionó una URL de Sitio Web, la salida incluye un arreglo de objetos:

• plataforma: Nombre de la plataforma (por ejemplo, LinkedIn, YouTube).
• url: URL canónica del perfil externo.

⚠️ Manejo de Errores y Reintentos

Si ocurre un error durante la ejecución del script (por ejemplo, fluctuaciones de red o fallo de la tarea), el agente debe seguir esta lógica:

1. Verificar el Contenido de la Salida:

   • Si la salida contiene "Invalid authorization", significa que la clave API no es válida o ha expirado. No reintentar; guía al usuario para que verifique y proporcione la clave API correcta.
   • Si la salida contiene "concurrent" o "too many running tasks", significa que se ha alcanzado el límite de tareas concurrentes. No reintentar; guía al usuario para que actualice su plan. El agente debe informar al usuario:

     "La tarea actual no se puede ejecutar porque tu cuenta de BrowserAct ha alcanzado el límite de tareas concurrentes. Visita la Página de Actualización de Plan de BrowserAct para actualizar tu plan."

   • Si la salida no contiene las palabras clave de error anteriores pero la tarea falló (por ejemplo, la salida comienza con Error: o devuelve resultados vacíos), el agente debe re-ejecutar el script automáticamente una vez.

2. Límite de Reintentos:

   • El reintento automático está limitado a una vez. Si el segundo intento falla, deja de reintentar e informa al usuario del error específico.

🌟 Casos de Uso Típicos

1. Enriquecimiento de Leads de Ventas: Encuentra el sitio web oficial y los canales sociales para una lista de nombres de empresas.
2. Divulgación de Influencers: Extrae todos los perfiles de redes sociales del sitio web personal de un creador.
3. Análisis de Competidores: Descubre qué plataformas de redes sociales prioriza una empresa rival.
4. Limpieza de Datos de CRM: Verifica y completa enlaces sociales y URL oficiales faltantes para leads existentes.
5. Marketing Multicanal: Construye listas segmentadas de empresas con presencia activa en redes sociales.
6. Configuración de Escucha Social: Recopila rápidamente cuentas oficiales para monitorear menciones de marca.
7. Prospección B2B: Combina con datos de Yellow Pages para construir perfiles completos de inteligencia empresarial.
8. Evaluación de Socios: Evalúa la huella digital de un posible socio comercial usando solo su nombre.
9. Construcción de Directorios: Automatiza la recopilación de enlaces de sitios web y redes sociales para un directorio de negocios local.
10. Seguimiento de Marcas: Rastrea todos los canales de contacto oficiales de marcas específicas en la web.