browseract-ai/browseract

⚠️ Este repositório foi descontinuado

Este repositório não é mais mantido. Ele foi movido para um novo local:

➡️ browser-act/browseract-api-examples

Por favor, use o novo repositório para obter o código mais recente, correções de bugs e documentação.

Este repositório permanecerá disponível como um arquivo somente leitura.

---

Coleção de Demonstrações da API BrowserAct

Raspagem Web com IA e Automação - Qualquer Site, Sem Código, Sem Limites, Dados Confiáveis

Este repositório contém código de demonstração abrangente da API para BrowserAct, uma plataforma de raspagem web e automação baseada em IA. As demonstrações mostram como integrar os recursos de IA-Workflow do BrowserAct em suas aplicações usando várias linguagens de programação.

🚀 Início Rápido

🎯 Para Novos Usuários (Recomendado)

Comece com exemplos baseados em cenários que demonstram workflows completos:

• Python: Scenarios-Python - Exemplos completos combinando múltiplas APIs
  • scenario_1_run_and_wait.py - Executar workflow personalizado e aguardar conclusão
  • scenario_2_run_template_and_wait.py - Executar tarefa de template e aguardar conclusão (Melhor para iniciantes)
• Java: Scenarios-Java - Exemplos completos combinando múltiplas APIs
  • Scenario1RunAndWait.java - Executar workflow personalizado e aguardar conclusão
  • Scenario2RunTemplateAndWait.java - Executar tarefa de template e aguardar conclusão
• Node.js: Scenarios-NodeJs - Exemplos completos combinando múltiplas APIs
  • scenario1_runAndWait.js - Executar workflow personalizado e aguardar conclusão
  • scenario2_runTemplateAndWait.js - Executar tarefa de template e aguardar conclusão

📚 Para Referência da API

Escolha sua linguagem preferida e explore exemplos individuais da API:

Linguagem	API Workflow	Exemplos de Cenário	Início Rápido
Python	Workflow-Python	Scenarios-Python	python Scenarios-Python/scenario_1_run_and_wait.py
Java	Workflow-Java	Scenarios-Java	cd Scenarios-Java && mvn exec:java -Dexec.mainClass="com.browseract.scenarios.Scenario1RunAndWait"
Node.js	Workflow-NodeJs	Scenarios-NodeJs	node Scenarios-NodeJs/scenario1_runAndWait.js

📁 Estrutura do Projeto

browseract-api-demos/
├── Workflow-Python/       # Demos da API Workflow em Python
├── Workflow-Java/         # Demos da API Workflow em Java
├── Workflow-NodeJs/       # Demos da API Workflow em Node.js
├── Scenarios-Python/     # Exemplos baseados em cenários em Python (recomendado para novos usuários)
├── Scenarios-Java/        # Exemplos baseados em cenários em Java (recomendado para novos usuários)
├── Scenarios-NodeJs/      # Exemplos baseados em cenários em Node.js (recomendado para novos usuários)
├── .gitignore             # Regras de ignore do Git
└── README.md              # Este arquivo

🎯 O que é o BrowserAct?

O BrowserAct é uma plataforma de raspagem web e automação baseada em IA que fornece dois recursos principais:

🔄 IA-Workflow

• Templates Pré-definidos: Use workflows prontos para tarefas comuns de raspagem
• Workflows Personalizados: Crie suas próprias sequências de automação
• Processamento em Lote: Lide com múltiplas URLs e fontes de dados de forma eficiente

📚 Capacidades da API

Endpoints da API Workflow

Endpoint	Método	Descrição
/v2/workflow/run-task	POST	Iniciar uma nova tarefa de workflow
/v2/workflow/stop-task	PUT	Encerrar permanentemente uma tarefa
/v2/workflow/get-task	GET	Obter informações detalhadas da tarefa
/v2/workflow/get-task-status	GET	Obter apenas o status da tarefa
/v2/workflow/list-tasks	GET	Listar todas as tarefas
/v2/workflow/list-workflows	GET	Listar todos os workflows
/v2/workflow/get-workflow	GET	Obter detalhes do workflow

🛠 Suporte a Linguagens

Python

• Versão: Python 3.8+
• Dependências: requests para requisições HTTP
• Recursos: Código simples e legível com tratamento abrangente de erros
• Melhor para: Prototipagem rápida e workflows de ciência de dados

Java

• Versão: Java 8+
• Ferramenta de Build: Maven
• Dependências: Jackson para processamento JSON, HttpURLConnection para requisições HTTP
• Recursos: Código de nível empresarial com estrutura de pacotes adequada
• Melhor para: Aplicações empresariais e microsserviços

Node.js

• Versão: Node.js 14+
• Dependências: Módulo https embutido
• Recursos: Leve, abordagem assíncrona
• Melhor para: Aplicações web e funções serverless

🔧 Configuração

Antes de executar qualquer exemplo, você precisará:

1. Chave de API: Obtenha sua chave de API em Integrações do BrowserAct
2. ID do Workflow (para a API Workflow): Obtenha seu ID de workflow em Lista de Workflows

Atualize a configuração em cada arquivo de exemplo:

• Substitua "app-abcdefghijklmn" pela sua chave de API real
• Substitua 1234567890 pelo seu ID de workflow real

🔒 Melhores Práticas de Segurança

Importante: Os exemplos usam chaves de API placeholder para fins de demonstração. Em produção:

1. Nunca codifique chaves de API no seu código fonte
2. Use variáveis de ambiente ou arquivos de configuração seguros
3. Mantenha suas chaves de API confidenciais e rotacione-as regularmente

Exemplos de Variáveis de Ambiente

# Python
import os
authorization = os.getenv("BROWSERACT_API_KEY")

// Java
String authorization = System.getenv("BROWSERACT_API_KEY");

// Node.js
const authorization = process.env.BROWSERACT_API_KEY;

📖 Documentação

• Documentação da API: Documentação da API BrowserAct
• API Workflow: Referência da API Workflow

🤝 Suporte

• Comunidade no Discord: Entre no nosso Discord
• Suporte por E-mail: [email protected]
• Issues no GitHub: Reportar bugs ou solicitar funcionalidades

📄 Licença

Este código de demonstração é fornecido como está para fins educacionais e de desenvolvimento sob a Licença MIT.

🌟 Recursos

• Suporte a Múltiplas Linguagens: Implementações em Python, Java e Node.js
• Cobertura Completa da API: Todos os endpoints da API BrowserAct incluídos
• Pronto para Produção: Código de nível empresarial com tratamento adequado de erros
• Fácil de Usar: Exemplos simples que podem ser executados imediatamente
• Bem Documentado: Arquivos README abrangentes para cada linguagem
• Padrões Modernos: Segue as melhores práticas para cada linguagem

---

Pronto para começar? Escolha sua linguagem acima e mergulhe nos exemplos! 🚀

Visite BrowserAct para saber mais sobre nossa plataforma de raspagem web com IA.