Pular para o conteúdo
Todas as novidades
Novo

Clone sites pelo seu código ou agente de IA

Inicie a clonagem de um site com uma única chamada de API. Autentique-se com uma chave de API ou OAuth e receba um webhook assinado quando o clone ficar pronto ou falhar.

A robot arm turning a key in a server, looped back to a webhook bell

Uma API para clonar sites, feita para apps e agentes

A Clone API permite que seu app, script ou agente de IA inicie a clonagem de um site e seja avisado quando ela terminar — sem precisar de navegador.

Autentique-se com chave de API ou OAuth

  • Chave de API: crie uma na página Developers e envie-a como Bearer token.
  • OAuth 2: apps e agentes podem se registrar sozinhos e pedir acesso ao usuário. A descoberta fica em /.well-known/oauth-authorization-server.
  • Sem chave para colar: um agente pode pedir que você confirme um código de 6 dígitos. Veja o auth.md.

O acesso é dividido em escopos — criar solicitações de clone, lê-las —, para que cada ferramenta receba só o que precisa.

Inicie um clone e receba um webhook

  1. POST /api/v1/clone-requests com a URL de origem e uma Idempotency-Key, para que uma nova tentativa nunca inicie um segundo clone.
  2. Acompanhe o progresso com GET /api/v1/clone-requests/{id}, ou simplesmente aguarde.
  3. Chamamos sua callbackUrl com clone.ready ou clone.failed. Todo webhook é assinado com HMAC-SHA256 (Standard Webhooks). Se seu servidor estiver fora do ar, tentamos de novo até seis vezes ao longo de cerca de 14 horas.

Teste de graça

Uma chamada de preflight verifica sua chave, a requisição e a configuração do webhook sem cobrar nada. Uma execução de teste passa pelo fluxo completo — incluindo webhooks assinados reais — por zero créditos.

Use com um agente de IA via MCP

Um servidor MCP em /mcp oferece a agentes como o Claude as mesmas ações como ferramentas, para que eles iniciem e acompanhem clones por conta própria.

Preços e limites

Cada clone custa créditos do mesmo saldo do site, e um clone que falha devolve os créditos automaticamente. Cada chave de API pode fazer 60 requisições por minuto. A referência completa está no guia da Clone API.

Também nesta versão

  • NovoExecuções de teste e verificações prévias são gratuitas
  • NovoUm servidor MCP para que agentes de IA clonem sites diretamente
  • NovoGuias em sete idiomas

Perguntas frequentes

Como faço a autenticação na Clone API?

Use uma chave de API da página Developers como Bearer token, ou OAuth 2 se você estiver criando um app ou agente que age em nome de outros usuários.

Posso testar a API sem gastar créditos?

Sim. As verificações prévias (preflight) são gratuitas, e uma execução de teste envia webhooks assinados reais por zero créditos.

Como verifico a assinatura de um webhook?

Calcule o HMAC-SHA256 com seu segredo `whsec_` sobre `webhook-id.webhook-timestamp.body`, codifique em base64 e compare com o valor `v1,` no cabeçalho `webhook-signature`. Use o `webhook-id` para ignorar duplicados.

E se meu servidor estiver fora do ar quando um clone terminar?

Tentamos de novo até seis vezes ao longo de cerca de 14 horas. Qualquer resposta 2xx conta como entregue; redirecionamentos não.

Um agente de IA pode usar o clonesite?

Sim — pelo servidor MCP em `/mcp`, ou pela API com OAuth ou com o fluxo de confirmação por código de 6 dígitos.

Existe limite de requisições?

60 requisições por minuto por chave de API. Acima disso, você recebe uma resposta 429.