Documentación de AdShadow

AdShadow es un navegador antidetección para gestionar muchas cuentas desde un solo equipo. Cada perfil es un navegador aislado con su propia huella digital, su proxy, sus cookies y su sesión.

Instalación

Requisitos: Windows 10 u 11 de 64 bits y unos 1,5 GB libres. No hace falta tener Chrome ni instalar nada más: el instalador trae el navegador y todas sus librerías.

1. Descarga AdShadow-Setup.exe.
2. Ábrelo. Si Windows SmartScreen muestra «Windows protegió su PC», pulsa Más información y luego Ejecutar de todos modos. El aviso aparece porque el instalador aún no tiene firma digital de editor.
3. Sigue el asistente. Se instala para tu usuario, sin pedir permisos de administrador, y crea un acceso directo en el menú Inicio.

Para comprobar que el archivo descargado no se alteró, compara su huella SHA-256 con esta:

(se publica junto con cada versión)

certutil -hashfile AdShadow-Setup.exe SHA256

Actualizar: descarga el instalador nuevo y ejecútalo encima. Tus perfiles se conservan.

Desinstalar: Configuración de Windows, Aplicaciones, AdShadow, Desinstalar. Haz antes un respaldo si quieres conservar tus perfiles.

Cuenta y licencia

La primera vez que abres AdShadow aparece la ventana Cuenta y licencia. Crea tu cuenta con tu nombre, correo y una contraseña; la prueba gratuita se activa al instante en ese equipo.

• Perfiles activos son los que no están en la papelera.
• Proxies distintos cuenta los de tu lista de proxies, el proxy global y los escritos a mano en perfiles activos. El mismo proxy usado en varios perfiles cuenta una sola vez.
• Al llegar al límite no puedes crear, importar ni restaurar perfiles, ni agregar otro proxy distinto. Lo que ya tienes sigue funcionando: puedes abrir tus perfiles, editarlos y cambiar su proxy por el que ya tienes.
• El plan Pro se activa sobre tu misma cuenta; no hay que reinstalar. Abre la tarjeta de licencia de la barra lateral y pulsa Actualizar licencia para verlo al momento (la app también lo revisa al abrir y cada 6 horas).
• La licencia queda ligada al equipo donde iniciaste sesión. La cuenta de AdShadow es independiente de la de Context Code, aunque uses el mismo correo.
• La licencia se comprueba sin conexión con una firma digital, así que AdShadow sigue funcionando aunque te quedes sin internet un tiempo.

Perfiles

Un perfil es un navegador completo y aislado: sus cookies, su historial, su almacenamiento local y sus extensiones no se mezclan con los de otro perfil.

• Crear: botón Nuevo perfil. Ponle nombre, grupo, proxy y, si quieres, la cuenta que va a usar.
• Abrir: botón Abrir de la fila. La ventana del navegador y su icono en la barra de tareas muestran el número del perfil para distinguirlos.
• Organizar: grupos y etiquetas, búsqueda, y orden por cualquier columna pulsando su encabezado.
• Papelera: los perfiles borrados van a la papelera y se pueden restaurar.

Huella digital

La huella se aplica dentro del motor del navegador, que es un Chromium compilado por nosotros, y no con scripts que una página pueda detectar. Cada perfil recibe al crearse una huella coherente que se mantiene igual en cada apertura:

• Agente de usuario, plataforma, núcleos de CPU y memoria.
• Resolución de pantalla, zona horaria e idioma, que pueden seguir automáticamente al país del proxy.
• WebGL (fabricante y renderizador) y ruido estable en canvas, audio y client rects.
• Geolocalización y WebRTC, para que no se filtre tu IP real.

Para cambiarla, abre el menú del perfil (clic derecho en la fila) y elige Nueva huella o Editar huella digital.

Proxies

• Tipos admitidos: http, https y socks5, con usuario y contraseña opcionales.
• Lista de proxies: guárdalos una vez en la sección Proxies y asígnalos a varios perfiles. Desde allí puedes comprobar la IP y el país.
• Proxy global: los perfiles configurados con «Proxy global» usan el que definas con el botón Proxy global (icono del globo sobre la tabla de perfiles).
• Astroproxy: en la pestaña Astroproxy de la sección Proxies pega tu token, carga tus puertos e impórtalos. Los proxies de Astroproxy tienen un botón para cambiar la IP.

Importar cuentas

