Swonkie

Convierte tu asistente de IA en un gestor de redes sociales. Programa y publica publicaciones en 9 redes, obtén análisis de perfiles y competidores, gestiona flujos de aprobación en equipo, administra la biblioteca de medios y genera imágenes acordes a tu marca con IA.

Ver en swonkie.devPrueba este MCPPatrocinado

Documentación

🆕 MCP Server

¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA y herramientas de automatización llamar a servicios externos como herramientas nativas: sin copiar y pegar, sin integraciones personalizadas. Cuando conectas Swonkie a través de MCP, tu agente de IA puede consultar tus analíticas, gestionar publicaciones, mover contenido a través de flujos de aprobación y publicar, todo desde una conversación natural o un flujo de trabajo automatizado.

El servidor MCP de Swonkie utiliza el transporte Streamable HTTP, lo que significa que funciona en herramientas de IA alojadas en la nube (Claude.ai, ChatGPT) y en clientes locales (Claude Desktop, n8n) sin ejecutar ningún proceso local.

Lo que puedes hacer

Una vez conectado, un agente de IA puede:

Listar tus perfiles de redes sociales conectados y los perfiles de competidores
Obtener analíticas diarias e información por publicación de cualquier perfil o competidor
Crear, actualizar y eliminar publicaciones (con pies de foto por red, medios y opciones específicas de cada plataforma)
Programar publicaciones, enviarlas para revisión del equipo, aprobarlas o rechazarlas
Gestionar tu biblioteca de medios (subir y referenciar imágenes/videos en publicaciones)
Crear y listar etiquetas para la organización de contenido

Requisitos previos

Un espacio de trabajo de Swonkie con acceso a la API habilitado
Un cliente de API creado en Settings → Workspace → API
Una clave de API visible: las claves solo se muestran inmediatamente después de su creación o después de una rotación. Si tu clave está oculta, rótala para revelar una nueva.

Tu URL del servidor MCP

https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY

Tienes dos URL: una por cada ranura de clave (Primary y Secondary). Usa URL diferentes para distintos clientes para poder rotar una de forma independiente sin afectar a la otra.

Seguridad: Trata la URL MCP como una contraseña. Contiene tu clave de API activa incrustada en la URL. No la compartas públicamente ni la subas al control de versiones. Pronto añadiremos soporte OAuth.

Encuentra tu App ID y tus claves en Settings → Workspace → API. La URL MCP se muestra automáticamente una vez que tu cliente de API está configurado.

Herramientas disponibles

El servidor MCP de Swonkie expone 17 herramientas organizadas en cinco grupos.

Perfiles

Herramienta	Qué hace
`swonkie_profiles_list`	Enumera tus perfiles de redes sociales conectados. Admite paginación (`skip`, `take` hasta 20), búsqueda de texto y filtrado por red. Los IDs de perfil de esta herramienta son necesarios para las herramientas de analíticas y publicaciones.
`swonkie_competitors_list`	Enumera los perfiles de competidores monitorizados. Mismos parámetros que `swonkie_profiles_list`. Los IDs de competidores alimentan las herramientas de analíticas de competidores.

Analíticas

Herramienta	Qué hace
`swonkie_profile_insights_daily`	Devuelve métricas diarias agregadas para uno de tus perfiles conectados en un rango de fechas. Requiere `profileId`, `since` (ISO 8601), `until` (ISO 8601) y `metrics[]`.
`swonkie_profile_insights_posts`	Devuelve métricas por publicación para uno de tus perfiles conectados en un rango de fechas. Mismos parámetros que las analíticas diarias.
`swonkie_competitor_insights_daily`	Devuelve métricas diarias agregadas para un competidor monitorizado. Requiere un `profileId` de competidor de `swonkie_competitors_list`.
`swonkie_competitor_insights_posts`	Devuelve métricas por publicación para un competidor monitorizado. Mismos parámetros que las analíticas diarias de competidores.

Los nombres de métricas disponibles dependen de tu plan y de la red conectada. Consulta docs.swonkie.dev para la lista completa.

Publicaciones

Herramienta	Qué hace
`swonkie_posts_list`	Enumera las publicaciones de tu espacio de trabajo con filtros opcionales: rango de fechas, etapas del flujo de trabajo, tipos de publicación, IDs de perfil, IDs de etiquetas y búsqueda de texto libre.
`swonkie_posts_get`	Carga una sola publicación por ID. Devuelve el payload completo de la publicación.
`swonkie_posts_create`	Crea una publicación. Requiere `type` y `profileIds[]`. Admite pies de foto por red, adjuntos de medios, vistas previas de enlaces, hora de publicación programada, opciones específicas de plataforma (carruseles de Facebook, indicadores de TikTok, etc.), briefings y etiquetas.
`swonkie_posts_update`	Actualiza una publicación existente. Mismo esquema que crear: es un reemplazo completo, no un parche parcial. Requiere `postId`, `type` y `profileIds[]`.
`swonkie_posts_delete`	Elimina permanentemente una publicación por ID.
`swonkie_posts_validate`	Ejecuta las reglas de validación de publicación sobre una publicación y devuelve si está lista para publicarse junto con cualquier mensaje de validación.
`swonkie_posts_stage_change`	Mueve una publicación a través del flujo de trabajo de aprobación. Consulta Workflow Stages más abajo.

