クイックスタート
パッケージ、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 --api-key-env ANKK_API_KEY --yes
ankk config show準備されたコンテンツを公開する
JSON ペイロードを作成し、それを API クライアントが使用するのと同じパブリック スケジューリング コントラクトに渡します。
ankk brand get --json
ankk contents publish --file payload.json
ankk contents publish --file payload.json --scheduled-for 2026-07-01T09:00:00Zフォームを再構築する代わりに JSON を送信します
ペイロード
コンテンツ本文に —file を使用すると、スクリプトと AI ツールが脆弱なフラグの山を作成せずに構造化されたペイロードを生成できます。
{
"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"
}- ペイロード フィクスチャに顧客データが含まれる場合は、ペイロード フィクスチャを git の外に置きます。
- 反復可能な自動化には冪等キーを使用します。
- 治療はプロバイダーによる成功ではなく、スケジュールどおりに受け入れられました。
パブリック API に直接電話をかける
API
すべての CLI ワークフローはパブリック /v1 API にマッピングされます。自動化クライアントにはベアラー認証とブランドスコープのルートを使用します。
curl -X POST https://api-public.ankk.app/v1/brand/contents
-H "Authorization: Bearer spk_..."
-H "Content-Type: application/json"
--data @payload.json- GET /v1/brand を使用して、アクセスしやすいブランドを見つけてください。
- 公開契約には /v1/docs と /v1/openapi.json を使用します。
- 完全な API キーをログやチケットに貼り付けないでください。
承認後の作業を追跡する
ステータス
公開は非同期です。 API は検証された作業を受け入れ、それを永続化し、実行をスケジュールします。プロバイダーの完了は後で行われます。
ankk contents list --json
ankk contents get --content-id <content_id> --json- 予期される状態には、承認済み、キューに登録済み、公開中、公開済み、失敗、および再試行が含まれます。
- 別のシステムでステータスの更新が必要な場合は、署名付き webhooks を使用します。
- 動作ステータスは AI プロンプトではなく Ankk のままです。
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、およびステータス チェックを使用します。