Portal do Desenvolvedor do Screenshot Studio

O Screenshot Studio é um editor de screenshot baseado em browser e de código aberto com uma API HTTP pública e leve. Esta página é o ponto de partida para integração: os endpoints não exigem autenticação, o contrato é publicado como OpenAPI 3.1 e todo o aplicativo possui licença Apache 2.0 no GitHub.

Comece por aqui

Documentação da API

Todos os endpoints públicos com exemplos de requisição e resposta, além da tabela de códigos de erro.

Especificação OpenAPI 3.1

Contrato legível por máquina com operationIds, parâmetros tipados e esquemas de resposta.

Autenticação e limites de taxa

Não requer chave de API. Limites por IP e semântica de erro 429.

llms.txt

Visão geral do site em Markdown para agentes de IA e crawlers de LLM.

llms-full.txt

Referência completa em Markdown cobrindo recursos e API.

Código-fonte no GitHub

Licença Apache 2.0. Issues, discussões e instruções de auto-hospedagem.

Chaves de API

Não há chaves nem necessidade de cadastro. A API pública é anônima e controlada por limites de taxa por IP em vez de credenciais. Mais detalhes em autenticação e limites de taxa.

Início rápido

1. Capturar uma página ao vivo

Sem chave, sem cadastro. Envie uma URL e receba um PNG em base64.

curl -s -X POST https://www.screenshot-studio.com/api/screenshot \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","deviceType":"desktop"}' \
  | jq -r .screenshot | base64 -d > shot.png

2. Otimizar a exportação

Processe a imagem pelo Sharp para recomprimi-la como WebP.

curl -s -X POST https://www.screenshot-studio.com/api/export \
  -F "image=@shot.png" \
  -F "format=webp" \
  -F "qualityPreset=high" \
  -o shot.webp

3. Tratar erros

Requisições com erro retornam o mesmo formato JSON. Valide pelo código retornado.

{
  "error": "URL is required",
  "code": "invalid_request",
  "message": "URL is required",
  "hint": "Send a JSON body with a \"url\" string.",
  "status": 400,
  "documentation": "https://www.screenshot-studio.com/docs#errors"
}

Ambiente de testes (Sandbox)

Não existe um host de testes separado. A produção é segura para experimentos: os endpoints são somente leitura em relação aos seus dados, nada é armazenado em contas e o próprio editor nunca faz upload das suas imagens. Para rodar a aplicação completa localmente:

git clone https://github.com/opennookorg/screenshot-studio.git
cd screenshot-studio
npm install
npm run dev

Construindo um agente

Carregue /openapi.json diretamente como definição de ferramentas para function-calling. Cada operação contém um operationId único, descrição, parâmetros tipados e esquema de resposta. Qualquer página deste site também responde em Markdown quando solicitado:

curl -H "Accept: text/markdown" https://www.screenshot-studio.com/docs

CLI e servidor MCP

Nenhuma ferramenta CLI oficial ou servidor MCP foram publicados ainda. Os exemplos de curl acima são a forma recomendada de uso via linha de comando. Se desejar algum deles, abra uma issue.

Suporte

Abra relatos de bugs e pedidos de recursos nas issues do GitHub, ou entre em contato pelos canais na página de contato.