# SocialCutter

> Convierte una imagen maestra en los formatos de todas las redes sociales con recorte
> automatico centrado: 6 plataformas y 13 destinos, desde la web, la API REST y un servidor
> MCP con 28 herramientas. No publica en redes ni edita imagenes.
>
> One master image into every social format with automatic centred cropping: 6 platforms and
> 13 destinations, from the web, the REST API and an MCP server with 28 tools.

**What it is.** SocialCutter turns one master image into every social format in a single request.
Cropping is automatic and **centred**: there is no subject or face detection and no AI analysing the
image. It does not publish to social networks and does not edit images: it produces the files.

- Website: https://socialcutter.theboomer.dev
- Dashboard: https://dash.socialcutter.theboomer.dev
- API: https://api.socialcutter.theboomer.dev
- API reference (OpenAPI 3.1): https://docs.socialcutter.theboomer.dev
- Remote MCP server (28 tools): https://mcp.socialcutter.theboomer.dev/mcp
- MCP server via npx: `npx @theboomerdev/socialcutter-mcp`

**Pricing** (real catalogue, EUR; every plan includes API and MCP access, with no extra per-use rate).

- Free — 0 EUR/month: 3 uses/day, earned-use bag up to 150, +50 uses per coupon redemption.
- Basic — 3 EUR/month: 10 uses/day, bag up to 300, +50 per redemption, usage analytics.
- Pro — 9 EUR/month: 30 uses/day, bag up to 600, +100 per redemption, analytics, priority support.
- Agency — 29 EUR/month: 100 uses/day, bag up to 1500, +150 per redemption, custom branding.
- Credit packs (one-time, no expiry): 100 uses = 3 EUR · 600 = 12 EUR · 3333 = 50 EUR (0.015 EUR per use).

**Wallet.** 1 use = 1 destination (platform + format) per request. Spend order: daily quota, then the
earned-use bag (capped per plan), then the purchased bag (packs; uncapped, no expiry).

**Coupons and referrals.** Any user, including the free plan, creates a coupon and shares it. On
redemption both sides earn the same reward: 50, 100 or 150 uses depending on the creator's plan.
Default limit: 5 redemptions per coupon (configurable up to 1000). Coupons ARE the referral
programme; there is no separate affiliate programme.

**Authentication.** Create a key in the dashboard (Profile, prefix `sc_`) and send it as
`X-API-Key: sc_...`. `Authorization: Bearer sc_...` is accepted as well, so use whichever form your
client documents; a `Bearer` without the `sc_` prefix is treated as a dashboard session and returns
401. The public MCP tools (catalogue, formats, pricing) answer without credentials.

**Real destinations** (from the public catalogue; there is no 4:5 format).

- instagram: post 1:1 1080x1080 · story 9:16 1080x1920 · landscape 1.91:1 1080x566
- facebook: post 1.91:1 1200x630 · story 9:16 1080x1920 · cover 2.63:1 820x312
- twitter: post 16:9 1200x675 · header 3:1 1500x500
- linkedin: post 1.91:1 1200x627 · cover 5.9:1 1128x191
- youtube: thumbnail 16:9 1280x720 · banner 16:9 2560x1440
- tiktok: cover 9:16 1080x1920

**Limits and options.** Up to 5 MB per image; input png, jpg, jpeg or webp; output webp, jpg or png
with quality 1-100 (default 85); fit modes cover (default), contain, fill and stretch;
`background_color` for contain padding; optional `Idempotency-Key` header.