Tipos de publicación: STATUS, MEDIA, STORY, LINK, REEL

Etiquetas

Herramienta	Qué hace
`swonkie_labels_list`	Enumera las etiquetas del espacio de trabajo. Paginado. Usa los IDs de etiqueta al crear o filtrar publicaciones.
`swonkie_labels_create`	Crea una nueva etiqueta. El nombre debe tener entre 1 y 50 caracteres.

Medios

Herramienta	Qué hace
`swonkie_media_get`	Devuelve los metadatos de un elemento de medios subido por ID.
`swonkie_media_create`	Inicia una subida de medios: crea una entrada en la biblioteca de medios y devuelve los detalles de subida. Continúa con `swonkie_media_upload_confirm` después de que el archivo se haya subido. `destinationType` es `POST_MEDIA` o `POST_LINK`.
`swonkie_media_upload_confirm`	Finaliza el procesamiento después de que un archivo se haya subido al backend de almacenamiento.
`swonkie_media_delete`	Elimina un elemento de medios de la biblioteca.

Etapas del flujo de trabajo

Usa swonkie_posts_stage_change para mover una publicación a través del pipeline de aprobación de contenido.

Etapa	Qué hace
`publishNow`	Publica la publicación inmediatamente
`schedule`	Programa la publicación para su hora `publishAt`
`unschedule`	Elimina la hora programada y devuelve la publicación a borrador
`teamReview`	Envía la publicación a la cola de revisión del equipo
`approve`	Aprueba la publicación (desde un estado de revisión)
`reject`	Rechaza la publicación (desde un estado de revisión)

Redes compatibles

Los siguientes códigos de red se aceptan en los filtros de perfil, en el profileIds de publicación y en las ranuras de pies de foto/medios por red:

Código	Red
`facebook`	Facebook
`instagram` / `instagram_v2`	Instagram
`meta_ads`	Meta Ads
`linkedin`	LinkedIn
`youtube`	YouTube
`pinterest`	Pinterest
`google_my_business`	Google Business Profile
`tiktok`	TikTok
`threads`	Threads
`twitter`	X (Twitter)
`tumblr`	Tumblr
`blogger`	Blogger
`wordpress` / `wordpressorg`	WordPress

Conexión rápida

Claude.ai (web)

Ve a Claude.ai Connectors
Haz clic en + → Add custom connector
Introduce un nombre, por ejemplo Swonkie
Pega tu URL del servidor MCP y haz clic en Add

Claude Desktop (UI)

Abre Claude Desktop → Customize → Connectors (o usa el enlace directo claude://settings/connectors)
Haz clic en + → Add custom connector
Introduce un nombre, por ejemplo Swonkie
Pega tu URL del servidor MCP y haz clic en Add

Claude Desktop (archivo de configuración)

Asegúrate de que Claude Desktop esté actualizado: Claude menu → Check for Updates...
Abre Settings → Developer → Edit Config (o usa claude://settings/developer)
Añade lo siguiente a tu archivo de configuración:

{
  "mcpServers": {
    "swonkie": {
      "type": "http",
      "url": "https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY"
    }
  }
}

Guarda el archivo y reinicia Claude Desktop

ChatGPT

Ve a Settings → Apps → Advanced y activa Developer Mode (o abre directamente)
Ve a Connectors y haz clic en Create app (o abre directamente)
Introduce un nombre, por ejemplo Swonkie
Pega tu URL del servidor MCP como URL del conector

n8n

Abre tu flujo de trabajo y añade un nodo MCP Client (documentación de MCP de n8n)
Configura el transporte como Streamable HTTP
Pega la siguiente configuración en los ajustes del nodo:

{
  "transport": "streamable-http",
  "url": "https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY"
}

Otros clientes MCP

Abre o crea tu archivo de configuración MCP (por ejemplo, .mcp.json, mcp.json o el equivalente de tu cliente)
Añade la siguiente entrada a la sección mcpServers:

{
  "mcpServers": {
    "swonkie": {
      "type": "http",
      "url": "https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY"
    }
  }
}

Guarda el archivo y reinicia tu cliente

Buenas prácticas de seguridad

Usa claves separadas por cliente. Asigna la URL Primary a una herramienta y la Secondary a otra. Si una se ve comprometida, puedes rotarla sin afectar a la otra.
Rota si se expone. Ve a Settings → Workspace → API y rota la clave afectada. La nueva clave es válida inmediatamente; la anterior queda invalidada.
Nunca compartas URLs MCP públicamente. La URL contiene tu clave de API activa. No la publiques en repositorios públicos, canales de Slack ni tickets de soporte.
Revoca rotando. No existe una acción de revocación independiente: rotar una clave es la forma de invalidar una URL.