Skip to content

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

  1. Na raiz do seu projeto de script Mbbrowser, crie um arquivo chamado .cursor/rules/mbbrowser.mdc.
  2. Copie e cole todo o conteúdo abaixo nesse arquivo e salve-o.
  3. Reinicie o Chat do Cursor (ou inicie um novo Chat).
  4. 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:

  1. Na raiz do projeto, crie uma pasta chamada .agent/rules/.
  2. Crie um arquivo chamado mbbrowser.md nessa pasta.
  3. 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.