**Main endpoints.** `POST /api/v1/images/process` (URL) · `POST /api/v1/images/process/upload`
(multipart) · `POST /api/v1/images/upload` (base64) · `POST /api/v1/images/upload/file` ·
`POST /api/v1/images/batch` · `GET /api/v1/images/{id}` · `GET /api/v1/platforms` ·
`GET /api/v1/formats` · `GET /api/v1/fit-modes` · `GET /api/v1/history?origin=browser|api` ·
`GET /api/v1/wallet` · `GET /api/v1/credits` · `POST /api/v1/coupons` ·
`POST /api/v1/coupons/redeem` · `GET /api/v1/coupons/mine` · `GET /api/v1/coupons/{code}` ·
`GET /api/v1/billing/pricing-plans` · `GET /api/v1/billing/credit-packs` ·
`POST /api/v1/billing/create-checkout-session` · `POST /api/v1/billing/buy-credits`

**How to call it** (exact request body, so an agent can build the call without fetching the OpenAPI):

```http
POST https://api.socialcutter.theboomer.dev/api/v1/images/process
X-API-Key: sc_your_key
Content-Type: application/json

{
  "source": { "type": "url", "value": "https://example.com/master.jpg" },
  "destinations": [
    { "platform": "instagram", "format": "story" },
    { "platform": "linkedin", "format": "post", "fit_mode": "contain" }
  ],
  "options": { "format": "webp", "quality": 85, "background_color": "#000000" }
}
```

- `source.type` is `url` or `base64` (`value` carries the URL or the encoded image). Required.
- `destinations` is required: one entry per output. `platform` is one of `instagram`, `facebook`,
  `twitter`, `linkedin`, `youtube`, `tiktok`; `format` is the catalogue name for that platform
  (`post`, `story`, `landscape`, `cover`, `header`, `thumbnail`, `banner`). `fit_mode` is optional
  and defaults to `cover`.
- `options` is optional: `format` (`webp` default, or `jpg`/`png`), `quality` (1-100, default 85),
  `background_color` (default `#000000`, used when a fit mode pads).
- The response is `{ "id", "status", "outputs": [...], "metadata": {...} }`; each output carries its
  platform, format and the URL of the generated file. `GET /api/v1/images/{id}` returns the same
  record later, and `GET /api/v1/history` lists past jobs.
- Errors: `401` when the key is missing or wrong, `422` when the body does not validate, `429` when
  the wallet has no uses left for that request.

**No bag expires.** The daily quota resets each day; both the earned-use bag and the purchased packs
are persistent (nothing expires and the purchased bag is not capped).

## Reference and sizes

