Instalar o ejecutar una vez
El paquete público es @anakonn/ankk y el binario es ankk. El CLI actualmente requiere Bun.
bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health
Desarrolladores
Utilice Ankk de CLI, API, y herramientas AI
Instale Bun-first CLI, configure un API key público y envíe contenido preparado desde Codex, Claude Code, ChatGPT, scripts o herramientas de automatización a la programación de Ankk.
terminal
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --brand-ref acme --file payload.json
Inicio rápido
Una pequeña ruta que demuestra el paquete, API key y el flujo de trabajo de publicación con alcance de marca.
Configurar de forma segura
Utilice un API key de Ankk. La salida del comando redacta la clave completa y las variables de entorno funcionan para CI.
ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --brand-ref <brand_ref> --api-key-env ANKK_API_KEY --yes
ankk config show
Publicar contenido preparado
Cree una carga útil JSON y entréguela al mismo contrato de programación pública utilizado por los clientes API.
ankk brands list --json
ankk contents publish --brand-ref <brand_ref> --file payload.json
ankk contents publish --brand-ref <brand_ref> --file payload.json --scheduled-for 2026-07-01T09:00:00Z
Carga útil
Enviar JSON en lugar de reconstruir formularios
Utilice --file para los cuerpos de contenido para que los scripts y las herramientas AI puedan producir cargas útiles estructuradas sin una frágil pila de indicadores.
- Mantenga los elementos de carga útil fuera de git cuando contengan datos de clientes.
- Utilice claves de idempotencia para una automatización repetible.
- Trato aceptado según lo programado, no realizado por el proveedor.
{
"connection_id": "<connection_id>",
"idempotency_key": "launch-thread-2026-07-01",
"sns_type": "threads",
"text": "Launch update from Ankk",
"scheduled_for": "2026-07-01T09:00:00Z"
}
API
Llamar al público API directamente
Cada flujo de trabajo CLI se asigna al público /v1 API. Utilice rutas de autenticación y de alcance de marca Bearer para clientes de automatización.
- Utilice GET /v1/brands para descubrir marcas accesibles.
- Utilice /v1/docs y /v1/openapi.json para el contrato público.
- Nunca pegue API keys completo en registros o tickets.
curl -X POST https://api-public.ankk.app/v1/brands/<brand_ref>/contents \
-H "Authorization: Bearer spk_..." \
-H "Content-Type: application/json" \
--data @payload.json
Estado
Seguimiento del trabajo después de la aceptación
La publicación es asíncrona. El API acepta el trabajo validado, lo conserva y programa su ejecución; La finalización del proveedor ocurre más tarde.
- Los estados esperados incluyen aceptado, en cola, publicando, publicado, fallido y reintento.
- Utilice webhooks firmado cuando otro sistema necesite actualizaciones de estado.
- El estado operativo permanece en Ankk en lugar del mensaje AI.
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json
Solicitar a las herramientas AI que utilicen Ankk, no que lo reemplacen
Deje que la herramienta AI prepare copias, cargas útiles o comandos. Ankk sigue siendo el sistema de programación y estado.
Codex
Cree una carga útil de lanzamiento Threads a partir de esta nota de la versión, guárdela como tmp/launch-thread.json y luego ejecute ankk contents publish con mi marca configurada.
Claude Code
Inspeccione payload.json en busca de ID de conexión, clave de idempotencia, tipo de sns, texto y programado_for faltantes. Luego muestre el comando ankk contents publish exacto.
ChatGPT
Redacte tres variantes de publicaciones seguras para canales y devuelva una carga útil JSON que pueda pasar a ankk contents publish --file payload.json.
Límites de seguridad
No exponga spk_ API keys completo a modelos, registros, capturas de pantalla ni comentarios de problemas.
No diga a los usuarios que el éxito del comando significa que la publicación del proveedor ya se realizó correctamente.
No documente comandos CLI ocultos o inactivos como funciones públicas.
Utilice API keys, webhooks y verificaciones de estado para la automatización en lugar del acceso directo a la base de datos.
¿Listo para conectar Ankk a su flujo de trabajo?
Comience con CLI, luego mueva las mismas cargas útiles a scripts, trabajos de CI o ejecuciones de herramientas AI.