Stack de desarrolladores Image2URL

SDK + CLI para URLs de imágenes instantáneas

Paquetes oficiales detrás de image2url.com: imgtourl (CLI), mcp-server-image2url (agentes), @image2url/react (UI) y @image2url/next (ayudantes API). Sube una vez, comparte en todas partes.

CDN Global

Caché edge

Seguridad

TLS + verificaciones MIME

Nivel gratuito

Cuotas basadas en IP

Listo para EEAT: límites transparentes, HTTPS por defecto, almacenamiento Cloudflare R2, y salidas estructuradas para flujos reproducibles.

Uploads firmados, encabezados de caché y saneamiento de nombre de archivo incorporados.
Simulador de terminal web

Escribe npm install -g imgtourl y presiona Enter para simular.

Paso 1: simular instalación. Paso 2: intenta imgtourl logo.png para un upload con salida de URL verde.

Línea SDK

Respuestas consistentes en CLI, MCP, React y Next.js.

imgtourl (CLI)

CLI global sin configuración. Convierte cualquier ruta de archivo en URL con soporte CDN.

$ npm install -g imgtourl
imgtourl hero.png

Ideal para scripts CI, autores de documentos y uploads rápidos de terminal.

mcp-server-image2url

Servidor MCP plug-and-play para Claude o cualquier cliente MCP.

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

Devuelve URL + fragmentos Markdown/HTML/BBCode en salida MCP estructurada.

@image2url/react

Hook React para uploads drag-and-drop con estado de progreso.

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

Amigable para cliente, funciona con fetch, mantiene bundle pequeño.

@image2url/next

Ayudante server-first que firma y transmite uploads dentro de rutas Next.js.

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

API Route / Route Handler listo; cachea y fuerza límites de tamaño.

Inicio rápido React

Mejora progresiva: hook plug-and-play más drag-and-drop. Mantén uploads fuera de tu backend o sobrescribe endpoint para despliegues 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' ? 'Subiendo…' : null}</p>
      {result?.url && <a href={result.url}>{result.url}</a>}
      {error && <span>{error}</span>}
    </div>
  );
}
Route Handler Next.js

Mantén uploads server-side para no exponer tokens. Funciona en API Routes o Route Handlers con respuestas streaming y encabezados de caché.

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: 'Archivo faltante' }, { status: 400 });
  }

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

  return NextResponse.json(result);
}

Seguridad y confianza

HTTPS por defecto, validación MIME, codificación de nombre de archivo y encabezados Cache-Control optimizados para CDNs. Errores estructurados hacen observabilidad fácil.

Listo para SEO e embeds

Los enlaces están cacheados en CDN y son estables, perfectos para blogs, documentos, wikis y embeds sociales sin hinchazón base64.

Salida consistente

Cada paquete devuelve URL, Markdown, HTML, BBCode, filename, mimeType y uploadedAt para que tus flujos permanezcan deterministas.

FAQ

¿Qué es Image2URL?

Image2URL convierte cualquier archivo o URL de imagen remota en un enlace HTTPS permanente más fragmentos Markdown/HTML. El stack SDK envuelve ese endpoint para CLI, MCP, React y Next.js.

¿Hay un nivel gratuito?

Sí. El endpoint por defecto en image2url.com proporciona cuota gratuita basada en IP para que puedas probar localmente sin tokens.

¿Puedo auto-hosting?

Establece IMAGE2URL_BASE_URL o IMAGE2URL_UPLOAD_URL para apuntar a tu propio despliegue o bucket Cloudflare R2. CLI, servidor MCP y SDKs respetan estas variables de entorno.

¿Qué formatos se devuelven?

URL directa más cadenas Markdown, HTML y BBCode. Las respuestas estructuradas incluyen filename, mimeType, tamaño, uploadedAt y uploadEndpoint.

¿Cómo se validan los archivos?

Las imágenes deben presentar un tipo MIME image/* válido. El límite de tamaño por defecto es 2 MB; puedes sobrescribir vía IMAGE2URL_MAX_BYTES en despliegues auto-hosting.

¿El SDK está listo para producción?

Sí. Construido en HTTPS con encabezados cache-friendly, verificaciones de integridad y mensajes de error claros. Usado por image2url.com mismo.

Image2URL SDKs & CLI | imgtourl, Servidor MCP, Paquetes React y Next.js