Rube MCP를 통한 Google Photos 자동화
Rube MCP (Composio)를 사용하여 Google Photos에서 사진 업로드, 앨범 관리, 미디어 항목 검색, 콘텐츠 일괄 정리를 수행합니다.
툴킷 문서: composio.dev/toolkits/googlephotos
사전 요구 사항
- Rube MCP가 연결되어 있어야 합니다 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해googlephotos툴킷과의 활성 연결 필요- 항상
RUBE_SEARCH_TOOLS를 먼저 호출하여 현재 도구 스키마를 확인하세요
설정
Rube MCP 가져오기: 클라이언트 설정에 MCP 서버로 https://rube.app/mcp를 추가하세요. API 키는 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다.googlephotos툴킷을 사용하여RUBE_MANAGE_CONNECTIONS를 호출합니다.- 연결이 ACTIVE 상태가 아니라면 반환된 인증 링크를 따라 설정을 완료합니다.
- 워크플로우를 실행하기 전에 연결 상태가 ACTIVE인지 확인합니다.
핵심 워크플로우
1. 앨범 목록 보기
GOOGLEPHOTOS_LIST_ALBUMS를 사용하여 사용자의 앨범 탭에 표시된 모든 앨범을 검색합니다.
도구: GOOGLEPHOTOS_LIST_ALBUMS
매개변수:
- pageSize: 페이지당 앨범 수
- pageToken: 페이지네이션 토큰
- excludeNonAppCreatedData: 이 앱에서 생성한 앨범만 표시
2. 새 앨범 만들기
GOOGLEPHOTOS_CREATE_ALBUM을 사용하여 Google Photos에 새 앨범을 만듭니다.
도구: GOOGLEPHOTOS_CREATE_ALBUM
매개변수:
- title (필수): 앨범 제목
3. 미디어 업로드
GOOGLEPHOTOS_UPLOAD_MEDIA를 사용하여 이미지나 비디오 파일을 Google Photos에 업로드합니다.
도구: GOOGLEPHOTOS_UPLOAD_MEDIA
매개변수:
- file_to_upload: 업로드할 로컬 파일 경로
- url: 업로드할 파일의 URL (file_to_upload 대안)
- file_name: 업로드된 파일의 이름
- description: 미디어 항목에 대한 설명/캡션
4. 일괄 업로드 및 미디어 항목 생성
GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS를 사용하여 여러 파일을 업로드하고 한 번에 미디어 항목을 만듭니다.
도구: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS
매개변수:
- files: 업로드할 로컬 파일 경로
- urls: 업로드할 파일의 URL
- media_files: 혼합 입력 (파일 및 URL)
- albumId: 항목을 추가할 앨범
- albumPosition: 앨범 내 위치
5. 미디어 항목 검색
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS를 사용하여 필터로 사용자의 사진 라이브러리를 검색합니다.
도구: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS
매개변수:
- albumId: 앨범별 필터
- filters: 검색 필터 (날짜 범위, 콘텐츠 카테고리, 미디어 유형)
- orderBy: 정렬 순서
- pageSize: 페이지당 결과 수
- pageToken: 페이지네이션 토큰
6. 앨범에 항목 추가
GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS를 사용하여 기존 미디어 항목을 앨범에 추가합니다.
도구: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
매개변수:
- albumId (필수): 대상 앨범 ID
- mediaItemIds (필수): 추가할 미디어 항목 ID 배열
일반적인 패턴
- 앨범 생성 후 업로드:
GOOGLEPHOTOS_CREATE_ALBUM으로 앨범을 만든 후,GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS에 앨범 ID를 전달하여 사진을 한 번에 업로드하고 정리합니다. - 목록 확인 후 정리:
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS또는GOOGLEPHOTOS_LIST_MEDIA_ITEMS로 미디어 항목 ID를 찾은 후,GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS로 앨범에 추가합니다. - 앨범 메타데이터 업데이트:
GOOGLEPHOTOS_UPDATE_ALBUM을 사용하여 앨범 제목이나 표지 사진을 변경합니다. - 앨범 세부 정보 가져오기:
GOOGLEPHOTOS_GET_ALBUM에 앨범 ID를 전달하여 전체 앨범 정보를 검색합니다. - 보강 추가:
GOOGLEPHOTOS_ADD_ENRICHMENT를 사용하여 앨범 위치에 텍스트 오버레이, 위치 정보 또는 지도 보강을 추가합니다. - URL에서 업로드:
GOOGLEPHOTOS_UPLOAD_MEDIA의url매개변수나GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS의urls매개변수를 사용하여 웹 URL에서 직접 이미지를 업로드합니다.
알려진 문제점
GOOGLEPHOTOS_LIST_MEDIA_ITEMS는 더 이상 사용되지 않습니다 -- 미디어 목록 확인 및 필터링에는GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS를 사용하세요.GOOGLEPHOTOS_UPLOAD_MEDIA는 이미지 최대 200MB, 동영상은 더 큰 용량까지 지원합니다. 이를 초과하면 실패합니다.- 앨범 ID는
GOOGLEPHOTOS_LIST_ALBUMS또는GOOGLEPHOTOS_CREATE_ALBUM응답에서 가져와야 합니다. 이는 불투명 문자열입니다. GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS는 앱이 생성한 앨범이나 사용자가 소유한 앨범에만 항목을 추가할 수 있습니다.GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS의filters매개변수는 특정 Google Photos API 필터 구조를 사용합니다. 날짜 범위 및 콘텐츠 카테고리 형식은 스키마를 참조하세요.- API를 통해 생성된 미디어 항목은 처리 지연으로 인해 Google Photos 웹 UI에 즉시 나타나지 않을 수 있습니다.
빠른 참조
| 작업 | 도구 | 주요 매개변수 |
|---|---|---|
| 앨범 목록 | GOOGLEPHOTOS_LIST_ALBUMS | pageSize, pageToken |
| 앨범 생성 | GOOGLEPHOTOS_CREATE_ALBUM | title |
| 앨범 가져오기 | GOOGLEPHOTOS_GET_ALBUM | albumId |
| 앨범 업데이트 | GOOGLEPHOTOS_UPDATE_ALBUM | albumId, title, coverPhotoMediaItemId |
| 미디어 업로드 | GOOGLEPHOTOS_UPLOAD_MEDIA | file_to_upload 또는 url, description |
| 일괄 업로드 | GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS | files 또는 urls, albumId |
| 미디어 검색 | GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS | albumId, filters, pageSize |
| 미디어 항목 목록 | GOOGLEPHOTOS_LIST_MEDIA_ITEMS | pageSize, pageToken |
| 앨범에 항목 추가 | GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS | albumId, mediaItemIds |
| 보강 추가 | GOOGLEPHOTOS_ADD_ENRICHMENT | albumId, newEnrichmentItem, albumPosition |
Composio 제공