AIエージェント向けのソーシャルメディアAPI

エージェントがソーシャルメディアに公開する場合、人間が行う場合とは異なる要件があります。そのほとんどは同じひとつの事実から来ています。それが動くその瞬間、誰も見ていないということです。

エージェントが必要とし、人間は必要としないもの

**本当に役立つ下書き状態。**隠されたキューではなく、人間が確認し、レビューし、公開できる投稿です。これはエージェントによる公開において最も重要な機能でありながら、後回しにされがちな機能です。

**公開時点ではなく公開前のバリデーション。**人間ならキャプションが長すぎることに気づきます。エージェントは気づきませんし、チェックが公開時点で行われるなら、失敗はエージェントがいなくなった数時間後に届きます。エラーは、エージェントが対応できる作成呼び出しの時点で返ってくる必要があります。

**スコープ付きで失効可能な認証情報。**他のキーとは別のものです。何かがうまくいかなかったとき、本番パイプラインが共有している認証情報をローテーションするのではなく、そのエージェントだけを失効させたいはずです。

**ループを止めるクォータ。**リトライループは短時間に大量の投稿を生み出しかねません。ここでの上限は課金階層の話にとどまらず、安全機能です。

**構造化されたエラー。**エージェントは「xでキャプションが280文字を超えている」には対応できます。一般的な400エラーには対応できません。

設計段階で対処すべき失敗のパターン

**自信満々の創作。**モデルは「分からない」と言う代わりに、もっともらしい統計、価格、機能に関する主張を作り出します。事実に関わることは何も生成させてはいけません。事実はあなたのコードが管理する情報源から取得してください。

**リトライの嵐。**タイムアウトを失敗とみなしてリトライするエージェントは、投稿を重複させる可能性があります。タイムアウトした作成リクエストが実は成功していることがあるからです。リトライは安全であるか、事前に確認されたものであるべきで、決して盲目的であってはいけません。

**間違ったタイミングでの公開。**エージェントは、今日が明るい内容を投稿するには悪い日だとは知りません。ニュースや論争に触れるものには人間が必要です。

**文体のドリフト。**放っておくと、生成される投稿は同じ調子に収束していき、それにあなたより先に読者が気づきます。

MCPかAPIキーか

エージェントを接続する方法は2つあり、それぞれ適した場面が異なります。

MCPは、エージェントがClaudeのようなアシスタントやAI対応のエディタである場合。サーバーが名前付きのツールを公開し、アシスタントがどれを呼ぶかを選びます。手間が最も少なく、会話的に作業する人にとって正しい選択です。

APIキーは、自分でエージェントを書いて無人で動かす場合。直接の呼び出し、自前の制御フロー、自前のエラー処理です。

OAuthは、エージェントが自分自身ではなく他人のアカウントに代わって動作する場合。各ユーザーは認証情報を貼り付けるのではなく、認可を与えます。

BulkPublishが提供するもの

• MCPサーバー：@bulkpublish/mcp-server
• **API：**投稿、スケジュール、メディア、チャンネル、ラベル、分析、RSSフィード、クォータをカバーする59のドキュメント化されたエンドポイント
• **認証：**APIキー（Bearer bp_...）、または細かいスコープを持つOAuth 2.1
• **プラットフォーム：**15
• **バリデーション：**文字数制限とプラットフォームごとのメディアルールは、公開時ではなく投稿の作成時にチェックされる

投稿は下書きとして作成できます。これは最初に選ぶべき設定であり、ほとんどの用途ではそのまま使い続けるべき設定です。

OAuthのスコープは細かく分かれており（posts:read、posts:write、media:read、media:write、analytics:read、channels:read、full）、下書きの作成しか必要としないエージェントに削除の権限が与えられることはありません。

まとめ

エージェントには、本物の下書き状態、公開時ではなく作成時のバリデーション、失っても他に影響しないスコープ付きの認証情報、そしてループを止めるクォータが必要です。仕事をこなせる範囲で最も狭いスコープを与え、事実を生成させることは決してせず、強い理由がない限り生成と公開の間に人間を置いてください。