LinkedIn Automator

IMPORTANTE

Copyright (c) 2024 [Alejandro Gonzalez Venegas]

Esta obra está bajo una Licencia Creative Commons Atribución-NoComercial 4.0 Internacional. https://creativecommons.org/licenses/by-nc/4.0/

Descripción

LinkedIn Automator es un web-scrapper que permite realizar búsquedas de personas en LinkedIn.

Para ello, utiliza el webdriver de Google Chrome y un entorno virtual que tendrás que configurar (y te diré cómo).

IMPORTANTE: esta aplicación respeta las Condiciones de Uso de LinkedIn porque no plagia las características de Sales Navigator ni de LinkedIn Premium

Requisitos

• Es fundamental que Google Chrome, Python y Git estén instalados en tu equipo.
• Antes de empezar a utilizar la aplicación, es recomendable que inicies sesión manualmente en tu cuenta de LinkedIn con Google Chrome.
  • Es posible que LinkedIn Automator te muestre mensajes de error al intentar acceder a tu cuenta en tu nombre: se debe al control que hace LinkedIn de los posibles comportamientos de bot.
  • También es posible que durante la ejecución, LinkedIn te pida algún código de verificación o 'captcha'; sigue las instrucciones en la pantalla.

Solo si utilizas Debian o Ubuntu

Tendrás que instalar Python de la siguiente manera

sudo apt install python3 python3-venv
sudo apt install virtualenv python3-virtualenv

Solo si utilizas Windows

Necesitarás que tu terminal tenga permisos para ejecutar scripts:

• Abre PowerShell como administrador y ejecuta: $ Get-ExecutionPolicy
• Si el retorno es Unrestricted, significa que ya está habilitado
• Si el retorno es Restricted, ejecuta: $ Set-ExecutionPolicy Unrestricted
• Contesta con S o Y para confirmar el cambio

PARA INSTALAR

Windows

1. Descarga el fichero install.ps1
2. Click derecho -> "Ejecutar como script de PowerShell"
3. Pulsa INTRO y Z para confirmar la ejecución

Linux / MacOS

1. Descarga el fichero install.sh
2. Abre la terminal de comandos (Terminal)
3. Sitúate en la carpeta donde lo hayas descargado
4. Otorga permisos de ejecución al script: chmod +x install.sh
5. Escribe ./install.sh
6. Pulsa INTRO

PARA EJECUTAR

Windows

1. Descarga el fichero run.ps1
2. Click derecho -> "Ejecutar como script de PowerShell"
3. Carga esta dirección en cualquier navegador:

http://localhost:5000/

Linux / MacOS

1. En la terminal de comandos, desplázate a la carpeta linkedin_automator
2. Arranca el entorno virtual:

source venv/bin/activate

3. Ejecuta el servicio:

flask run

4. Carga esta dirección en cualquier navegador: http://localhost:5000/

PARA FINALIZAR

Windows

1. Descarga el fichero stop.ps1
2. Click derecho -> "Ejecutar como script de PowerShell"

Linux / MacOS

1. En la terminal de comandos, presiona Ctrl + c para detener el servicio de Flask.
2. Desactiva el entorno virtual:

deactivate

PARA ACTUALIZAR

Windows

1. Descarga el fichero update.ps1
2. Click derecho -> "Ejecutar como script de PowerShell"

Linux / MacOS

1. Con la terminal de comandos, desplázate a la carpeta linkedin_automator
2. Actualiza el repositorio:

git pull origin main

CONFIGURACIÓN INICIAL (Nueva instalación)

⚠️ IMPORTANTE: Después de instalar, debes configurar las variables de entorno:

Todos los sistemas

1. Copia el archivo de ejemplo:

cp .env.example .env

2. Genera una clave secreta única:

python3 -c "import secrets; print(secrets.token_hex(32))"

3. Edita el archivo .env y reemplaza SECRET_KEY con la clave generada

# Linux/MacOS
nano .env

# Windows (usa tu editor preferido)
notepad .env

4. Inicializa la base de datos:

python3 init_db.py

Nota: El archivo .env es privado y NO debe compartirse. Cada instalación debe tener su propia clave.

Para más detalles, consulta SECURITY_UPDATE.md