Documentación de SociaHive
Guías rápidas, configuración del MCP, patrones de flujo, recetas del cookbook y referencias de los SDK de la plataforma de automatización SociaHive.
Controla SociaHive (programación de publicaciones en redes sociales, flujos de automatización, contactos y estadísticas) por código. Elige la puerta que mejor te encaje.
Las tres puertas
Para asistentes de IA
Deja que Claude, ChatGPT, Cursor o cualquier asistente compatible con MCP use SociaHive por ti. Configuración en dos minutos con MCP.
Para desarrolladores
Llama directamente a la API REST o usa los SDK oficiales de Node y Python en tu aplicación. Incluye cURL, OpenAPI y generación de código.
Para quienes automatizan sin código
El nodo de la comunidad de n8n, n8n-nodes-sociahive, está en npm. Las fichas de Zapier y Make llegarán pronto; hasta entonces, apunta un nodo HTTP genérico a la API REST.
Qué más hay aquí
- Patrones de flujo: siete patrones con nombre (enrutador por palabra clave, respaldo con IA, secuencia con ramas, etc.) que cubren casi todo lo que se construye con los flujos de SociaHive.
- Cookbook: tres recetas completas que puedes copiar y ejecutar hoy: responder automáticamente a los comentarios de Instagram, programar una semana de publicaciones desde un CSV y recibir un resumen diario de rendimiento con Claude.
Las superficies de un vistazo
| Superficie | URL / paquete | Autenticación | Ideal para |
|---|---|---|---|
| Servidor MCP (HTTP) | https://www.sociahive.com/api/mcp | OAuth 2.1 + DCR o X-API-Key | Asistentes de IA: Claude, ChatGPT, Cursor |
| Servidor MCP (stdio) | binario sociahive-mcp | X-API-Key | Clientes de IA locales (Claude Desktop, Claude Code) |
| API REST v1 | https://www.sociahive.com/api/v1/* | X-API-Key o token bearer de OAuth | Cualquier cliente HTTP; es la base de los SDK |
| CLI | sociahive (npm) | variable de entorno SOCIAHIVE_API_KEY | Scripts de shell, CI/CD, operaciones puntuales |
| SDK de Node | @sociahive/sdk | Igual que REST | Código de aplicación en TypeScript / Node.js |
| SDK de Python | sociahive (PyPI) | Igual que REST | Código de aplicación en Python |
Endpoints auxiliares:
- Referencia interactiva de la API: interfaz de Scalar que muestra la especificación OpenAPI 3.1, con pruebas en vivo.
- Especificación OpenAPI 3.1: legible por máquinas; úsala en Postman, en GPT personalizados de ChatGPT o en cualquier generador de SDK.
- Descubrimiento de OAuth:
/.well-known/oauth-authorization-server(RFC 8414) y/.well-known/oauth-protected-resource(RFC 9728). Los clientes MCP los usan para iniciar la autenticación de forma automática.