Instale ou execute uma vez
O pacote público é @anakonn/ankk e o binário é ankk. O CLI atualmente requer Bun.
bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health
Desenvolvedores
Use Ankk de CLI, API, Ferramentas e AI
Instale o Bun-first CLI, configure um API key público e envie conteúdo preparado de Codex, Claude Code, ChatGPT, scripts ou ferramentas de automação para o agendamento Ankk.
terminal
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --brand-ref acme --file payload.json
Início rápido
Um pequeno caminho que comprova o pacote, API key, e o fluxo de trabalho de publicação com escopo de marca.
Configurar com segurança
Use um API key de Ankk. A saída do comando redige a chave completa e as variáveis de ambiente funcionam 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 conteúdo preparado
Crie uma carga JSON e entregue-a ao mesmo contrato de agendamento público usado pelos 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 em vez de reconstruir formulários
Use --file para corpos de conteúdo para que scripts e ferramentas AI possam produzir cargas estruturadas sem uma pilha frágil de sinalizadores.
- Mantenha os fixtures de carga útil fora do git quando eles contiverem dados do cliente.
- Use chaves de idempotência para automação repetível.
- Tratamento aceito conforme programado, mas não bem-sucedido pelo provedor.
{
"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
Chame o API público diretamente
Cada fluxo de trabalho CLI é mapeado de volta para o público /v1 API. Use autenticação Bearer e rotas com escopo de marca para clientes de automação.
- Use GET /v1/brands para descobrir marcas acessíveis.
- Use /v1/docs e /v1/openapi.json para o contrato público.
- Nunca cole API keys completo em logs ou 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
Acompanhe o trabalho após aceitação
A publicação é assíncrona. O API aceita trabalho validado, persiste e agenda a execução; a conclusão do provedor acontece mais tarde.
- Os estados esperados incluem aceito, enfileirado, publicação, publicado, falha e nova tentativa.
- Use webhooks assinado quando outro sistema precisar de atualizações de status.
- O status operacional permanece em Ankk em vez do prompt AI.
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json
Solicitar às ferramentas AI para usar Ankk, não substituí-lo
Deixe a ferramenta AI preparar cópias, cargas úteis ou comandos. Ankk continua sendo o sistema de agendamento e status.
Codex
Crie uma carga útil de inicialização Threads a partir desta nota de versão, salve-a como tmp/launch-thread.json e execute ankk contents publish com minha marca configurada.
Claude Code
Inspecione payload.json em busca de connection_id, idempotency_key, sns_type, text e Scheduled_for ausentes. Em seguida, mostre o comando ankk contents publish exato.
ChatGPT
Elabore três variantes de postagem seguras para canais e retorne uma carga JSON que posso passar para ankk contents publish --file payload.json.
Limites de segurança
Não exponha spk_ API keys completo a modelos, registros, capturas de tela ou comentários de problemas.
Não diga aos usuários que o sucesso do comando significa que a publicação do provedor já foi bem-sucedida.
Não documente comandos CLI ocultos ou inativos como recursos públicos.
Use API keys, webhooks e verificações de status para automação em vez de acesso direto ao banco de dados.
Pronto para conectar o Ankk ao seu fluxo de trabalho?
Comece com CLI e, em seguida, mova as mesmas cargas úteis para scripts, tarefas de CI ou execuções da ferramenta AI.