Installer ou exécuter une fois
Le package public est @anakonn/ankk et le binaire est ankk. Le CLI nécessite actuellement Bun.
bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health
Développeurs
Utilisez Ankk de CLI, API, et outils AI
Installez Bun-first CLI, configurez un API key public et envoyez le contenu préparé à partir de Codex, Claude Code, ChatGPT, des scripts ou des outils d'automatisation dans la planification Ankk.
terminal
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --brand-ref acme --file payload.json
Démarrage rapide
Un petit chemin qui prouve le package, API key et le workflow de publication à l'échelle de la marque.
Configurez en toute sécurité
Utilisez un API key de Ankk. La sortie de la commande supprime la clé complète et les variables d'environnement fonctionnent pour 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
Publier le contenu préparé
Créez une charge utile JSON et transmettez-la au même contrat de planification public utilisé par les clients 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
Charge utile
Envoyer du JSON au lieu de reconstruire les formulaires
Utilisez --file pour les corps de contenu afin que les scripts et les outils AI puissent produire des charges utiles structurées sans une pile fragile d'indicateurs.
- Conservez les éléments de charge utile en dehors de git lorsqu'ils contiennent des données client.
- Utilisez des clés d'idempotence pour une automatisation reproductible.
- Traitement accepté comme prévu, mais non réussi par le fournisseur.
{
"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
Appelez directement le public API
Chaque flux de travail CLI renvoie au public /v1 API. Utilisez l'authentification Bearer et les routes à portée de marque pour les clients d'automatisation.
- Utilisez GET /v1/brands pour découvrir des marques accessibles.
- Utilisez /v1/docs et /v1/openapi.json pour le contrat public.
- Ne collez jamais API keys complet dans des journaux ou des 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
Statut
Suivre les travaux après acceptation
La publication est asynchrone. Le API accepte le travail validé, le conserve et planifie son exécution ; l'achèvement du fournisseur se produit plus tard.
- Les états attendus incluent accepté, mis en file d'attente, publication, publié, échoué et nouvelle tentative.
- Utilisez webhooks signé lorsqu'un autre système a besoin de mises à jour d'état.
- L'état opérationnel reste dans Ankk au lieu de l'invite AI.
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json
Invite les outils AI à utiliser Ankk, et non à le remplacer
Laissez l'outil AI préparer la copie, les charges utiles ou les commandes. Ankk reste le système de planification et de statut.
Codex
Créez une charge utile de lancement Threads à partir de cette note de version, enregistrez-la sous tmp/launch-thread.json, puis exécutez ankk contents publish avec ma marque configurée.
Claude Code
Inspectez payload.json pour détecter les éléments connection_id, idempotency_key, sns_type, text et selected_for manquants. Affichez ensuite la commande exacte ankk contents publish.
ChatGPT
Rédigez trois variantes de publication sécurisées pour les canaux et renvoyez une charge utile JSON que je peux transmettre à ankk contents publish --file payload.json.
Limites de sécurité
Ne pas exposer l'intégralité du spk_ API keys aux modèles, journaux, captures d'écran ou émettre des commentaires.
Ne dites pas aux utilisateurs que le succès de la commande signifie que la publication du fournisseur a déjà réussi.
Ne documentez pas les commandes CLI masquées ou dormantes en tant que fonctionnalités publiques.
Utilisez API keys, webhooks et les vérifications d'état pour l'automatisation au lieu de l'accès direct à la base de données.
Prêt à intégrer Ankk dans votre flux de travail ?
Commencez par CLI, puis déplacez les mêmes charges utiles dans des scripts, des tâches CI ou des exécutions d'outils AI.