- [Automatizar imágenes para redes sociales: 4 caminos](https://socialcutter.theboomer.dev/guias/automatizar-imagenes-redes-sociales/index.md): Los cuatro caminos reales para automatizar las medidas de tus imágenes con SocialCutter: API REST, MCP, no-code y CMS o ERP. Qué genera y qué no. (also in English: https://socialcutter.theboomer.dev/en/guides/automatizar-imagenes-redes-sociales/index.md)
- [Checklist antes de publicar una imagen en redes sociales](https://socialcutter.theboomer.dev/guias/checklist-imagenes-redes-sociales/index.md): Lista de comprobación para antes de publicar: medida exacta por destino, proporción, peso, formato y texto legible tras el recorte centrado. Cópiala y úsala. (also in English: https://socialcutter.theboomer.dev/en/guides/checklist-imagenes-redes-sociales/index.md)
- [PNG, JPG o WebP: qué formato usar en cada red](https://socialcutter.theboomer.dev/guias/formatos-redes-sociales/index.md): Cuándo conviene PNG, JPG o WebP en redes sociales: transparencia, peso y calidad, tabla comparativa y cómo elegir el formato de salida en SocialCutter. (also in English: https://socialcutter.theboomer.dev/en/guides/formatos-redes-sociales/index.md)
- [Medidas de redes sociales: tamaños y proporciones](https://socialcutter.theboomer.dev/guias/medidas-redes-sociales/index.md): Medidas para redes sociales: proporción y píxeles exactos de cada formato, qué medida usar según el objetivo y cómo generarlas todas desde una imagen. (also in English: https://socialcutter.theboomer.dev/en/guides/medidas-redes-sociales/index.md)

## AI, LLMs and automation

- [Aider no tiene MCP: usa la API de SocialCutter](https://socialcutter.theboomer.dev/guias/aider/index.md): Aider no soporta MCP y no existe ningun flag oficial: guia honesta del camino que si funciona, con --lint-cmd y --test-cmd llamando a la API de SocialCutter. (also in English: https://socialcutter.theboomer.dev/en/guides/aider/index.md)
- [Adjunta en Airtable las medidas generadas con SocialCutter](https://socialcutter.theboomer.dev/guias/airtable/index.md): Genera los formatos con SocialCutter y adjunta la URL de salida a un campo attachment por la API de Airtable: flujo directo, Python, curl y errores. (also in English: https://socialcutter.theboomer.dev/en/guides/airtable/index.md)
- [Conecta SocialCutter a Claude Code por MCP](https://socialcutter.theboomer.dev/guias/claude-code/index.md): Añade el servidor MCP de SocialCutter a Claude Code con .mcp.json o la CLI, la cabecera X-API-Key, la aprobación de proyecto y la trampa del ámbito de usuario. (also in English: https://socialcutter.theboomer.dev/en/guides/claude-code/index.md)
- [Conecta SocialCutter a Cline por MCP: el transporte correcto](https://socialcutter.theboomer.dev/guias/cline/index.md): Configura el servidor MCP de SocialCutter en Cline: type streamableHttp, los ficheros del IDE y del CLI, autoApprove y errores de transporte. (also in English: https://socialcutter.theboomer.dev/en/guides/cline/index.md)
- [Conecta SocialCutter a Codex CLI por MCP](https://socialcutter.theboomer.dev/guias/codex-cli/index.md): Registra el servidor MCP de SocialCutter en ~/.codex/config.toml con http_headers o env_http_headers, da de alta con codex mcp add y verifica con /mcp. (also in English: https://socialcutter.theboomer.dev/en/guides/codex-cli/index.md)
- [Conecta SocialCutter a Cursor y a su CLI agent](https://socialcutter.theboomer.dev/guias/cursor/index.md): Configura el servidor MCP de SocialCutter en .cursor/mcp.json con ${env:...}, entiende la aprobacion por proyecto y verifica con agent mcp list. (also in English: https://socialcutter.theboomer.dev/en/guides/cursor/index.md)
- [Dropbox a SocialCutter: entrada y salida de imágenes](https://socialcutter.theboomer.dev/guias/dropbox/index.md): Lee la imagen nueva de una carpeta de Dropbox con files/list_folder y su cursor, procésala con SocialCutter y sube cada formato a otra carpeta con files/upload. (also in English: https://socialcutter.theboomer.dev/en/guides/dropbox/index.md)
- [Conecta SocialCutter a Gemini CLI por MCP](https://socialcutter.theboomer.dev/guias/gemini-cli/index.md): Registra el servidor MCP de SocialCutter en Gemini CLI con httpUrl, timeout y trust. Alta por CLI, verificacion sin gastar usos y errores tipicos. (also in English: https://socialcutter.theboomer.dev/en/guides/gemini-cli/index.md)
- [Procesa imágenes de Google Drive con SocialCutter](https://socialcutter.theboomer.dev/guias/google-drive/index.md): Vigila una carpeta de Drive, descarga la imagen nueva, procésala con SocialCutter y sube cada resultado a otra carpeta: OAuth, permisos y Python. (also in English: https://socialcutter.theboomer.dev/en/guides/google-drive/index.md)
- [SocialCutter como extensión MCP en Goose](https://socialcutter.theboomer.dev/guias/goose/index.md): Añade SocialCutter a Goose con una extensión streamable_http: config.yaml, la cabecera X-API-Key, los secretos en el llavero y los errores más típicos. (also in English: https://socialcutter.theboomer.dev/en/guides/goose/index.md)
- [Automatiza el recorte de imágenes con Make](https://socialcutter.theboomer.dev/guias/make/index.md): Monta un escenario de Make que reciba una imagen y genere todas sus medidas con SocialCutter: Create JSON, cabecera X-API-Key y uso de las salidas. (also in English: https://socialcutter.theboomer.dev/en/guides/make/index.md)
- [Usa SocialCutter desde tu LLM o editor con MCP](https://socialcutter.theboomer.dev/guias/mcp/index.md): Conecta el servidor MCP de SocialCutter a Claude, Cursor, VS Code o Windsurf. 28 herramientas para procesar imagenes, ver historial, monedero y facturas. (also in English: https://socialcutter.theboomer.dev/en/guides/mcp/index.md)
- [Automatiza el recorte de imágenes con n8n](https://socialcutter.theboomer.dev/guias/n8n/index.md): Conecta n8n con la API de SocialCutter: disparador de imagen nueva, nodo HTTP Request, reparto a redes y CMS y coste por ejecución. (also in English: https://socialcutter.theboomer.dev/en/guides/n8n/index.md)
- [Guarda en Notion las medidas generadas con SocialCutter](https://socialcutter.theboomer.dev/guias/notion/index.md): Genera cada formato con SocialCutter y llévalo a Notion con una URL externa o la File Upload API: límites de alojamiento, versiones y snippet en Python. (also in English: https://socialcutter.theboomer.dev/en/guides/notion/index.md)
- [SocialCutter como servidor MCP en OpenCode](https://socialcutter.theboomer.dev/guias/opencode/index.md): Configura SocialCutter en OpenCode con opencode.json: la clave mcp, oauth en false, la sustitución {env:VAR} para el secreto y el alta por la CLI con mcp add. (also in English: https://socialcutter.theboomer.dev/en/guides/opencode/index.md)
- [Sube imágenes a Slack con files.uploadV2](https://socialcutter.theboomer.dev/guias/slack/index.md): Sube imágenes a Slack con files.uploadV2 o compártelas por URL, y encadena SocialCutter para responder con los formatos listos. (also in English: https://socialcutter.theboomer.dev/en/guides/slack/index.md)
- [Conecta SocialCutter a Windsurf (Cascade) por MCP](https://socialcutter.theboomer.dev/guias/windsurf/index.md): Añade el servidor MCP de SocialCutter a Windsurf: las dos rutas de mcp_config.json, serverUrl, la cabecera X-API-Key y los errores típicos. (also in English: https://socialcutter.theboomer.dev/en/guides/windsurf/index.md)
- [Automatiza el recorte de imágenes con Zapier](https://socialcutter.theboomer.dev/guias/zapier/index.md): Monta un Zap que reciba una imagen y genere todas sus medidas con SocialCutter: URL pública en el cuerpo JSON, cabeceras, salidas y errores. (also in English: https://socialcutter.theboomer.dev/en/guides/zapier/index.md)
- [Zed y SocialCutter: MCP con context servers](https://socialcutter.theboomer.dev/guias/zed/index.md): Conecta el servidor MCP de SocialCutter a Zed con la clave context_servers y la cabecera X-API-Key: settings.json, verificacion paso a paso y errores tipicos. (also in English: https://socialcutter.theboomer.dev/en/guides/zed/index.md)

## CMS and e-commerce

- [Sube la imagen de producto a BigCommerce con la API v3](https://socialcutter.theboomer.dev/guias/bigcommerce/index.md): Añade la imagen al producto por la API v3 de BigCommerce usando la URL que devuelve SocialCutter, ya recortada a su medida. (also in English: https://socialcutter.theboomer.dev/en/guides/bigcommerce/index.md)
- [Canva + SocialCutter: de un diseño a cada medida](https://socialcutter.theboomer.dev/guias/canva/index.md): Cómo encajan Canva y SocialCutter: Canva diseña y exporta el PNG o JPG, SocialCutter genera las medidas exactas de cada red. No sustituimos a Canva. (also in English: https://socialcutter.theboomer.dev/en/guides/canva/index.md)
- [Contentful: cuándo pre-generar imágenes y cómo publicarlas](https://socialcutter.theboomer.dev/guias/contentful/index.md): La Images API de Contentful ya recorta al vuelo: mira cuándo conviene pre-generar los ficheros con SocialCutter y cómo publicar el asset por la Management API. (also in English: https://socialcutter.theboomer.dev/en/guides/contentful/index.md)
- [Sube a Etsy las imágenes del listing con la API v3](https://socialcutter.theboomer.dev/guias/etsy/index.md): Genera los formatos con SocialCutter y súbelos al listing por la API v3 de Etsy en multipart: requisitos de tamaño y formato, OAuth, jpg o png y errores. (also in English: https://socialcutter.theboomer.dev/en/guides/etsy/index.md)
- [Sube imágenes a Ghost y publica el post correcto](https://socialcutter.theboomer.dev/guias/ghost/index.md): Flujo con la Admin API de Ghost: firma el JWT, sube imagenes a /ghost/api/admin/images/upload y crea o actualiza un post con feature_image. (also in English: https://socialcutter.theboomer.dev/en/guides/ghost/index.md)
- [Sube imágenes a HubSpot con la Files API](https://socialcutter.theboomer.dev/guias/hubspot/index.md): Sube las imágenes que genera SocialCutter al File Manager de HubSpot por la Files API, con multipart o desde una URL, y úsalas en correos, landings y redes. (also in English: https://socialcutter.theboomer.dev/en/guides/hubspot/index.md)
- [Imágenes de producto en Magento 2 por la REST API](https://socialcutter.theboomer.dev/guias/magento/index.md): Sube el maestro con POST /rest/V1/products/<sku>/media, genera cada medida con SocialCutter y asígnalas como mediaGalleryEntries. (also in English: https://socialcutter.theboomer.dev/en/guides/magento/index.md)
- [Imágenes de producto en PrestaShop por el Webservice](https://socialcutter.theboomer.dev/guias/prestashop/index.md): Genera los tamaños con SocialCutter y súbelos a PrestaShop usando el Webservice de imágenes, asignándolos después al producto. (also in English: https://socialcutter.theboomer.dev/en/guides/prestashop/index.md)
- [Integra SocialCutter con la Admin API de Shopify](https://socialcutter.theboomer.dev/guias/shopify/index.md): Flujo con la Admin API de Shopify: sube el maestro a Files y al producto, asigna la salida 1:1 y controla version, scopes y errores. Snippet en Node con fetch. (also in English: https://socialcutter.theboomer.dev/en/guides/shopify/index.md)
- [Sube imágenes a la mediateca de Strapi con SocialCutter](https://socialcutter.theboomer.dev/guias/strapi/index.md): Sube la imagen a la mediateca de Strapi por POST /api/upload con una petición multipart y úsala en tus entradas a su medida. (also in English: https://socialcutter.theboomer.dev/en/guides/strapi/index.md)
- [Sube imágenes a Webflow y usa SocialCutter](https://socialcutter.theboomer.dev/guias/webflow/index.md): Sube el maestro a los Assets de Webflow con la API v2, llamalo con SocialCutter y usa las salidas correctas en el CMS Collection o en la pagina. (also in English: https://socialcutter.theboomer.dev/en/guides/webflow/index.md)
- [Sube imágenes a Wix con la API de Media Manager](https://socialcutter.theboomer.dev/guias/wix/index.md): Genera los tamaños exactos con SocialCutter y súbelos al Media Manager de Wix por su API, listos para tus páginas y entradas. (also in English: https://socialcutter.theboomer.dev/en/guides/wix/index.md)
- [Sube imágenes de catálogo a WooCommerce con SocialCutter](https://socialcutter.theboomer.dev/guias/woocommerce/index.md): Sube el maestro a la biblioteca de medios o pásalo por URL, genera los tamaños con SocialCutter y asígnalos al producto. (also in English: https://socialcutter.theboomer.dev/en/guides/woocommerce/index.md)
- [Integra SocialCutter con WordPress y WooCommerce](https://socialcutter.theboomer.dev/guias/wordpress/index.md): Sube el maestro a la biblioteca de medios por REST API, procesalo con SocialCutter y asigna la salida correcta como imagen destacada y en el contenido. (also in English: https://socialcutter.theboomer.dev/en/guides/wordpress/index.md)

## API by language

- [Procesa imágenes con la API desde la terminal (curl)](https://socialcutter.theboomer.dev/guias/curl/index.md): Guia practica de la API de SocialCutter con curl: salud, credenciales, plataformas, procesado por URL y por fichero, historial, monedero y errores tipicos. (also in English: https://socialcutter.theboomer.dev/en/guides/curl/index.md)
- [Procesa imágenes con la API de SocialCutter desde Node.js](https://socialcutter.theboomer.dev/guias/node/index.md): Cliente de la API de SocialCutter en Node 18 o superior con fetch y FormData: salud, plataformas, procesado por URL y fichero, lote de una carpeta y errores. (also in English: https://socialcutter.theboomer.dev/en/guides/node/index.md)
- [Procesa imágenes con la API de SocialCutter desde PHP](https://socialcutter.theboomer.dev/guias/php/index.md): Cliente de la API de SocialCutter en PHP con cURL y Guzzle: salud, plataformas, procesado por URL y fichero con CURLFile, lotes, historial, monedero y errores. (also in English: https://socialcutter.theboomer.dev/en/guides/php/index.md)
- [Procesa imágenes con la API de SocialCutter desde Python](https://socialcutter.theboomer.dev/guias/python/index.md): Cliente de la API de SocialCutter en Python con requests: salud, plataformas, procesado por URL y fichero, lotes, historial, monedero y reintentos con backoff. (also in English: https://socialcutter.theboomer.dev/en/guides/python/index.md)

## Messaging and bots

- [Bot de Telegram que adapta tus fotos con SocialCutter](https://socialcutter.theboomer.dev/guias/telegram/index.md): Bot de Telegram en Python que recibe una foto, la procesa con la API de SocialCutter y la devuelve en el formato exacto de cada red con sendPhoto. (also in English: https://socialcutter.theboomer.dev/en/guides/telegram/index.md)
- [Bot de WhatsApp que adapta imágenes con SocialCutter](https://socialcutter.theboomer.dev/guias/whatsapp/index.md): Recibe una imagen o un enlace por la WhatsApp Cloud API, genera los formatos con SocialCutter y responde con la imagen o el enlace, con la ventana de 24 h. (also in English: https://socialcutter.theboomer.dev/en/guides/whatsapp/index.md)

## ERP and product catalogues

- [Normaliza imágenes de catálogo en ERPNext](https://socialcutter.theboomer.dev/guias/erpnext/index.md): Lee el doctype Item por la REST API de ERPNext con token, procesa la imagen con SocialCutter a las medidas de ecommerce y redes. Snippet en Python. (also in English: https://socialcutter.theboomer.dev/en/guides/erpnext/index.md)
- [Normaliza imágenes de catálogo en Odoo](https://socialcutter.theboomer.dev/guias/odoo/index.md): Lee productos de Odoo por XML-RPC, procesa su imagen con SocialCutter a las medidas de ecommerce y redes, y vuelve a escribirla. Snippet en Python. (also in English: https://socialcutter.theboomer.dev/en/guides/odoo/index.md)

## Optional

- [Guides index (ES)](https://socialcutter.theboomer.dev/guias/index.md)
- [Guides index (EN)](https://socialcutter.theboomer.dev/en/guides/index.md)
- [Sitemap](https://socialcutter.theboomer.dev/sitemap.xml)
- [OpenAPI 3.1 JSON](https://api.socialcutter.theboomer.dev/openapi.json)
- [Service health](https://api.socialcutter.theboomer.dev/health)