名称: googlephotos-automation 描述: “通过Rube MCP (Composio)自动化Google Photos任务:上传媒体、管理专辑、搜索照片、批量添加项目、创建和更新专辑。始终首先搜索工具以获取当前模式。” 需要: mcp: [rube]
通过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: 在客户端配置中将https://rube.app/mcp添加为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: 要上传的文件的URLs
- media_files: 混合输入(文件和URLs)
- 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创建专辑,然后使用专辑ID调用GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS一步上传和组织照片。 - 列出然后组织: 使用
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS或GOOGLEPHOTOS_LIST_MEDIA_ITEMS查找媒体项目ID,然后使用GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS将它们添加到专辑。 - 更新专辑元数据: 使用
GOOGLEPHOTOS_UPDATE_ALBUM更改专辑的标题或封面照片。 - 获取专辑详情: 使用专辑ID调用
GOOGLEPHOTOS_GET_ALBUM检索完整的专辑信息。 - 添加丰富内容: 使用
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 提供支持