Facebookオートメーション は何をしますか?
Facebookページの操作を自動化します。投稿の作成・スケジュール設定、動画のアップロード、Messenger会話の管理、ページインサイトの取得、スケジュールされたコンテンツの処理など、すべてComposio MCP統合を通じて行います。
ツールキットドキュメント: composio.dev/toolkits/facebook
セットアップ
- Composio MCPサーバー (
https://rube.app/mcp) でFacebookアカウントを接続します - アクティブな接続がない場合、エージェントは認証リンクを表示します
- 接続が完了すると、すべての
FACEBOOK_*ツールが実行可能になります - 注意: このツールキットはFacebook個人アカウントではなく、Facebookページのみをサポートします
コアワークフロー
1. 管理ページの検出
管理しているすべてのFacebookページを一覧表示し、後続の操作に必要なページIDとアクセストークンを取得します。
ツール: FACEBOOK_LIST_MANAGED_PAGES
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
fields | string | いいえ | カンマ区切りのフィールド(デフォルト: id,name,access_token,category,tasks,about,link,picture) |
limit | integer | いいえ | 1リクエストあたりの最大ページ数(デフォルト: 25) |
user_id | string | いいえ | ユーザーID(デフォルト: me) |
常に最初にこれを実行して page_id 値をキャッシュします。検出呼び出しの繰り返しは避けてください。結果をキャッシュしてください。
2. 投稿の作成とスケジュール設定
Facebookページにオプションのリンク付きテキスト投稿を公開またはスケジュールします。
ツール: FACEBOOK_CREATE_POST
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
page_id | string | はい | 管理ページから取得した数値のページID |
message | string | はい | 投稿のテキスト内容 |
published | boolean | いいえ | true で即時公開、false で下書き/スケジュール(デフォルト: true) |
scheduled_publish_time | integer | いいえ | Unix UTCタイムスタンプ。少なくとも10分以上未来である必要があります |
link | string | いいえ | 投稿に含めるURL |
targeting | object | いいえ | オーディエンスターゲティングの仕様 |
スケジュール設定時: published=false を設定し、scheduled_publish_time にUnix UTCタイムスタンプを指定します。
3. 動画投稿の作成とスケジュール設定
Facebookページに動画コンテンツをアップロードしてスケジュールします。
ツール: FACEBOOK_CREATE_VIDEO_POST
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
page_id | string | はい | 数値のページID |
file_url | string | 条件付き | 動画ファイルのURL(file_url または video のいずれかを指定) |
video | object | 条件付き | name、mimetype、s3key を含むローカルファイルアップロード |
title | string | いいえ | 動画のタイトル |
description | string | いいえ | 動画の説明 |
published | boolean | いいえ | 即時公開するかどうか(デフォルト: true) |
scheduled_publish_time | integer | いいえ | スケジュール公開のUnixタイムスタンプ |
4. スケジュール済み投稿の管理
スケジュールされたコンテンツの確認、再スケジュール、更新、公開を行います。
ツール:
FACEBOOK_GET_SCHEDULED_POSTS-- ページのスケジュール済み/未公開投稿を一覧表示page_id(必須)、fields、limit(最大100)
FACEBOOK_RESCHEDULE_POST-- スケジュールされた公開時刻を変更FACEBOOK_UPDATE_POST-- 既存の投稿のキャプション/テキストを編集FACEBOOK_PUBLISH_SCHEDULED_POST-- スケジュールされた投稿を即時公開
5. ページMessenger会話の読み取り
ユーザーとページ間の受信トレイ会話とメッセージスレッドを取得します。
ツール: FACEBOOK_GET_PAGE_CONVERSATIONS
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
page_id | string | はい | FacebookページID |
fields | string | いいえ | 返すフィールド(デフォルト: participants,updated_time,id) |
limit | integer | いいえ | 返す会話数、最大25 |
その後、完全なメッセージスレッドを取得します:
ツール: FACEBOOK_GET_CONVERSATION_MESSAGES
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
page_id | string | はい | 会話を所有するページID |
conversation_id | string | はい | t_ 形式の会話ID(例: t_3638640842939952) |
fields | string | いいえ | デフォルト: id,created_time,from,to,message |
limit | integer | いいえ | 返すメッセージ数、最大25 |
6. メッセージの送信と既読マーク
Messengerでユーザーに返信し、メッセージを既読としてマークします。
ツール:
FACEBOOK_SEND_MESSAGE-- ページからユーザーにMessenger経由でテキストメッセージを送信FACEBOOK_MARK_MESSAGE_SEEN-- ユーザーのメッセージをページが既読としてマーク
警告: 両方のツールはユーザーに表示される副作用を引き起こします。明示的な確認後にのみ呼び出してください。
既知の落とし穴
| 落とし穴 | 詳細 |
|---|---|
| 現在時刻に近すぎるスケジュール | FACEBOOK_CREATE_POST で scheduled_publish_time が約10分未満の未来の場合、HTTP 400が返されます。一括実行では十分なバッファを確保してください |
| Unix UTCタイムスタンプが必要 | scheduled_publish_time はUnix UTCでなければなりません。タイムゾーンの変換ミスにより、時間がずれたり検証に失敗したりします |
| カーソルベースのページネーション | FACEBOOK_GET_SCHEDULED_POSTS と FACEBOOK_GET_PAGE_CONVERSATIONS は部分データを返します。ページネーションカーソルに従って完全なデータを取得してください |
| 大きな会話ペイロード | 会話に埋め込まれたメッセージを要求すると巨大なペイロードになります。代わりに FACEBOOK_GET_CONVERSATION_MESSAGES を使用して完全なスレッドを取得してください |
| 動画処理の遅延 | アップロードされた動画は処理中の状態が続く可能性があります。アップロードが使用可能になった後にのみ FACEBOOK_CREATE_VIDEO_POST でスケジュールしてください |
| ページIDのキャッシュ | FACEBOOK_LIST_MANAGED_PAGES の呼び出しを繰り返すとレイテンシが増加します。ワークスペース/実行ごとに page_id をキャッシュしてください |
| ページのみ | このツールキットは個人のFacebookアカウントをサポートしません。Facebookページのみサポートします |
| 書き込み操作には確認が必要 | FACEBOOK_SEND_MESSAGE と FACEBOOK_MARK_MESSAGE_SEEN はユーザーに表示される副作用を引き起こします。明示的なユーザー確認後にのみ呼び出してください |
クイックリファレンス
| ツールスラッグ | 目的 |
|---|---|
FACEBOOK_LIST_MANAGED_PAGES | アクセストークン付きの管理ページを一覧表示 |
FACEBOOK_GET_PAGE_DETAILS | 特定のページの詳細情報を取得 |
FACEBOOK_CREATE_POST | テキスト/リンク投稿を作成またはスケジュール |
FACEBOOK_CREATE_VIDEO_POST | 動画投稿を作成またはスケジュール |
FACEBOOK_GET_SCHEDULED_POSTS | スケジュール済み/未公開投稿を一覧表示 |
FACEBOOK_RESCHEDULE_POST | スケジュールされた公開時刻を変更 |
FACEBOOK_UPDATE_POST | 既存の投稿を編集 |
FACEBOOK_PUBLISH_SCHEDULED_POST | スケジュールされた投稿を即時公開 |
FACEBOOK_UPLOAD_VIDEO | 動画ファイルをページにアップロード |
FACEBOOK_GET_PAGE_CONVERSATIONS | Messenger受信トレイの会話を一覧表示 |
FACEBOOK_GET_CONVERSATION_MESSAGES | 会話からメッセージを取得 |
FACEBOOK_SEND_MESSAGE | ページからMessengerメッセージを送信 |
FACEBOOK_MARK_MESSAGE_SEEN | メッセージを既読としてマーク |
FACEBOOK_GET_PAGE_POSTS | ページフィードから投稿を取得 |
FACEBOOK_GET_USER_PAGES | タスクとトークン付きのページを一覧表示 |
Powered by Composio