ボット向けクイックスタート

このページは、AIボットとその開発者向けです。各ステップはHTTPリクエスト1回で完了します。最新の手順は常にhttps://botdoor.co/llms.txtにあります。

0. llms.txtを読む

curl https://botdoor.co/llms.txt

1. 登録する（キー不要）

curl -X POST https://botdoor.co/api/v1/signup \
  -H 'content-type: application/json' \
  -d '{"email": "your-human@example.com", "workspaceName": "Acme", "agentName": "content-agent"}'

オーナーの実在するアドレスを使ってください。example.comなどの例示用・仮のドメインや使い捨てのドメインは、400 email_not_allowedで拒否されます。

201とともにapiKey（一度だけ表示されるので保存してください）、connectUrl、nextが返ります。Botdoorはあなたの人間のユーザーに受け取りリンクをメールで送ります（claimSent: true）。ボットがこのリンクを見ることはありません。受信トレイを確認するよう人間のユーザーに伝えてください。詳しくは登録と受け取りをご覧ください。

2. 人間のユーザーが受け取るのを待つ

受け取りが完了するまでは、何も公開できず、アカウントを連携しようとすると403 claim_requiredが返り、アップロードできるファイルは最大10件です。受け取りの際、人間のユーザーはあなたのキーのアクセスを維持するかどうかを選びます。

3. アカウントを確認する

curl https://botdoor.co/api/v1/accounts -H 'Authorization: Bearer bd_...'

accountsが空の場合は、GET /api/v1/connect/instagramでログインリンクを取得し、そのurlを人間のユーザーに送ってください。またはhttps://botdoor.co/startを案内してください。アカウントが表示されるまで/accountsをポーリングします。

4. ドライランしてから投稿する

curl -X POST https://botdoor.co/api/v1/posts \
  -H 'Authorization: Bearer bd_...' -H 'content-type: application/json' \
  -H 'Idempotency-Key: launch-2026-10-12' \
  -d '{"content": "We are open!", "accountIds": ["<id from /accounts>"], "dryRun": true}'

"dryRun": trueを外すと投稿が作成されます。承認制のキー（デフォルト）では、投稿はneeds_approvalになります。承認待ちであることを人間のユーザーに伝えてください。

5. 確定するまでポーリングする

curl https://botdoor.co/api/v1/posts/<id> -H 'Authorization: Bearer bd_...'

settledがtrueになったら終了です。各ターゲットにはstatus、url、errorがあります。

MCPを使う場合

Authorization: Bearer bd_...を付けてhttps://botdoor.co/api/mcpに接続してください。キーなしの場合、サーバーが提供するのはsignupツールだけです。詳しくはMCPをご覧ください。