ComposioHQ/Uploadcare-Automation

Automação 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 por meio 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 via chave de API pelo 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 em seu projeto Uploadcare com filtros, ordenação e paginação.

Ferramenta: UPLOADCARE_LIST_FILES

Parâmetros principais:

• stored -- filtra por status de armazenamento: "true" para armazenados, "false" para não armazenados
• removed -- filtra por status de remoção: "true" para removidos, "false" para ativos
• ordering -- ordena 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 ISO 8601 para filtrar arquivos enviados após esta data
• to_date -- timestamp 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 mais recentemente enviados 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 exclusão automática.

Exemplo de prompt:

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

---

3. Obter Metadados de um Arquivo

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

Ferramenta: UPLOADCARE_GET_FILE_INFO

Parâmetros principais:

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

Retorna: nome do arquivo, tamanho, tipo MIME, URL 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 do arquivo 3e0923f2-e05a-4b37-9f0d-343b981c9d70"

---

4. Obter uma URL de Download Temporária

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

Ferramenta: UPLOADCARE_GET_FILE_DOWNLOAD_URL

Parâmetros principais:

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

Retorna uma URL com tempo limitado que pode ser usada para download direto do arquivo.

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 em 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 -- ordena 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: Os arquivos são enviados via API de upload do Uploadcare ou widget (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, 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

Armadilha	Detalhes
Exclusão automática de arquivos não armazenados	Arquivos enviados são temporários por padrão e excluídos após 24 horas -- sempre chame UPLOADCARE_STORE_FILE para persistir
Formato estrito de UUID	Os UUIDs dos arquivos devem estar no formato hexadecimal exato 8-4-4-4-12 (ex.: 3e55317b-23d1-4f35-9b4c-b9accb7b53f4); formatos inválidos serão rejeitados
Valores de filtro são strings	Os parâmetros stored e removed aceitam valores string "true" ou "false", não booleanos
URLs de download temporárias	URLs de UPLOADCARE_GET_FILE_DOWNLOAD_URL têm tempo limitado e expirarão
Paginação baseada em deslocamento	Use offset + limit para paginação; não há tokens de paginação baseados em cursor
Nenhuma ferramenta de upload	Uploads de arquivos acontecem através da API de upload do Uploadcare ou widget, não por este toolkit -- estas ferramentas gerenciam arquivos já enviados

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Principais
Listar arquivos	UPLOADCARE_LIST_FILES	stored, ordering, limit, offset
Armazenar arquivo	UPLOADCARE_STORE_FILE	uuid
Obter info do arquivo	UPLOADCARE_GET_FILE_INFO	uuid
Obter URL de download	UPLOADCARE_GET_FILE_DOWNLOAD_URL	file_id
Listar grupos	UPLOADCARE_LIST_GROUPS	limit, offset, ordering

---

Desenvolvido por Composio