¿Cansado de agregar contactos de WeChat uno por uno? La tarea repetitiva de buscar, añadir y esperar confirmaciones consume tiempo valioso y puede llevar a errores. Presentamos una solución integral basada en Python para automatizar la adición de contactos de WeChat, multiplicando tu eficiencia laboral. Este proyecto de código abierto utiliza la tecnología ADB para simular interacciones humanas, permitiendo la importación masiva de números de teléfono, el cambio inteligente de cuentas y el registro automático de resultados. Es una herramienta indispensable para la gestión de comunidades, la expansión de ventas y la organización de eventos.

Desafíos de la Adición Manual

La adición manual de contactos en WeChat presenta varios inconvenientes:

• Baja Eficiencia: Cada adición requiere múltiples pasos, incluyendo búsqueda, envío de solicitud y espera de aprobación.
• Errores Frecuentes: Es fácil cometer errores como añadir duplicados, omitir números o realizar operaciones incorrectas.
• Alto Costo de Tiempo: Agregar cientos de contactos puede consumir un día entero.
• Riesgo de Bloqueo: Las operaciones masivas y repetitivas pueden activar las medidas de seguridad de WeChat.

Estos problemas obstaculizan la productividad y el crecimiento del negocio, haciendo necesaria una solución inteligente.

Visión General de la Solución

Esta herramienta de automatización de adición de contactos de WeChat es un proyecto de código abierto que emplea Python y ADB para simular clics y automatizar todo el proceso. Sus principales beneficios incluyen:

• Procesamiento en Lote: Maneja miles de números de teléfono de una sola vez.
• Mecanismo Anti-Bloqueo: Incorpora intervalos de operación razonables para minimizar el riesgo de suspensión de cuenta.
• Soporte Multi-Cuenta: Permite el cambio automático entre diferentes cuentas de WeChat.
• Registro Completo: Detalla los resultados de cada adición y los motivos de los fallos.
• Compatibilidad Multiplataforma: Funciona en Windows, Linux y macOS.

El proyecto se organiza en módulos clave:

• main.py: Lógica principal y control del flujo del programa.
• adb.py: Interacción con dispositivos Android a través de comandos ADB.
• file_handler.py: Procesamiento de datos y guardado de resultados.
• config/config.json: Archivo de configuración con todos los parámetros.
• run.py: Punto de entrada y análisis de argumentos.

Configuración Rápida

Requisitos del Entorno

• Python 3.3 o superior.
• Teléfono Android con depuración USB habilitada.
• Aplicación WeChat instalada en el teléfono.
• (Opcional) Permiso de "simulación de clics" habilitado en algunos teléfonos.

Instalación y Despliegue

# Clonar el repositorio
git clone https://gitcode.com/gh_mirrors/au/auto_add_wechat_friends_py

# Navegar al directorio del proyecto
cd auto_add_wechat_friends_py

# Crear y activar un entorno virtual (recomendado)
python -m venv venv
source venv/bin/activate  # En Linux/macOS
# o venv\Scripts\activate  # En Windows

# Verificar la versión de Python
python --version

Configuración Básica

El archivo de configuración principal se encuentra en config/config.json. Un ejemplo de configuración es:

{
    "operation_mode": "sequential",
    "wechat_accounts": ["+8617376509219", "xiaomihehuo"],
    "sequential_numbers": [13029620003, 13029620016],
    "data_file_path": "/data/phone_numbers.txt",
    "batch_save_threshold": 10,
    "interval_minutes": 30,
    "account_switch_interval": 4
}

Parámetros de Configuración:

• operation_mode: Modo de ejecución ("file" para modo archivo, "sequential" para modo secuencial).
• wechat_accounts: Lista de cuentas de WeChat para alternar.
• sequential_numbers: Rango de números de teléfono para el modo secuencial.
• data_file_path: Ruta al archivo que contiene los números de teléfono.
• batch_save_threshold: Número de registros a acumular en memoria antes de guardar.
• interval_minutes: Tiempo de espera entre operaciones (en minutos).
• account_switch_interval: Número de cambios de cuenta antes de iniciar un intervalo de espera.

Preparación de Datos

Cree un archivo llamado phone_numbers.txt en el directorio data/, con un número de teléfono por línea:

13800138000
13900139000
13700137000

Inicio del Programa

# Iniciar con configuración por defecto
python main.py --daemon

