# AIエージェント連携

Claude CodeなどのAIエージェントから、自然言語でポストメッシュ経由のSNS投稿ができます。対応プラットフォームはYouTube・TikTok・Instagram・X・Threads・Facebookです。

## エージェントがポストメッシュを使う場面

- ユーザーが同じ内容を複数のSNSへ投稿したいと言ったとき
- 指定の日時に投稿を予約したいと言ったとき
- 手元の動画・画像・テキストをSNSへ公開したいと言ったとき
- 予約済み・公開済みの投稿の状態を確認したいと言ったとき

対応していない用途: 投稿の分析・インサイト取得、DMやコメントの管理、広告出稿。

## 1回の投稿で配信できるSNS

1回の投稿で配信できるSNSは、投稿の種別ごとに決まっています。1つの投稿で6SNSすべてに配信することはできません。

| 投稿種別 | 配信できるSNS |
|---|---|
| テキスト | X、Threads、Facebook |
| 画像 | X、Instagram、Threads、TikTok、Facebook |
| 動画 | X、Instagram、Threads、TikTok、YouTube |
| ツリー投稿 | X、Threads |

対応していないプラットフォームを投稿先に含めると400 VALIDATION_ERRORになります。


## 3つの接続方法

### 1. MCPサーバー

```
https://post-mesh.com/api/mcp
```

認証は2種類あります。

- OAuth: ChatGPTなどのコネクタ向け。`/oauth/authorize`で同意します。
- APIキー: `Authorization: Bearer <APIキー>` ヘッダーを送ります。

REST APIと同等の6つのツールを提供します。

### 2. Agent Skill

```
npx skills add hid3h/post-mesh-agent-skills
```

スキルの公開リポジトリ: https://github.com/hid3h/post-mesh-agent-skills

インストール後、APIキーを設定すれば自然言語で投稿できます。

### 3. REST API

```
https://post-mesh.com/api/v1/
```

OpenAPI仕様: https://post-mesh.com/openapi.yaml （JSON版: https://post-mesh.com/openapi.json ）

## セットアップ手順

1. https://post-mesh.com でアカウントを作成する
2. 投稿したいSNSアカウントをOAuthで連携する
3. ダッシュボードの「APIキー」画面からAPIキーを発行する
4. 上記のいずれかの方法でエージェントに接続する

APIキーの発行はセルフサービスです。営業への問い合わせや審査はありません。

## 利用できるツール

| 用途 | 説明 |
|---|---|
| アカウント情報の取得 | APIキーに紐づくユーザー情報を返す |
| 連携一覧の取得 | 有効なSNSアカウント連携を返す |
| メディアアップロードURLの生成 | 動画・画像をアップロードするURLを発行する |
| 投稿一覧の取得 | ステータスやプラットフォームでフィルタできる |
| 投稿の作成 | テキスト・画像・動画・ツリー投稿を複数プラットフォームへ投稿・予約する |
| 投稿詳細の取得 | プラットフォームごとのステータスを含む |
| 予約投稿のキャンセル | 予約済みの投稿を取り消す |

ツリー投稿（1回の操作でXの連続ポスト・Threadsのスレッドを作る形式）はREST APIとMCPツールの`category: tree`で作成できます。

## 注意点

- API投稿では一部のネイティブ機能に制約があります。例えばInstagramリールでの音源追加はAPI経由では利用できません。音源やエフェクトが必要な場合は、事前に編集した動画をアップロードしてください。
- 各プラットフォームの公式APIを使って投稿するため、手動投稿と同じ扱いです。API経由の投稿がリーチに不利になるという記載は、各プラットフォームの公式ドキュメントにはありません。

関連: [開発者向け](https://post-mesh.com/developers.md) / [APIリファレンス](https://post-mesh.com/api-reference)