Introdução

Gabinete360 API

O Gabinete360 é detecção de mudanças como infraestrutura — o Git da web. Aponte-o para qualquer página, feed ou API e consuma eventos de mudança estruturados e com data e hora via REST, webhooks e MCP.

Autenticação

Crie uma chave de API e autentique sua primeira requisição.

Referência da API

Todos os endpoints com exemplos reais de requisição e resposta.

Webhooks

Receba eventos em tempo real e verifique a assinatura HMAC.

Servidor MCP

Conecte o Claude ou o Cursor ao Gabinete360 em um único bloco de configuração.

Conceitos centrais

O fluxo de dados é simples: Pulse dispara → busca a Source → Snapshot → Delta → Event → Channel. Você cria projetos e alvos, o Gabinete360 os monitora em uma agenda e você recebe eventos sempre que algo relevante muda.

Project: Um grupo nomeado de alvos com um painel unificado — por exemplo, "Preços dos concorrentes".
Target: Uma única URL sendo monitorada, com seu extrator, filtro de importância e configuração de pulse.
Pulse: A agenda de verificação de um alvo (intervalo / cron / horário do dia) com backoff.
Snapshot: Uma captura — baixada e com hash — de um alvo em um determinado momento.
Delta: Uma mudança detectada entre dois snapshots, com tipo, severidade e camada de detecção.
Event: Uma mudança voltada ao usuário — um delta que passou pelo filtro de importância. É isto que você consome.
Channel: Um destino de entrega para eventos: no app, e-mail, webhook, Slack e outros.

O modelo de detecção em 4 camadas

Cada verificação passa por um pipeline ordenado por custo, para que as camadas baratas capturem a maioria das mudanças antes que as caras rodem: L1 byte-hash (algum byte mudou?), L2 DOM-hash (a estrutura mudou?), L3 SimHash (o conteúdo mudou de forma relevante?) e L4 diff semântico por IA (o que mudou, em linguagem natural?). Cada evento carrega a detectionLayer que o produziu.

Hash antes da IA

A maioria das verificações se resolve nas camadas L1–L3 por frações de centavo. A camada de IA só roda quando as camadas mais baratas sinalizam uma mudança real — mantendo o monitoramento barato em escala.

URL base

Todas as requisições à API são feitas para https://gabinete360.ia.br/api/v1. A API fala JSON sobre HTTPS e tem escopo limitado à assinatura dona da sua chave de API.