# Iniciar para un dispositivo específico
python main.py --serial-device DISPOSITIVO_ID

# Iniciar en un puerto específico
python main.py --port PUERTO

# Ver ayuda
python main.py --help

Funcionalidades Clave por Escenario

Escenario 1: Gestión de Comunidades

1. Preparar Lista: Organice los números de teléfono de los nuevos miembros en phone_numbers.txt.
2. Configurar Parámetros: Establezca intervalos de adición adecuados (ej. 1-2 minutos).
3. Iniciar Automatización: El programa buscará, añadirá y registrará los resultados automáticamente.
4. Verificar Resultados: Los resultados se guardan en el directorio ./results/.

Configuración Recomendada:

{
    "operation_mode": "file",
    "wechat_accounts": ["CuentaComunidad1", "CuentaComunidad2"],
    "data_file_path": "data/members.txt",
    "batch_save_threshold": 20,
    "interval_minutes": 60,
    "account_switch_interval": 5
}

Escenario 2: Expansión de Clientes para Ventas

La herramienta facilita la adición masiva de clientes potenciales:

• Importación Flexible: Soporte para importar datos desde archivos Excel o CSV.
• Control de Ritmo Inteligente: Evita la detección por parte de WeChat.
• Rotación de Cuentas: Alterna entre cuentas de ventas para distribuir la carga.
• Análisis de Resultados: Genera informes de tasa de éxito.

Escenario 3: Gestión de Participantes de Eventos

Ideal para añadir rápidamente a todos los asistentes:

• Adición Masiva Rápida: Procesa cientos de números de forma eficiente.
• Manejo de Verificaciones: Gestiona inteligentemente diversos escenarios de verificación.
• Reitnentos Automáticos: Maneja interrupciones de red.
• Monitoreo en Tiempo Real: Seguimiento del progreso a través de los logs.

Escenario 4: Gestión de Contactos para Comerciantes

Expanda su red de contactos de manera continua:

• Ejecución Programada: Integración con herramientas como cron para tareas automáticas.
• Procesamiento Paralelo: Soporte para múltiples dispositivos simultáneamente.
• Mensajes Personalizados: Extensible para mensajes de solicitud de amistad personalizados.
• Protección de Datos: Almacenamiento local para garantizar la privacidad.

Configuración Avanzada

Estrategias de Cambio de Cuenta

El cambio automático de cuentas evita operaciones excesivas en una sola:

"wechat_accounts": ["CuentaA", "CuentaB", "CuentaC", "CuentaD"]

Lógica de Cambio:

• Uso secuencial de las cuentas listadas.
• Cambio automático tras un número predefinido de operaciones por cuenta.
• Cambio inmediato si se encuentra un fallo de verificación.
• Entrada en modo de espera tras agotar todas las cuentas.

Modos de Operación

Modo Archivo (file):

• Lee números de un archivo especificado (TXT, CSV, etc.).
• Filtra automáticamente números inválidos o duplicados.
• Soporta el procesamiento de archivos grandes en lotes.

Modo Secuencial (sequential):

• Genera números dentro de un rango especificado.
• Omite rangos de números inválidos.
• Útil para pruebas y validación de rangos de números.

Optimización de Rendimiento

Gestión de Memoria:

• El parámetro batch_save_threshold controla el uso de memoria (recomendado: 10-50).
• Guarda datos acumulados periódicamente para prevenir pérdidas.
• Soporte para reanudación de procesos interrumpidos.

Control de Ritmo:

• interval_minutes (30-120): Tiempo de espera entre operaciones.
• account_switch_interval (3-5): Frecuencia de cambio de cuenta.
• Ajuste de parámetros según las normativas de WeChat para evitar bloqueos.

Mejores Prácticas

Guía de Uso Seguro

• Cumplir Normativas: Ajuste la frecuencia de adición para evitar medidas de seguridad.
• Respaldo de Datos: Haga copias de seguridad periódicas de los archivos en el directorio results/.
• Protección de Cuentas: No incluya contraseñas reales en la configuración.
• Estabilidad de Red: Asegure una conexión a internet estable en el dispositivo móvil.

Consejos para Mejorar la Eficiencia

• Procesamiento por Lotes: Divida grandes listas de números en archivos más pequeños.
• Elección de Horarios: Realice las operaciones durante horas laborales.
• Procesamiento Paralelo: Use múltiples dispositivos para acelerar el proceso.
• Análisis de Errores: Revise los motivos de fallo para optimizar la estrategia.

