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 | 아니요 | 요청당 최대 페이지 수 (기본값: 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-- 사용자의 메시지를 페이지에서 읽음으로 표시
경고: 두 도구 모두 사용자에게 보이는 부작용을 일으킵니다. 명시적 확인 후에만 호출하세요.
알려진 함정
| 함정 | 세부 사항 |
|---|---|
| 너무 가까운 시간에 예약 | scheduled_publish_time이 현재로부터 약 10분 미만이면 FACEBOOK_CREATE_POST가 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 | 작업 및 토큰이 있는 페이지 목록 |
Composio 제공