Rube MCP による Google Photos 自動化
Rube MCP（Composio）を使って、Google Photos での写真のアップロード、アルバム管理、メディアアイテムの検索、コンテンツの一括整理を実現します。
Toolkit ドキュメント: composio.dev/toolkits/googlephotos
前提条件
- Rube MCP が接続されていること（
RUBE_SEARCH_TOOLSが利用可能） - ツールキット
googlephotosを使用してRUBE_MANAGE_CONNECTIONS経由でアクティブな接続が確立されていること - 常に最初に
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 を使用して、ユーザーのアルバムタブに表示されているすべてのアルバムを取得します。
Tool: GOOGLEPHOTOS_LIST_ALBUMS
Parameters:
- pageSize: 1ページあたりのアルバム数
- pageToken: ページネーショントークン
- excludeNonAppCreatedData: このアプリで作成されたアルバムのみを表示
2. 新しいアルバムの作成
GOOGLEPHOTOS_CREATE_ALBUM を使用して、Google Photos に新しいアルバムを作成します。
Tool: GOOGLEPHOTOS_CREATE_ALBUM
Parameters:
- title (必須): アルバムタイトル
3. メディアのアップロード
GOOGLEPHOTOS_UPLOAD_MEDIA を使用して、画像または動画ファイルを Google Photos にアップロードします。
Tool: GOOGLEPHOTOS_UPLOAD_MEDIA
Parameters:
- file_to_upload: アップロードするローカルファイルパス
- url: アップロードするファイルの URL（file_to_upload の代替）
- file_name: アップロードするファイルの名前
- description: メディアアイテムの説明/キャプション
4. 一括アップロードとメディアアイテムの作成
GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS を使用して、複数ファイルのアップロードとメディアアイテムの作成を一括で行います。
Tool: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS
Parameters:
- files: アップロードするローカルファイルパス
- urls: アップロードするファイルの URL
- media_files: 混合入力（ファイルと URL）
- albumId: アイテムを追加するアルバム
- albumPosition: アルバム内の位置
5. メディアアイテムの検索
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS を使用して、フィルターを指定してユーザーの写真ライブラリを検索します。
Tool: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS
Parameters:
- albumId: アルバムでフィルター
- filters: 検索フィルター（日付範囲、コンテンツカテゴリ、メディアタイプ）
- orderBy: 並び順
- pageSize: 1ページあたりの結果数
- pageToken: ページネーショントークン
6. アルバムへのアイテム追加
GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS を使用して、既存のメディアアイテムをアルバムに追加します。
Tool: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
Parameters:
- albumId (必須): 対象のアルバム ID
- mediaItemIds (必須): 追加するメディアアイテム ID の配列
よくあるパターン
- アルバムを作成してからアップロード:
GOOGLEPHOTOS_CREATE_ALBUMでアルバムを作成し、そのアルバム ID を指定してGOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMSで一度にアップロード＆整理します。 - 一覧取得して整理:
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パラメータを使って、Web 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 Web 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 |
Powered by Composio