Solución de Problemas Comunes

• Sin Respuesta al Iniciar: Verifique si la depuración USB está habilitada y si ADB está conectado correctamente.
• Alta Tasa de Fallos: Aumente el valor de interval_minutes y revise la conexión a internet.
• Cómo Ver Logs: Consulte la salida en la consola y los archivos en el directorio results/.
• Soporte iOS: Actualmente solo se soporta Android. Para iOS se requiere jailbreak y configuración especial.

Arquitectura Técnica

Principio de Funcionamiento

El proyecto se basa en ADB para la automatización:

1. Análisis de Pantalla: Se obtiene el layout XML de la pantalla actual mediante adb shell uiautomator dump.
2. Localización de Elementos: Se parsea el XML utilizando xml.etree.cElementTree en Python.
3. Cálculo de Coordenadas: Se calculan las coordenadas de clic exactas basándose en la posición de los elementos.
4. Simulación de Operaciones: Se ejecutan clics simulados con adb shell input tap.
5. Verificación de Estado: Se determina el éxito de la operación basándose en los cambios en la pantalla.

Componentes Clave

Encapsulación de Comandos ADB:

• Gestión de conexión de dispositivos.
• Ejecución de comandos y análisis de resultados.
• Manejo de errores y reintentos.

Motor de Análisis XML:

• Análisis rápido del layout de pantalla.
• Localización inteligente de elementos.
• Conversión y cálculo de coordenadas.

Módulo de Control de Flujo:

• Lógica de cambio entre cuentas.
• Mecanismos de recuperación de errores.
• Seguimiento del progreso y generación de reportes.

Diseño de Mecanismos de Seguridad

• Control de Intervalos: Evita operaciones demasiado frecuentes.
• Manejo de Excepciones: Recuperación ante caídas de red o fallos del programa.
• Protección de Datos: Almacenamiento local sin transmisión de información sensible.
• Auditoría de Logs: Registro completo de operaciones para facilitar la depuración.

Recursos de la Comunidad

Estructura de Documentación

• Guía de Uso: README.md - Instrucciones básicas y configuración.
• Ejemplo: test/adb_xml_parser.py - Ejemplo de análisis de XML con ADB.
• Configuración: config/config.json - Todos los parámetros de ejecución.
• Módulo Central: adb_handler.py - Código principal para la interacción con el dispositivo.

Guía de Desarrollo de Extensiones

Puede extender la funcionalidad del proyecto:

• Nuevas Funciones: Modifique main.py, expanda file_handler.py para soportar más formatos, o mejore la eficiencia en adb_handler.py.
• Mensajes Personalizados: Adapte los mensajes de solicitud de amistad, considere la personalización basada en datos del contacto y añada soporte para plantillas y variables.
• Soporte Multiplataforma: Desarrolle soporte para dispositivos iOS, implemente una interfaz web o integre almacenamiento en bases de datos.

Recursos Recomendados

• Documentación oficial de ADB.
• Prácticas recomendadas en automatización de pruebas UI con Python.
• Participación en foros y comunidades de código abierto.

¡Empiece Hoy Mismo su Viaje de Automatización!

Con esta guía, tiene las herramientas para automatizar la adición de contactos de WeChat. Deje de perder tiempo en tareas manuales y enfoque su energía en actividades de mayor valor.

Pasos para Comenzar:

1. Prepare su Entorno: Asegure tener Python y un dispositivo Android listos.
2. Obtenga el Proyecto: Clone el repositorio a su máquina.
3. Configure: Modifique el archivo config.json según sus necesidades.
4. Prepare los Datos: Tenga lista la lista de números a añadir.
5. Pruebe: Ejecute con una pequeña cantidad de números para verificar el funcionamiento.
6. Ejecute a Gran Escala: Una vez confirmado, proceda con la adición masiva.

Casos de Éxito:

• Equipos de gestión de comunidades han visto un aumento del 1500% en la eficiencia de adición de contactos.
• Equipos de ventas han duplicado su velocidad de captación de clientes potenciales.
• Organizadores de eventos han ahorrado el 80% del tiempo dedicado a la adición de participantes.

Trabaje de forma más inteligente, no más dura. Comience su automatización hoy y descubra nuevas posibilidades.

Nota Importante: Utilice esta herramienta respetando las normativas de WeChat y las leyes aplicables. Mantengamos un entorno en línea saludable.