Automação com Uploadcare

Automatize fluxos de trabalho de manipulação de arquivos do Uploadcare -- liste arquivos do projeto, armazene uploads permanentemente, recupere metadados de arquivos, obtenha URLs de download e gerencie grupos de arquivos -- tudo através de linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/uploadcare

Configuração

1. Adicione o servidor Rube MCP ao seu ambiente: https://rube.app/mcp
2. Conecte sua conta Uploadcare quando solicitado (autenticação por chave de API via Composio)
3. Comece a emitir comandos em linguagem natural para automação do Uploadcare

Fluxos de Trabalho Principais

1. Listar Arquivos do Projeto

Navegue pelos arquivos enviados no seu projeto Uploadcare com filtragem, ordenação e paginação.

Ferramenta: UPLOADCARE_LIST_FILES

Parâmetros principais:

• stored -- filtre por status de armazenamento: "true" para armazenados, "false" para não armazenados
• removed -- filtre por status de remoção: "true" para removidos, "false" para ativos
• ordering -- ordene por datetime_uploaded (crescente) ou -datetime_uploaded (decrescente)
• limit -- arquivos por página, 1-1000 (padrão 100)
• offset -- deslocamento de paginação baseado em zero
• from_date -- timestamp no formato ISO 8601 para filtrar arquivos enviados após esta data
• to_date -- timestamp no formato ISO 8601 para filtrar arquivos enviados antes desta data
• include -- defina como "total" para incluir a contagem total de arquivos na resposta

Exemplo de prompt:

"Liste os 50 arquivos armazenados enviados mais recentemente no meu projeto Uploadcare"

2. Armazenar um Arquivo Permanentemente

Marque um arquivo enviado como armazenado permanentemente. Por padrão, os arquivos do Uploadcare são temporários e serão excluídos após 24 horas, a menos que sejam armazenados.

Ferramenta: UPLOADCARE_STORE_FILE

Parâmetros principais:

• uuid -- UUID do arquivo a ser armazenado (obrigatório); deve estar no formato hexadecimal 8-4-4-4-12 (ex: 3e55317b-23d1-4f35-9b4c-b9accb7b53f4)

Sempre armazene arquivos após o upload para evitar a exclusão automática.

Exemplo de prompt:

"Armazene permanentemente o arquivo com UUID 3e55317b-23d1-4f35-9b4c-b9accb7b53f4"

3. Obter Metadados de Arquivo

Recupere informações detalhadas sobre um arquivo específico, incluindo tamanho, tipo MIME, URL do CDN, dimensões da imagem e muito mais.

Ferramenta: UPLOADCARE_GET_FILE_INFO

Parâmetros principais:

• uuid -- o UUID do arquivo a ser inspecionado (obrigatório); formato: hexadecimal 8-4-4-4-12

Retorna: nome do arquivo, tamanho, tipo MIME, URL do CDN, data de upload, status de armazenamento, informações da imagem (dimensões, modo de cor) e mais.

Exemplo de prompt:

"Obtenha os metadados e dimensões para o arquivo 3e0923f2-e05a-4b37-9f0d-343b981c9d70"

4. Obter um URL de Download Temporário

Recupere um link de download direto temporário para um arquivo específico.

Ferramenta: UPLOADCARE_GET_FILE_DOWNLOAD_URL

Parâmetros principais:

• file_id -- o identificador único do arquivo (obrigatório)

Retorna um URL com tempo limitado que pode ser usado para download direto de arquivos.

Exemplo de prompt:

"Obtenha um link de download para o arquivo 3e0923f2-e05a-4b37-9f0d-343b981c9d70"

5. Navegar por Grupos de Arquivos

Liste grupos de arquivos no seu projeto. Grupos são coleções de arquivos enviados juntos.

Ferramenta: UPLOADCARE_LIST_GROUPS

Parâmetros principais:

• limit -- grupos por página, 1-1000 (padrão 20)
• offset -- deslocamento de paginação baseado em zero (padrão 0)
• ordering -- ordene por datetime_created (crescente) ou -datetime_created (decrescente)

Exemplo de prompt:

"Liste meus 10 grupos de arquivos mais recentes"

6. Fluxo de Trabalho do Ciclo de Vida do Arquivo

Combine ferramentas para gerenciamento de arquivos de ponta a ponta:

1. Upload: Arquivos são enviados via API de upload ou widget do Uploadcare (fora deste toolkit)
2. Armazenar: UPLOADCARE_STORE_FILE -- marque arquivos como permanentes para evitar exclusão automática
3. Inspecionar: UPLOADCARE_GET_FILE_INFO -- verifique metadados, confira dimensões e tipo MIME
4. Compartilhar: UPLOADCARE_GET_FILE_DOWNLOAD_URL -- gere um link de download temporário
5. Navegar: UPLOADCARE_LIST_FILES -- audite todos os arquivos com filtros de status e data
6. Grupos: UPLOADCARE_LIST_GROUPS -- revise uploads em lote

Exemplo de prompt:

"Armazene o arquivo abc-123, depois obtenha seus metadados e um link de download"

Armadilhas Conhecidas

…