Use Ankk via CLI, APIe ferramentas de IA

Início rápido

Teste a instalação do CLI, a configuração da chave de API e a publicação na marca vinculada a essa chave.

Instale ou execute uma vez

O pacote público é @anakonn/ankk e o comando é ankk. O CLI requer Bun.

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

Configurar com segurança

Use uma chave de API do Ankk. A saída do comando oculta a chave completa, e variáveis de ambiente podem ser usadas em 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 conteúdo preparado

Salve o conteúdo em um arquivo JSON e envie para a mesma interface pública de agendamento usada pelos clientes da 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 em vez de reconstruir formulários

Carga útil

Use --file para enviar o conteúdo. Scripts e ferramentas de IA podem criar um arquivo JSON sem combinar vários parâmetros de linha de comando.

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

• Não salve no Git arquivos de exemplo que contenham dados de clientes.
• Use chaves de idempotência para repetir a automação com segurança.
• Recebido significa que a solicitação foi validada, salva e agendada. Confira o status final para confirmar que a publicação foi concluída.

Chame a API pública diretamente

API

As operações do CLI correspondem à API pública /v1. Use autenticação Bearer; a chave de API seleciona a marca das rotas /v1/brand.

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

• Use GET /v1/brand para consultar a marca vinculada à chave de API.
• Consulte /v1/docs e /v1/openapi.json para conhecer a interface pública.
• Nunca cole chaves de API completas em logs ou chamados de suporte.

Acompanhe o status após o recebimento

Estado

Recebido significa que a solicitação foi validada, salva e agendada. Confira o status final para confirmar que a publicação foi concluída.

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

• Códigos de status: accepted, queued, publishing, published, failed, retry.
• Use webhooks assinados para informar mudanças de status a outros sistemas.
• Receber uma solicitação é o primeiro passo. Acompanhe cada publicação até o resultado final e verifique as falhas quando necessário.

Solicitar às ferramentas IA para usar Ankk, não substituí-lo

Prepare conteúdo por conta própria ou com ferramentas externas de IA, agende nos canais compatíveis e acompanhe os resultados no Ankk.

Codex

Crie os dados de um post de lançamento para o Threads a partir destas notas, salve em tmp/launch-thread.json e execute ankk contents publish com minha marca configurada.

Claude Code

Confira se payload.json contém connection_id, idempotency_key, sns_type, text e scheduled_for. Depois mostre o comando exato ankk contents publish.

ChatGPT

Escreva três variações adequadas para os canais e retorne um arquivo JSON que eu possa enviar com ankk contents publish --file payload.json.

Limites de segurança

• Não exponha spk_ chaves de API 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 chaves de API, webhooks e verificações de status para automação em vez de acesso direto ao banco de dados.