開発者

CLI、API、からAnkkを使用 および AI ツール

Bun-first CLI をインストールし、公開鍵 API を設定し、準備されたコンテンツを Codex、Claude Code、ChatGPT、スクリプト、または自動化ツールから Ankk スケジューリングに送信します。

terminal
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --brand-ref acme --file payload.json

クイックスタート

パッケージ、API キー、およびブランドを対象とした公開ワークフローを証明する小さなパス。

インストールまたは一度実行

公開パッケージは @anakonn/ankk 、バイナリは ankk です。 CLI には現在 Bun が必要です。

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

安全に構成する

Ankk の API キーを使用します。コマンド出力は完全なキーを編集し、環境変数は 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

準備されたコンテンツを公開する

JSON ペイロードを作成し、それを 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
ペイロード

フォームを再構築する代わりに JSON を送信します

コンテンツ本文に --file を使用すると、スクリプトと AI ツールが脆弱なフラグの山を作成せずに構造化されたペイロードを生成できます。

  • ペイロード フィクスチャに顧客データが含まれる場合は、ペイロード フィクスチャを git の外に置きます。
  • 反復可能な自動化には冪等キーを使用します。
  • 治療はプロバイダーによる成功ではなく、スケジュールどおりに受け入れられました。
{
"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

パブリック API に直接電話をかける

すべての CLI ワークフローはパブリック /v1 API にマッピングされます。自動化クライアントにはベアラー認証とブランドスコープのルートを使用します。

  • GET /v1/brands を使用して、アクセスしやすいブランドを見つけてください。
  • 公開契約には /v1/docs と /v1/openapi.json を使用します。
  • 完全な API キーをログやチケットに貼り付けないでください。
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
ステータス

承認後の作業を追跡する

公開は非同期です。 API は検証された作業を受け入れ、それを永続化し、実行をスケジュールします。プロバイダーの完了は後で行われます。

  • 予期される状態には、承認済み、キューに登録済み、公開中、公開済み、失敗、および再試行が含まれます。
  • 別のシステムでステータスの更新が必要な場合は、署名付き webhooks を使用します。
  • 動作ステータスは AI プロンプトではなく Ankk のままです。
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json

AI ツールに Ankk を置き換えるのではなく、使用するように促します

AI ツールにコピー、ペイロード、またはコマンドを準備させます。 Ankk は、スケジュールおよびステータス システムのままです。

Codex

このリリース ノートから Threads 起動ペイロードを作成し、それを tmp/launch-thread.json, として保存し、構成したブランドで ankk コンテンツ パブリッシュを実行します。

Claude Code

payload.json で connection_id、idempotency_key、sns_type、text、scheduled_for が欠落していないか調べます。次に、正確な ankk コンテンツ パブリッシュ コマンドを表示します。

ChatGPT

3 つのチャネルセーフ投稿バリアントをドラフトし、ankk コンテンツに渡すことができる 1 つの JSON ペイロードを返します。

安全境界線

完全な spk_ API キーをモデル、ログ、スクリーンショットに公開したり、コメントを発行したりしないでください。
コマンドの成功はプロバイダーの公開がすでに成功していることを意味することをユーザーに伝えないでください。
非表示または休止状態の CLI コマンドを公開機能として文書化しないでください。
データベースへの直接アクセスの代わりに、自動化のために API キー、webhooks、およびステータス チェックを使用します。

Ankk をワークフローに接続する準備はできましたか?

CLI から始めて、同じペイロードをスクリプト、CI ジョブ、または AI ツールの実行に移動します。