PostLake

Una sola API que permite a desarrolladores y agentes de IA publicar, programar y obtener análisis en redes sociales sin integrar cada plataforma por separado.

Documentación

PostLake — Servidor MCP y habilidades de agente para redes sociales

PostLake es la API de redes sociales para agentes de IA. Una sola integración para publicar, programar y medir en todas las redes — X, LinkedIn, Instagram, TikTok, Facebook, Threads, Bluesky, YouTube y Pinterest — con una forma de respuesta normalizada sobre la que un agente puede razonar, en lugar de nueve formatos de error diferentes.

Este repositorio contiene las habilidades de agente y documenta el servidor MCP alojado.


Configuración de MCP

PostLake es un servidor MCP remoto — no hay nada que instalar, ejecutar o autoalojar. Apunta tu cliente a la URL y aprueba una vez mediante OAuth:

{
  "mcpServers": {
    "postlake": {
      "url": "https://api.postlake.dev/mcp"
    }
  }
}

Nota: PostLake no se lanza con un command local. Cualquier configuración que ejecute npx para iniciar este servidor es incorrecta — el servidor está alojado en la URL anterior. (El comando npx skills add … más abajo instala las habilidades de agente opcionales; no inicia un servidor MCP).


Inicio rápido — MCP

Tu agente nunca ve una clave de API; OAuth gestiona la autorización.

Claude

claude mcp add postlake https://api.postlake.dev/mcp

O en Claude Desktop: Configuración → Conectores → Añadir conector personalizado.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "postlake": { "url": "https://api.postlake.dev/mcp" }
  }
}

Gemini CLI

gemini mcp add postlake https://api.postlake.dev/mcp

VS Code / GitHub Copilot

Modo agente → Servidores MCP → Añadir, y luego pega la misma URL.

Autenticación por cabecera (para clientes sin OAuth)

POST https://api.postlake.dev/v1/mcp
Authorization: Bearer <your_api_key>

Luego solo pregunta:

"Publica esta foto en Instagram y LinkedIn, programa un seguimiento para el viernes a las 9am, y dime cuál de las publicaciones de la semana pasada funcionó mejor."


El conjunto de herramientas

Un conjunto enfocado — todo lo que un agente necesita para publicar y razonar sobre el resultado, y nada que no necesite. La configuración de la cuenta y la conexión de redes permanecen en el panel de control, donde pertenece un humano.

GrupoHerramientas
Publicar y programarcreate_post · edit_post · cancel_post · get_post · list_posts
Descubrir y validarget_platform_capabilities · validate_post · get_publish_info
Canales y medioslist_social_accounts · list_account_targets · list_profiles · upload_media
Analíticaget_analytics · get_post_analytics
Identidadwhoami

Seguro para agentes por diseño. La publicación es idempotente — pasa un Idempotency-Key y un agente que reintenta o se reinicia nunca puede publicar dos veces. Cada publicación devuelve un state y url por plataforma en una sola forma, por lo que no hay ramificaciones por red.


Habilidades de agente

Para agentes de codificación (Claude Code, Cursor, Codex, Windsurf) que usan habilidades basadas en archivos en lugar de MCP:

npx skills add postlake/postlake-mcp --all
HabilidadLo que tu agente puede hacer
postlake-accountsListar cuentas conectadas; ver qué plataformas están listas
postlake-publishPublicar una publicación ahora en una o más plataformas
postlake-scheduleProgramar para más tarde; listar, reprogramar o cancelar
postlake-mediaSubir una imagen o video y adjuntarlo a una publicación
postlake-analyticsLeer rendimiento por publicación y entre plataformas

Configura tu clave una vez:

export POSTLAKE_API_KEY="sk_live_…"

Crea una en https://app.postlake.dev/app/keys.


Tres formas de conectarse

Mejor paraAutenticación
Servidor MCPClaude, Cursor, ChatGPT, Gemini, cualquier cliente MCPOAuth (sin clave expuesta)
Habilidades de agente (este repositorio)Claude Code, Cursor, Codex, WindsurfPOSTLAKE_API_KEY
API RESTLangChain, CrewAI, AutoGen, herramientas de OpenAI, cualquier lenguajeClave Bearer

URL base REST: https://api.postlake.dev/v1 — consulta la documentación completa y las guías por framework para LangChain, CrewAI, AutoGen, Python y Node.js.


Seguridad

Los agentes se autorizan mediante OAuth, por lo que una clave de API nunca se pega en un chat ni la ve el modelo. Cada agente que autorizas aparece en Aplicaciones conectadas en tu panel de control — revoca cualquiera y su acceso se corta inmediatamente.

Precios

Créditos basados en uso: 1 crédito por publicación, con un nivel gratuito y sin tarjeta para empezar. X cuesta más porque es la única red que cobra por publicación. Consulta https://postlake.dev/pricing.


Listado en el Registro oficial de MCP como dev.postlake/social.

Hecho por CrumbleLake. Issues y PRs bienvenidos.