Clonar site com API — feito para agentes de IA
Guia para desenvolvedores da Clone API da Clonesite via REST ou MCP hospedado. Crie uma API key ou use OAuth para agentes, adicione segredo de webhook só se precisar de callbacks e deixe o agente fazer preflight, criar solicitações, acompanhar status e baixar código React e Tailwind editável.
A maioria das APIs espera que uma pessoa leia a documentação, conecte as chamadas e fique acompanhando a integração. Esta não.
Com a Clone API da Clonesite, a pessoa faz o setup de confiança: cria uma key ou aprova login OAuth do agente. Se a integração precisa de callbacks, também revela um segredo de assinatura de webhook. Depois o agente faz o resto: preflight, teste mock gratuito, transforma uma URL real em código React e Tailwind editável, espera o build e baixa o ZIP.
Um passo humano; depois, o loop do agente: validar, criar, esperar, baixar.
O modelo mental
A integração tem uma etapa de credencial e cinco operações:
- Pessoa, uma vez: criar API key em
/developersou aprovar OAuth para agente. Se quiser callbacks, revelar e salvar o segredo de webhook da conta. - Agente, antes de gastar: chamar
POST /clone-requests/preflighte, durante o setup,POST /clone-requests/test-runs. - Agente, clone real: criar o request, acompanhar status ou receber webhook, desbloquear e baixar o código.
Não precisa de SDK, sessão de navegador nem cliques no dashboard depois que a key existe. A base REST é:
https://clonesite.ai/api/v1
Clientes com MCP podem usar o endpoint Streamable HTTP hospedado:
https://clonesite.ai/mcp
Criar a key e autenticar
Entre na conta, abra /developers e crie sua primeira key. Você verá algo como cs_live_a1b2c3d4... uma única vez. Ela é armazenada com hash, então copie na hora e passe para o agente ou salve como variável de ambiente.
Toda chamada leva a credencial no header Authorization:
curl https://clonesite.ai/api/v1/clone-requests/api_req_example \
-H "Authorization: Bearer cs_live_a1b2c3d4..."
As permissões separam criar, ler e baixar: clone_requests:create, clone_requests:read e source_downloads:create.
Preflight e teste gratuito
Preflight antes da cobrança. Test runs exercitam polling, webhooks e download sem custo.
Antes de gastar créditos, valide o mesmo payload com preflight. Ele checa key, permissão, payload, créditos e configuração de webhook quando existe callbackUrl. Não cria request, não dispara job, não cobra e não envia webhook.
Durante o setup, rode test-runs com a mesma key e o mesmo handler. Isso cria um request gratuito mode: "test" e envia eventos assinados clone.ready ou clone.failed. Assim você testa polling, webhook e download fixture pelos mesmos endpoints de produção.
Criar, acompanhar e baixar
Um create live precisa da URL pública, de um prompt e do header Idempotency-Key. Esse header torna retries seguros: mesma key e mesmo body retornam o mesmo request; mesma key com body diferente gera conflito.
Criar um clone real custa 5 créditos. A preview é gratuita. O download do código é um passo separado quando a preview já está pronta.
Quando quiser baixar o código, chame POST /clone-requests/:id/source-downloads. O primeiro desbloqueio custa 100 créditos e retorna uma URL assinada de curta duração. Chamadas seguintes só geram uma nova URL; não cobram de novo.
Discovery para agentes
A API também foi desenhada para agentes descobrirem sozinhos:
- llms.txt explica o que a Clonesite faz e seus limites.
- openapi.json contém o contrato machine-readable.
- MCP server card aponta para o servidor MCP em
https://clonesite.ai/mcp.
Prefere usar interface? O guia passo a passo cobre o mesmo fluxo sem código, e a página de preços mostra os pacotes de créditos.
FAQ
O que é uma API para clonar site?+
É uma API que recebe uma URL pública e devolve código-fonte editável da página via REST ou MCP. Em vez de clonar manualmente pela interface, um agente ou script cria a solicitação, acompanha o status e baixa o resultado.
Como autenticar na Clone API da Clonesite?+
Cada chamada usa um token Bearer. O token pode ser uma API key criada por uma pessoa ou um access token OAuth com escopos da Clone API.
Um agente de IA consegue usar a API sozinho?+
Sim. Discovery via llms.txt e openapi.json, teste mock gratuito, criação idempotente e webhooks opcionais permitem que o agente execute o fluxo depois que uma pessoa autoriza a credencial.
A Clone API tem teste gratuito?+
Sim. O preflight valida payload, credencial, permissões e créditos sem gastar saldo e sem iniciar um clone real.
Qual é o formato do download?+
Um ZIP com React e Tailwind. É código editável, não screenshot nem bundle travado.
Guias relacionados
Clonagem de URL vs captura de tela para código: o que muda de fato na saídaA clonagem de URL lê a estrutura real de uma página ativa — DOM, CSS, fontes, links e breakpoints responsivos — e a reconstrói como código editável. A captura de tela para código só enxerga pixels, então infere o layout e perde fontes, links e responsividade. A diferença aparece direto na utilidade da saída.
Melhores clonadores de sites com IA em 2026O melhor clonador de sites com IA é aquele cuja entrada e saída combinam com a sua tarefa — URL para código quando você quer reaproveitar um layout real, captura de tela para código quando só tem um mockup estático, e prompt para site quando vai criar do zero. Compare por tipo de entrada, editabilidade e qualidade de exportação antes de escolher.
Como clonar um site com Claude Code (2026): o pipeline real e onde ele falhaGuia para builders sobre clonar site com Claude Code: pipeline agentic em cinco fases, medição no navegador, reconstrução em React e Tailwind editável, setup necessário, casos que quebram sem supervisão e quando usar um clonador hospedado.