ComposioHQ/googlephotos-automation

Automação do Google Photos via Rube MCP

Envie fotos, gerencie álbuns, pesquise itens de mídia e organize conteúdo em lote no Google Photos usando o Rube MCP (Composio).

Documentação do toolkit: composio.dev/toolkits/googlephotos

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit googlephotos
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Não são necessárias chaves de API — basta adicionar o endpoint e ele funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit googlephotos
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme que o status da conexão mostra ATIVA antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Listar Álbuns

Use GOOGLEPHOTOS_LIST_ALBUMS para recuperar todos os álbuns visíveis na aba Álbuns do usuário.

Ferramenta: GOOGLEPHOTOS_LIST_ALBUMS
Parâmetros:
  - pageSize: Número de álbuns por página
  - pageToken: Token de paginação
  - excludeNonAppCreatedData: Mostrar apenas álbuns criados por este aplicativo

2. Criar um Novo Álbum

Use GOOGLEPHOTOS_CREATE_ALBUM para criar um novo álbum no Google Photos.

Ferramenta: GOOGLEPHOTOS_CREATE_ALBUM
Parâmetros:
  - title (obrigatório): Título do álbum

3. Enviar Mídia

Use GOOGLEPHOTOS_UPLOAD_MEDIA para enviar um arquivo de imagem ou vídeo para o Google Photos.

Ferramenta: GOOGLEPHOTOS_UPLOAD_MEDIA
Parâmetros:
  - file_to_upload: Caminho do arquivo local para upload
  - url: URL do arquivo para upload (alternativa ao file_to_upload)
  - file_name: Nome do arquivo enviado
  - description: Descrição/legenda para o item de mídia

4. Upload em Lote e Criação de Itens de Mídia

Use GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS para enviar vários arquivos e criar itens de mídia em uma única operação.

Ferramenta: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS
Parâmetros:
  - files: Caminhos de arquivos locais para upload
  - urls: URLs de arquivos para upload
  - media_files: Entrada mista (arquivos e URLs)
  - albumId: Álbum para adicionar os itens
  - albumPosition: Posição dentro do álbum

5. Pesquisar Itens de Mídia

Use GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS para pesquisar na biblioteca de fotos do usuário com filtros.

Ferramenta: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS
Parâmetros:
  - albumId: Filtrar por álbum
  - filters: Filtros de pesquisa (intervalos de datas, categorias de conteúdo, tipos de mídia)
  - orderBy: Ordem de classificação
  - pageSize: Resultados por página
  - pageToken: Token de paginação

6. Adicionar Itens a um Álbum

Use GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS para adicionar itens de mídia existentes a um álbum.

Ferramenta: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
Parâmetros:
  - albumId (obrigatório): ID do álbum de destino
  - mediaItemIds (obrigatório): Array de IDs dos itens de mídia a serem adicionados

Padrões Comuns

• Criar álbum e depois enviar: Use GOOGLEPHOTOS_CREATE_ALBUM para criar um álbum, depois GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS com o ID do álbum para enviar e organizar fotos em uma única etapa.
• Listar e depois organizar: Use GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS ou GOOGLEPHOTOS_LIST_MEDIA_ITEMS para encontrar IDs de itens de mídia, depois GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS para adicioná-los a álbuns.
• Atualizar metadados do álbum: Use GOOGLEPHOTOS_UPDATE_ALBUM para alterar o título ou a foto de capa de um álbum.
• Obter detalhes do álbum: Use GOOGLEPHOTOS_GET_ALBUM com um ID de álbum para recuperar informações completas do álbum.
• Adicionar enriquecimentos: Use GOOGLEPHOTOS_ADD_ENRICHMENT para adicionar sobreposições de texto, locais ou enriquecimentos de mapa a posições do álbum.
• Upload a partir de URLs: Use o parâmetro url em GOOGLEPHOTOS_UPLOAD_MEDIA ou urls em GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS para enviar imagens diretamente de URLs da web.

Armadilhas Conhecidas

• GOOGLEPHOTOS_LIST_MEDIA_ITEMS está obsoleto — prefira GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS para listar e filtrar mídia.
• GOOGLEPHOTOS_UPLOAD_MEDIA suporta imagens de até 200MB e vídeos até um limite maior. Exceder esses valores resultará em falha.
• Os IDs de álbuns devem ser obtidos das respostas de GOOGLEPHOTOS_LIST_ALBUMS ou GOOGLEPHOTOS_CREATE_ALBUM — são strings opacas.
• GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS só pode adicionar itens a álbuns criados pelo aplicativo ou álbuns que o usuário possui.
• O parâmetro filters em GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS utiliza uma estrutura específica da API do Google Photos — consulte o esquema para formatos de intervalos de datas e categorias de conteúdo.
• Itens de mídia criados via API podem não aparecer imediatamente na interface web do Google Photos devido a atrasos de processamento.

Referência Rápida

Ação	Ferramenta	Parâmetros Principais
Listar álbuns	GOOGLEPHOTOS_LIST_ALBUMS	pageSize, pageToken
Criar álbum	GOOGLEPHOTOS_CREATE_ALBUM	title
Obter álbum	GOOGLEPHOTOS_GET_ALBUM	albumId
Atualizar álbum	GOOGLEPHOTOS_UPDATE_ALBUM	albumId, title, coverPhotoMediaItemId
Enviar mídia	GOOGLEPHOTOS_UPLOAD_MEDIA	file_to_upload ou url, description
Upload em lote	GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS	files ou urls, albumId
Pesquisar mídia	GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS	albumId, filters, pageSize
Listar itens de mídia	GOOGLEPHOTOS_LIST_MEDIA_ITEMS	pageSize, pageToken
Adicionar itens ao álbum	GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS	albumId, mediaItemIds
Adicionar enriquecimento	GOOGLEPHOTOS_ADD_ENRICHMENT	albumId, newEnrichmentItem, albumPosition

---

Desenvolvido por Composio