Hay dos caminos:

• Importar (menú izquierdo): pega el texto o elige un archivo.
• Importar perfiles (barra de la tabla): acepta un .json exportado de AdShadow o un .txt de cuentas, y crea un perfil por cuenta.

Formatos de línea admitidos:

• Las cuentas repetidas, ya sea dentro del archivo o porque ya existen en otro perfil, se omiten. Al terminar verás la línea y el motivo de cada omisión.
• Las cookies se guardan cifradas y se cargan al abrir el perfil.
• Con la prueba gratuita solo se importan perfiles hasta completar 2 activos.

2FA y autollenado

Si la cuenta tiene una clave 2FA (TOTP), AdShadow genera el código de 6 dígitos cuando lo necesitas, sin otra aplicación. En perfiles de Facebook puede completar el inicio de sesión con el usuario, la contraseña y el código 2FA guardados.

Respaldos

En la sección Gestión, pulsa Crear copia de seguridad: guarda todo (perfiles, cuentas, cookies, proxies, grupos y etiquetas) en una carpeta. Copia esa carpeta a otro equipo y pulsa Restaurar allí para tenerlo todo igual. Haz una copia antes de desinstalar o de cambiar de equipo.

API local

AdShadow expone una API en tu equipo, compatible con la de AdsPower, en http://127.0.0.1:50360. Si el puerto está ocupado (por ejemplo, porque AdsPower está abierto), usa el 50361, 50362 o 50363. El puerto activo se ve en la sección API & MCP.

Versión 1

• /status
• /api/v1/browser/start|stop|active|local
• /api/v1/user/create|list|update|delete|regroup
• /api/v1/group/create|list|update
• /api/v1/proxy/*, /api/v1/astroproxy/*, /api/v1/account/*

Versión 2

• /api/v2/browser-profile/start|stop|list|create|update|delete|active|cookies|ua|new-fingerprint|delete-cache|close-all|arrange|move-group|restore|autofill
• /api/v2/browser-tags/*, /api/v2/group/*, /api/v2/proxy-list/*

Ejemplo: abrir un perfil y conectarse con Puppeteer

curl "http://127.0.0.1:50360/api/v1/browser/start?user_id=kb53dcdd"

La respuesta incluye ws.puppeteer y debug_port:

const puppeteer = require('puppeteer-core');
const r = await fetch('http://127.0.0.1:50360/api/v1/browser/start?user_id=kb53dcdd').then(r => r.json());
const browser = await puppeteer.connect({ browserWSEndpoint: r.data.ws.puppeteer });
const page = await browser.newPage();
await page.goto('https://example.com');

Con Playwright usa chromium.connectOverCDP(r.data.ws.puppeteer); con Selenium, el debug_port como debuggerAddress.

Los límites de la licencia también se aplican a la API: crear perfiles o proxies por encima del plan devuelve un error.

Datos y seguridad

• Todo se guarda en tu equipo, en la carpeta data dentro de la carpeta de instalación (por defecto %LOCALAPPDATA%\AdShadow).
• Contraseñas, claves 2FA, cookies y contraseñas de proxy van cifradas.
• Nuestro servidor solo guarda tu cuenta de AdShadow (nombre, correo y contraseña cifrada), tu licencia y un identificador resumido de tu equipo. Nunca recibe tus perfiles, cuentas ni cookies.
• La API local solo escucha en 127.0.0.1: no es accesible desde otros equipos.

Solución de problemas

Windows bloquea el instalador

Pulsa Más información y luego Ejecutar de todos modos. Si tu antivirus lo pone en cuarentena, restáuralo y agrega una excepción para la carpeta de AdShadow: el navegador modificado suele generar falsos positivos.

El perfil no abre o se cierra al instante

Cierra AdShadow y ábrelo de nuevo: al abrir un perfil la app corrige los permisos que necesita el navegador. Si sigue fallando, reinstala encima con el instalador más reciente.

«Inicia sesión con tu cuenta de AdShadow»

No hay una sesión activa en este equipo. Abre la tarjeta de licencia de la barra lateral e inicia sesión.

«Tu plan permite N perfiles» o «N proxy(s)»

Llegaste al límite de tu plan. Envía perfiles a la papelera, reutiliza el proxy que ya tienes o pasa a Pro.

La API no responde en el puerto 50360

Otro programa lo está usando. Mira el puerto activo en la sección API & MCP.