Usa Ankk desde CLI, APIy herramientas de IA

Inicio rápido

Prueba la instalación del CLI, la configuración de la clave API y la publicación en la marca asociada a esa clave.

Instalar o ejecutar una vez

El paquete público es @anakonn/ankk y el comando es ankk. El CLI requiere Bun.

bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health

Configurar de forma segura

Usa una clave API de Ankk. La salida del comando oculta la clave completa y puedes usar variables de entorno en CI.

ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --api-key-env ANKK_API_KEY --yes
ankk config show

Publicar contenido preparado

Guarda el contenido en un archivo JSON y envíalo a la misma interfaz pública de programación que usan los clientes de la API.

ankk brand get --json
ankk contents publish --file payload.json
ankk contents publish --file payload.json --scheduled-for 2026-07-01T09:00:00Z

Enviar JSON en lugar de reconstruir formularios

Carga útil

Usa --file para enviar el contenido. Los scripts y las herramientas de IA pueden crear un archivo JSON sin tener que combinar muchos parámetros.

{
	"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"
}

• No guardes en Git archivos de ejemplo que contengan datos de clientes.
• Usa claves de idempotencia para repetir la automatización de forma segura.
• Recibido significa que la solicitud se validó, guardó y programó. Revisa el estado final para confirmar que la publicación se completó.

Llama directamente a la API pública

API

Las operaciones del CLI corresponden a la API pública /v1. Usa autenticación Bearer; la clave API determina la marca de las rutas /v1/brand.

curl -X POST https://api.ankk.app/v1/brand/contents \
  -H "Authorization: Bearer spk_..." \
  -H "Content-Type: application/json" \
  --data @payload.json

• Usa GET /v1/brand para consultar la marca asociada a la clave API.
• Consulta /v1/docs y /v1/openapi.json para conocer la interfaz pública.
• Nunca pegues claves API completas en registros o solicitudes de soporte.

Sigue el estado después de recibir la solicitud

Estado

Recibido significa que la solicitud se validó, guardó y programó. Revisa el estado final para confirmar que la publicación se completó.

ankk contents list --json
ankk contents get --content-id <content_id> --json

• Códigos de estado: accepted, queued, publishing, published, failed, retry.
• Usa webhooks firmados para enviar cambios de estado a otros sistemas.
• Recibir una solicitud es el primer paso. Sigue cada publicación hasta el resultado final y revisa los errores cuando sea necesario.

Solicitar a las herramientas IA que utilicen Ankk, no que lo reemplacen

Prepara contenido por tu cuenta o con herramientas de IA externas, prográmalo en los canales compatibles y revisa los resultados en Ankk.

Codex

Crea los datos de una publicación de lanzamiento para Threads a partir de estas notas y guárdalos en tmp/launch-thread.json. Ejecuta ankk contents publish con mi marca configurada.

Claude Code

Revisa que payload.json incluya connection_id, idempotency_key, sns_type, text y scheduled_for. Después muestra el comando exacto ankk contents publish.

ChatGPT

Redacta tres variantes adecuadas para cada canal y devuelve un archivo JSON que pueda enviar con ankk contents publish --file payload.json.

Límites de seguridad

• No exponga spk_ claves de API 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 claves de API, webhooks y verificaciones de estado para la automatización en lugar del acceso directo a la base de datos.