Stack de desenvolvedores Image2URL

SDK + CLI para URLs de imagem instantâneas

Pacotes oficiais atrás de image2url.com: imgtourl (CLI), mcp-server-image2url (agentes), @image2url/react (UI) e @image2url/next (ajudantes API). Carregue uma vez, compartilhe em todos os lugares.

CDN Global

Cache edge

Segurança

TLS + verificações MIME

Nível gratuito

Cotas baseadas em IP

Pronto para EEAT: limites transparentes, HTTPS por padrão, armazenamento Cloudflare R2, e saídas estruturadas para workflows reproduzíveis.

Uploads assinados, cabeçalhos de cache e sanitização de nome de arquivo incorporados.
Simulador de terminal web

Digite npm install -g imgtourl e pressione Enter para simular.

Passo 1: simular instalação. Passo 2: tente imgtourl logo.png para um upload com saída de URL verde.

Linha SDK

Respostas consistentes em CLI, MCP, React e Next.js.

imgtourl (CLI)

CLI global sem configuração. Transforma qualquer caminho de arquivo em URL suportada por CDN.

$ npm install -g imgtourl
imgtourl hero.png

Ideal para scripts CI, autores de docs e uploads rápidos de terminal.

mcp-server-image2url

Servidor MCP plug-and-play para Claude ou qualquer cliente MCP.

$ npx -y mcp-server-image2url
upload_image {"path": "/tmp/screenshot.png"}

Retorna URL + fragmentos Markdown/HTML/BBCode em saída MCP estruturada.

@image2url/react

Hook React para uploads drag-and-drop com status de progresso.

$ npm install @image2url/react
const { upload, status } = useImage2URL();

Amigável para cliente, funciona com fetch, mantém bundle pequeno.

@image2url/next

Ajudante server-first que assina e stream uploads dentro de rotas Next.js.

$ npm install @image2url/next
await uploadImage({ file, alt })

API Route / Route Handler pronto; cache e força limites de tamanho.

Início rápido React

Melhoria progressiva: hook plug-and-play mais drag-and-drop. Mantenha uploads fora do seu backend ou override endpoint para deployments privados.

import { useImage2URL } from '@image2url/react';

export function ImageUploader() {
  const { upload, status, result, error } = useImage2URL({
    uploadUrl: 'https://www.image2url.com/api/upload',
  });

  async function handleFile(file) {
    await upload({ file, alt: 'hero banner' });
  }

  return (
    <div>
      <input type="file" accept="image/*" onChange={(e) => e.target.files && handleFile(e.target.files[0])} />
      <p>{status === 'uploading' ? 'Carregando…' : null}</p>
      {result?.url && <a href={result.url}>{result.url}</a>}
      {error && <span>{error}</span>}
    </div>
  );
}
Route Handler Next.js

Mantenha uploads server-side para não expor tokens. Funciona em API Routes ou Route Handlers com respostas streaming e cabeçalhos de cache.

import { uploadImage } from '@image2url/next';
import { NextResponse } from 'next/server';

export async function POST(request: Request) {
  const data = await request.formData();
  const file = data.get('file');

  if (!(file instanceof File)) {
    return NextResponse.json({ error: 'Arquivo ausente' }, { status: 400 });
  }

  const result = await uploadImage({
    file,
    alt: 'marketing-banner',
    endpoint: 'https://www.image2url.com/api/upload',
  });

  return NextResponse.json(result);
}

Segurança e confiança

HTTPS por padrão, validação MIME, codificação de nome de arquivo e cabeçalhos Cache-Control otimizados para CDNs. Erros estruturados tornam observabilidade fácil.

Pronto para SEO e embeds

Links são cacheados por CDN e estáveis, perfeitos para blogs, docs, wikis e embeds sociais sem inchaço base64.

Saída consistente

Cada pacote retorna URL, Markdown, HTML, BBCode, filename, mimeType e uploadedAt para que seus workflows permaneçam determinísticos.

FAQ

O que é Image2URL?

Image2URL transforma qualquer arquivo ou URL de imagem remota em um link HTTPS permanente mais fragmentos Markdown/HTML. O stack SDK envolve esse endpoint para CLI, MCP, React e Next.js.

Há um nível gratuito?

Sim. O endpoint padrão em image2url.com fornece cota gratuita baseada em IP para que você possa testar localmente sem tokens.

Posso auto-hospedar?

Defina IMAGE2URL_BASE_URL ou IMAGE2URL_UPLOAD_URL para apontar para seu próprio deployment ou bucket Cloudflare R2. CLI, servidor MCP e SDKs respeitam essas variáveis de ambiente.

Quais formatos são retornados?

URL direta mais strings Markdown, HTML e BBCode. Respostas estruturadas incluem filename, mimeType, tamanho, uploadedAt e uploadEndpoint.

Como arquivos são validados?

Imagens devem apresentar um tipo MIME image/* válido. Cap de tamanho padrão é 2 MB; você pode override via IMAGE2URL_MAX_BYTES em deployments auto-hospedados.

O SDK está pronto para produção?

Sim. Construído em HTTPS com cabeçalhos cache-friendly, verificações de integridade e mensagens de erro claras. Usado pelo image2url.com mesmo.

Image2URL SDKs & CLI | imgtourl, Servidor MCP, Pacotes React e Next.js