API y agentes
Tus flujos, pidiéndolos en una frase.
Conecta Claude o ChatGPT a CoreDM y pídele el flujo. Lo crea por la API, en borrador, con la misma revisión de seguridad que el editor antes de activarlo. También puedes usarla desde tu propio código.
Empezar
- 01
Crea una clave
En CoreDM, Ajustes → API y agentes. Elige la cuenta de Instagram, ponle un nombre y marca los permisos: consultar, crear y editar borradores, publicar y pausar, o borrar. La clave se muestra una sola vez; guárdala como un secreto.
- 02
Una clave = una cuenta
Cada clave ve y modifica solo la cuenta de Instagram que elegiste. Si gestionas varias cuentas, crea una clave por cuenta.
- 03
Llama a la API
Base: https://coredm.app/api/external/v1. Autenticación: cabecera Authorization: Bearer cdm_… Las respuestas son JSON.
curl https://coredm.app/api/external/v1/account \
-H "Authorization: Bearer $COREDM_API_KEY"Conectar Claude o ChatGPT
Como conector, sin copiar claves (recomendado)
- Claude (web o escritorio): Ajustes → Conectores → Añadir conector personalizado → URL https://coredm.app/api/mcp → Conectar. Inicias sesión en CoreDM, eliges tu cuenta de Instagram y pulsas Permitir.
- ChatGPT: Ajustes → Apps y conectores → activa el modo desarrollador → Crear → URL https://coredm.app/api/mcp con autenticación OAuth. Inicias sesión en CoreDM y pulsas Permitir.
- Puedes quitar el acceso cuando quieras en CoreDM → Ajustes → API y agentes: aparece como «… (conector)».
Otras formas de conectarlo
Claude Code: un comando; la primera vez te pide iniciar sesión.
claude mcp add --transport http coredm https://coredm.app/api/mcp
# luego, dentro de Claude Code: /mcp → coredm → iniciar sesiónClaude Desktop con clave de API (alternativa): añade esto a claude_desktop_config.json (Ajustes → Desarrollador → Editar configuración) y reinicia Claude.
{
"mcpServers": {
"coredm": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://coredm.app/api/mcp",
"--header", "Authorization:${AUTH_HEADER}"],
"env": { "AUTH_HEADER": "Bearer cdm_TU_CLAVE" }
}
}
}Necesita Node.js instalado. Usa el puente mcp-remote para conectar con el servidor de CoreDM.
ChatGPT con un GPT personalizado (alternativa): crea una Acción con la especificación OpenAPI.
- En ChatGPT: Explorar GPT → Crear → Configurar → Crear nueva acción.
- Importar desde URL: https://coredm.app/docs/api/openapi.json
- Autenticación: Clave de API → tipo Bearer → pega tu clave cdm_…
- En Instrucciones, pídele que muestre los avisos de seguridad antes de aceptarlos y que devuelva siempre el url_panel.
Ejemplos con curl
curl "https://coredm.app/api/external/v1/flows?limit=20" \
-H "Authorization: Bearer $COREDM_API_KEY"curl -X POST https://coredm.app/api/external/v1/flows \
-H "Authorization: Bearer $COREDM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: guia-reel-001" \
-d '{
"name": "GUÍA en mis reels",
"nodes": [
{ "id": "t1", "type": "trigger", "position": { "x": 0, "y": 0 },
"data": { "triggerType": "comment_keyword",
"keywords": [{ "value": "GUIA", "matchType": "contains" }],
"replyText": "¡Te la mando por DM!",
"replyTextVariants": ["Mira tus mensajes 👀"] } },
{ "id": "d1", "type": "delay", "position": { "x": 0, "y": 150 },
"data": { "duration": 1, "unit": "minutes" } },
{ "id": "m1", "type": "sendMessage", "position": { "x": 0, "y": 300 },
"data": { "messages": [{ "text": "Aquí tienes la guía: https://tu-web.com/guia.pdf",
"textVariants": ["Tu guía, como te prometí: https://tu-web.com/guia.pdf"] }] } }
],
"edges": [
{ "id": "e1", "source": "t1", "target": "d1" },
{ "id": "e2", "source": "d1", "target": "m1" }
]
}'Variantes de texto y una espera antes de responder: así no salta la revisión de riesgo. Consulta GET /node-schemas para ver todos los tipos de nodo y sus campos.
curl -X POST https://coredm.app/api/external/v1/flows/validate \
-H "Authorization: Bearer $COREDM_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "nodes": [...], "edges": [...] }'
# → { "valid": true, "review": [ { "code": "single_wording", "kind": "risk", ... } ] }# 1. Lee el flujo: su "etag" va en If-Match
curl https://coredm.app/api/external/v1/flows/$FLOW_ID -H "Authorization: Bearer $COREDM_API_KEY"
# 2. Publica
curl -X POST https://coredm.app/api/external/v1/flows/$FLOW_ID/publish \
-H "Authorization: Bearer $COREDM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: publicar-guia-001" \
-H 'If-Match: "flow:<id>:<revision>"' \
-d '{}'
# → 409 review_required: details.warnings explica cada aviso
# 3. Si la persona acepta los avisos, repite con sus códigos
-d '{ "acknowledge_warnings": ["single_wording"] }'curl -X POST https://coredm.app/api/external/v1/flows/$FLOW_ID/pause \
-H "Authorization: Bearer $COREDM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pausar-guia-001" \
-H 'If-Match: "flow:<id>:<revision>"' \
-d '{}'Reglas de la API
- Toda escritura lleva Idempotency-Key. Si reintentas con la misma, no se duplica nada.
- Editar, publicar, pausar o borrar un flujo lleva If-Match con su etag. Si alguien lo cambió en el editor mientras tanto, recibes 412: vuelve a leerlo.
- Publicar aplica la revisión del editor: un único texto para todos, responder sin espera o una palabra clave demasiado amplia pueden hacer que Instagram limite la cuenta. Con avisos, la API responde 409 review_required; enséñaselos a la persona y, si los acepta, repite con acknowledge_warnings.
- Los flujos se crean en borrador. Nada se envía hasta que lo publicas.
- Límite: 120 peticiones por minuto por cuenta.
- Errores: { error: { code, message, request_id, details, retryable } }.
OpenAPI y llms.txt
- Especificación OpenAPI 3.1 (JSON)
- Guía para modelos de lenguaje (llms.txt)
- Servidor MCP remoto:
https://coredm.app/api/mcp - OpenAPI URL:
https://coredm.app/docs/api/openapi.json