API LOCAL · TAREFAS AGENDADAS · PRO

API local e tarefas agendadas: abra na hora certa, feche quando precisar.

Deixe a abertura e o fechamento de perfis a cargo de scripts ou de uma agenda. A API local escuta apenas no endereço de loopback do computador e usa um token de acesso gerado a cada inicialização; as tarefas agendadas são executadas pelo horário local enquanto o Prism está aberto. Os dois são recursos do Prism Pro.

Atualizado em 2026-10-03 · Com base no cliente Prism 0.3.22

API de automação local

Abra “API de automação” na barra lateral e clique em “Iniciar API local”. O Prism mostra o endereço da API (uma porta aleatória em 127.0.0.1) e o token de acesso da sessão; o token é exibido só uma vez e deixa de valer quando a API é parada.

Lista de endpoints
Requisição	Função
GET /v1/status	Status do serviço
GET /v1/profiles	Lista os perfis: número, nome, grupo, tags, status e horário da última abertura
GET /v1/profiles/{id}/status	Consulta o status de um perfil
POST /v1/profiles/{id}/start	Inicia um perfil, com a mesma verificação prévia de proxy e o mesmo limite de simultaneidade da interface
POST /v1/profiles/{id}/close	Fecha um perfil
POST /v1/profiles	Cria um perfil com o nome, o grupo, o proxy e a impressão digital que você escolher (a partir da 0.3.22)
POST /v1/profiles/batch	Cria de 1 a 50 perfis de uma vez, salvos só se todos forem válidos (a partir da 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

Só aceita requisições do próprio computador: o Host precisa coincidir com o endereço da API, e requisições com cabeçalho Origin de navegador ou parâmetros de consulta são recusadas (só os endpoints de criação aceitam corpo JSON), de modo que páginas da web não conseguem chamá-la diretamente.
No máximo 120 requisições por minuto (limite compartilhado com a ponte local do MCP).
A API cria, consulta, inicia e fecha perfis; não edita nem exclui perfis e não lê dados do navegador. A API em si não oferece endpoints de depuração para Puppeteer / Playwright (a versão para Windows abre uma porta de depuração aleatória em 127.0.0.1 para controle interno, que não é uma interface pública).
“Parada de emergência” fecha os perfis iniciados pela API; as chamadas são registradas no log de auditoria local.

Para regras de requisição, campos de resposta, códigos de erro e exemplos em Python / Node.js, veja a referência da API local.

Tarefas agendadas locais

Opções das tarefas agendadas (textos do aplicativo)
Configuração	Valores possíveis
Ação	Iniciar perfil / Fechar perfil
Modo de repetição	Uma vez / Diariamente / Semanalmente (um ou mais dias, de domingo a sábado)
Horário de execução	Horário e fuso horário do computador
Execução perdida	Executar uma vez em até 24 horas / Pular esta execução
Nova tentativa em caso de falha	0–3 vezes, com intervalo de 1–60 minutos

As tarefas agendadas só são executadas com o Prism aberto; não há processo residente em segundo plano. A cada 15 segundos, o Prism verifica as tarefas pendentes e executa no máximo 2 ao mesmo tempo.
Use “Executar agora” para testar uma tarefa; um perfil usado por uma tarefa agendada só pode ser excluído depois de removido da tarefa.
Se a licença Pro deixar de ser válida, o agendamento é pausado; as tarefas são mantidas e ainda podem ser desativadas ou excluídas.

Exemplos de uso combinado

Perfis de trabalho prontos no início do expediente

Inicie os perfis habituais todos os dias às 09:00 e feche-os antes do fim do expediente, com menos trabalho manual e menos aberturas por engano.

Iniciar e fechar em lote por script

No seu script, chame GET /v1/profiles para encontrar os IDs dos perfis e inicie-os em sequência; a lógica de inicialização é a mesma da interface.

Deixar a IA continuar

Depois que o perfil inicia, o MCP lê as páginas e conclui as etapas seguintes nos perfis que você autorizou.

Perguntas frequentes

Posso executar scripts personalizados ou fluxos de RPA?: As tarefas agendadas só iniciam e fecham perfis, e a API também não executa scripts. Para ações dentro das páginas, use o MCP do Pro ou instale extensões no perfil por conta própria.
É compatível com a API de outros navegadores antidetect?: Não. O Prism usa uma interface local própria; os caminhos estão na tabela acima.
As tarefas agendadas são executadas com o Prism fechado?: Não. As tarefas agendadas dependem do Prism em execução; conforme a configuração, uma execução perdida pode ser feita uma vez em até 24 horas.