Pacote de Regras do ApiServer do Mbbrowser
Esta é a parte mais crítica desta coluna. Ao injetar o seguinte pacote de regras no Cursor ou Antigravity, o modelo de IA dominará totalmente todas as interfaces do ApiServer do Mbbrowser, códigos de erro e parâmetros do apêndice, garantindo que ele nunca tenha "alucinações" ao escrever scripts.
Como Usar
Para Usuários do Cursor
- Na raiz do seu projeto de script Mbbrowser, crie um arquivo chamado
.cursor/rules/mbbrowser.mdc. - Copie e cole todo o conteúdo abaixo nesse arquivo e salve-o.
- Reinicie o Chat do Cursor (ou inicie um novo Chat).
- A IA carregará automaticamente esse conhecimento em todas as conversas subsequentes.
Para Usuários do Antigravity
O Antigravity (IDE focado em agentes do Google) possui seu próprio sistema de regras e usa um diretório independente .agent/rules/.
Etapas:
- Na raiz do projeto, crie uma pasta chamada .agent/rules/.
- Crie um arquivo chamado mbbrowser.md nessa pasta.
- Copie e cole as especificações e modelos do "Pacote de Regras do ApiServer do Mbbrowser" no arquivo e salve-o.
Pacote de Regras do ApiServer do Mbbrowser
Por favor, copie todo o conteúdo abaixo e substitua o conteúdo no arquivo mencionado acima.
markdown
# Especificação Completa de Desenvolvimento Mbbrowser (MBBrowser) + ApiServer
## 1. Resumo do Produto
> [!IMPORTANT]
> **Segredo de Desempenho**: Antes de executar a automação em larga escala, certifique-se de que o cliente Mbbrowser esteja no **"Modo Local"**. Isso ignora a sincronização de dados na nuvem, aumentando a velocidade de inicialização em dezenas de vezes.
O Mbbrowser é um navegador de impressão digital profissional para isolamento de ambiente multi-conta.
O ApiServer (apiserver.exe) é o serviço de API HTTP local exposto pelo Mbbrowser, permitindo que scripts controlem ambientes de navegador de forma programática.
## 2. Inicialização do ApiServer
```bash
apiserver.exe --port=8186 --app_id=SUA_ID --app_key=SUA_KEY
```
## 3. Padrões de Comunicação
- Todas as interfaces são solicitações HTTP POST.
- Content-Type: application/json.
- URL Base: http://127.0.0.1:8186.
- code=0 para sucesso.
## 4. Interfaces Principais
### 4.1 Abrir Ambiente
POST /api/v1/browser/start
```json
{
"Session_ID": ["id_do_ambiente"],
"isHeadless": false
}
```
[Extremamente Importante] Integração para cada framework:
Python Playwright:
```python
ws_endpoint = f"ws://127.0.0.1:{port}/json/version"
browser = pw.chromium.connect_over_cdp(ws_endpoint)
context = browser.contexts[0] # DEVE USAR CONTEXTO EXISTENTE
```
## 5. Tabela de Códigos de Erro
0 Sucesso; -105 Falha na validação do proxy; -106 Erro de fuso horário.