1forh/sendcove

Usando Sendcove

Sendcove es un programador de redes sociales. Su servidor MCP te proporciona herramientas para gestionar las publicaciones, archivos multimedia, análisis y bandeja de entrada del usuario. Si no hay herramientas de Sendcove disponibles, indícale al usuario que conecte Sendcove (guías de configuración: https://www.sendcove.app/features/mcp).

Empieza con las cuentas

1. Llama a list_accounts antes de crear o modificar una publicación. Pasa los id devueltos como accountIds; Sendcove determina las plataformas a partir de ellos.
2. Si el usuario tiene varias cuentas y no dijo cuál usar, pregunta. No publiques en todas las cuentas por defecto.
3. Una cuenta con needsReconnect: true fallará al publicar. Indícale al usuario que la reconecte en Sendcove.

Creando publicaciones

• create_post crea un borrador a menos que establezcas status. Los borradores son la opción segura por defecto: crea uno, muéstrale al usuario lo que hiciste y deja que lo programe o publique.
• content es el texto predeterminado para todas las plataformas. Usa platformContent para darle a una plataforma su propio texto, por ejemplo, una versión de 280 caracteres para twitter y un pie de foto más largo para instagram. Claves: twitter, instagram, tiktok, threads, bluesky, facebook, linkedin (cadenas) y youtube ({ title, description }).
• Las opciones por plataforma (tipo de publicación de Instagram, tipo y visibilidad de video de YouTube, privacidad de TikTok, configuración de respuestas de Bluesky, comunidad de X, etc.) van en platformSettings. Toma los campos y valores permitidos del esquema de entrada de la herramienta y sus descripciones en lugar de adivinar. Antes de establecer platformSettings.tiktok, llama a get_tiktok_creator_info para conocer los niveles de privacidad e interacciones que permite esa cuenta.
• Los límites de caracteres se verifican al publicar: X 280, Bluesky 300, Threads 500, Instagram y TikTok 2200, LinkedIn 3000, título de YouTube 100 y descripción 5000. Mantén el texto de cada plataforma dentro de su límite (usa platformContent) para que la publicación no falle después.
• Las publicaciones de Instagram y TikTok necesitan medios; YouTube necesita un video.
• Threads: pasa las publicaciones de seguimiento como threadItems (cada una { content, mediaUrls? }). Se publican como un hilo en X, Bluesky y Threads (Pro y Max); otras plataformas reciben solo content. update_post con threadItems: [] detiene el encadenamiento.
• Hashtags: list_hashtag_sets devuelve los conjuntos guardados del usuario (almacenados sin #).
• Pasa un idempotencyKey (cualquier cadena única, de 8 a 200 caracteres) a create_post, duplicate_post y reply_to_inbox_item. Si una llamada se agota o no estás seguro de que se haya completado, reinténtala con la misma clave: obtienes el primer resultado en lugar de una publicación o respuesta duplicada.
• update_post solo cambia los campos que pasas, pero platformContent, platformSettings y threadItems reemplazan todo el valor almacenado. Llama a get_post primero y envía el objeto completo.

Medios

• Los archivos multimedia deben estar en la biblioteca de medios de Sendcove del usuario antes de poder incluirlos en mediaUrls. list_media muestra lo que ya está allí.
• Una URL https pública: upload_media_from_url, luego usa la url devuelta.
• Un archivo local: llama a create_media_upload_url y ejecuta el comando curl devuelto con la ruta real del archivo (por ejemplo, curl -s -X POST '<uploadUrl>' -F 'file=@/path/to/photo.jpg'). La respuesta JSON tiene la url a usar. La URL de carga dura 10 minutos y no necesita clave API. Para archivos de más de 4 MB, pasa contentType y ejecuta los dos comandos devueltos (PUT al almacenamiento, luego el POST de finalización) en ese orden. Agrega -F convertForInstagram=true para convertir una imagen a JPEG para Instagram.
• Tipos permitidos: JPEG, PNG, GIF, WebP, MP4, MOV, AVI.

Programación y publicación

Solo programa, publica o responde cuando el usuario lo haya solicitado en esta conversación. Escribir una publicación no es permiso para publicarla.

• Programar: status: "scheduled" con scheduledFor como ISO 8601 con desplazamiento (2026-11-20T15:00:00Z). Convierte la hora local del usuario y confirma la zona horaria si no está clara. O pasa nextOpenSlot: true para usar el próximo horario de publicación libre que el usuario configuró para esas cuentas.
• Publicar ahora: status: "pending" en create_post, o publish_post para una publicación existente.
• Después de publicar, llama a get_post: cada cuenta tiene su propio status (published, failed, pending) y error. Una publicación fallida generalmente significa que una cuenta falló. publish_post en esa publicación reintenta solo las cuentas fallidas; nunca vuelve a publicar donde ya está en vivo.
• delete_post no se puede deshacer. Confirma antes de eliminar.

Conexiones solo de borradores (403)

La programación, publicación y respuestas requieren un plan Pro o Max y una conexión que permita la publicación. En el plan Basic, o con una clave API o aplicación conectada configurada solo para borradores, esas llamadas devuelven 403 "Esta clave API o aplicación conectada solo puede crear borradores".

Cuando esto ocurra, no reintentes ni busques una solución alternativa. Guarda la publicación como borrador e indícale al usuario:

Guardé esto como borrador en Sendcove. Esta conexión es solo de borradores, por lo que no puedo programarlo ni publicarlo. Para permitirme publicar, necesitas un plan Pro o Max, luego reconectar Sendcove aquí y elegir "Permitir publicación" (o usar una clave API creada con "Permitir publicación" activada, en Cuenta > Claves API en Sendcove). También puedes programar el borrador tú mismo en Sendcove.

Análisis y bandeja de entrada

• get_engagement: totales, desglose por plataforma, mejores publicaciones y las mejores publicaciones recientes de cada cuenta en comparación con su mediana (timesMedian muestra cuánto mejor le fue a una publicación, no por qué).
• get_post_analytics: métricas de una publicación publicada por cuenta; pasa refresh: true para obtener números actualizados (almacenados en caché durante una hora). No todas las plataformas reportan todas las métricas.
• get_best_times: mejores días y horas para publicar, basados en la interacción del usuario.
• list_inbox / get_inbox_item: respuestas, menciones y comentarios. reply_to_inbox_item publica una respuesta pública, por lo que muestra el texto al usuario y obtén una confirmación primero. update_inbox_item marca elementos como leídos, no leídos o archivados.