API de automatización local
Abra “API de automatización” en la barra lateral y haga clic en “Iniciar API local”. Prism muestra la dirección de la API (un puerto aleatorio en 127.0.0.1) y el token de acceso de esta sesión; el token se muestra una sola vez y deja de ser válido al detener la API.
| Solicitud | Función |
|---|---|
| GET /v1/status | Estado del servicio |
| GET /v1/profiles | Lista los perfiles: número, nombre, grupo, etiquetas, estado y última apertura |
| GET /v1/profiles/{id}/status | Consulta el estado de un perfil |
| POST /v1/profiles/{id}/start | Inicia un perfil, con la misma comprobación previa del proxy y el mismo límite de simultaneidad que la interfaz |
| POST /v1/profiles/{id}/close | Cierra un perfil |
| POST /v1/profiles | Crea un perfil con el nombre, el grupo, el proxy y la huella digital que elija (desde la versión 0.3.22) |
| POST /v1/profiles/batch | Crea de 1 a 50 perfiles a la vez y solo los guarda si todos son válidos (desde la versión 0.3.22) |
curl -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles
curl -X POST -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles/$PROFILE_ID/start- Solo acepta solicitudes del propio equipo: el encabezado Host debe coincidir con la dirección de la API, y se rechazan las solicitudes con encabezado Origin de navegador o parámetros de consulta (solo los endpoints de creación aceptan un cuerpo JSON), por lo que las páginas web no pueden llamarla directamente.
- Como máximo 120 solicitudes por minuto (límite compartido con el puente local de MCP).
- La API puede crear, consultar, iniciar y cerrar perfiles, pero no modificarlos ni eliminarlos, ni tampoco leer datos del navegador. La API en sí no ofrece un endpoint de depuración para Puppeteer / Playwright (la versión para Windows abre un puerto de depuración aleatorio en 127.0.0.1 para su control interno, pero no es una interfaz pública).
- “Parada de emergencia” cierra los perfiles iniciados por la API; las llamadas se anotan en un registro de auditoría local.
Consulte las reglas de solicitud, los campos de respuesta, los códigos de error y los ejemplos en Python / Node.js en la referencia de la API local.
Tareas programadas locales
| Ajuste | Valores posibles |
|---|---|
| Acción | Iniciar perfil / Cerrar perfil |
| Modo de repetición | Una vez / Diario / Semanal (se pueden elegir varios días, de domingo a sábado) |
| Hora de ejecución | Hora local y zona horaria del equipo |
| Ejecución perdida | Ejecutar una vez si han pasado menos de 24 horas / Omitir esta ejecución |
| Reintentar en caso de fallo | 0–3 reintentos, con un intervalo de 1–60 minutos |
- Las tareas programadas solo se ejecutan mientras Prism está abierto; no hay ningún proceso residente en segundo plano. Cada 15 segundos se comprueba si hay tareas pendientes y se ejecutan como máximo 2 a la vez.
- Puede probar una tarea con “Ejecutar ahora”; para eliminar un perfil al que hace referencia una tarea programada, primero hay que eliminar esa tarea.
- Si la licencia Pro deja de ser válida, la programación se pausa; las tareas se conservan y todavía se pueden desactivar o eliminar.
Ejemplos de uso combinado
Perfiles de trabajo listos al empezar la jornada
Inicie cada día a las 09:00 los perfiles habituales y ciérrelos antes de terminar la jornada, con menos pasos manuales y menos aperturas por error.
Inicio y cierre por lotes con scripts
En su propio script, llame primero a GET /v1/profiles para obtener los ID de los perfiles y luego inícielos en orden; el inicio sigue la misma lógica que en la interfaz.
La IA toma el relevo
Una vez iniciados los perfiles, MCP lee las páginas y completa los pasos siguientes en los perfiles que usted haya autorizado.
Preguntas frecuentes
- ¿Se pueden ejecutar scripts personalizados o flujos RPA?
- Las tareas programadas solo pueden iniciar y cerrar perfiles, y la API tampoco ejecuta scripts. Para acciones dentro de las páginas, puede usar MCP de Pro o instalar sus propias extensiones en el perfil.
- ¿Es compatible con la API de otros navegadores antidetect?
- No. Prism usa su propia interfaz local; las rutas están en la tabla anterior.
- ¿Se ejecutan las tareas programadas con Prism cerrado?
- No. Las tareas programadas necesitan que Prism esté abierto; según la configuración, una ejecución perdida puede realizarse una vez dentro de las 24 horas siguientes.