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.