Automação com Apify

Execute Apify Actors de web scraping e gerencie datasets diretamente do Claude Code. Execute crawlers de forma síncrona ou assíncrona, recupere dados estruturados, crie tarefas reutilizáveis e inspecione logs de execução sem sair do seu terminal.

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

Configuração

1. Adicione o servidor Composio MCP à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta Apify quando solicitado. O agente fornecerá um link de autenticação.
3. Navegue pelos Actors disponíveis em apify.com/store. Cada Actor tem seu próprio esquema de entrada único -- sempre verifique a documentação do Actor antes de executar.

Fluxos de Trabalho Principais

1. Executar um Actor Sincronamente e Obter Resultados

Execute um Actor e recupere imediatamente seus itens de dataset em uma única chamada. Ideal para tarefas de scraping rápidas.

Ferramenta: APIFY_RUN_ACTOR_SYNC_GET_DATASET_ITEMS

Parâmetros principais:

• actorId (obrigatório) -- ID do Actor no formato username/actor-name (ex: compass/crawler-google-places)
• input -- Objeto de entrada JSON que corresponde ao esquema do Actor. Cada Actor tem nomes de campo únicos -- verifique apify.com/store para o esquema exato.
• limit -- número máximo de itens a serem retornados
• offset -- pular itens para paginação
• format -- json (padrão), csv, jsonl, html, xlsx, xml
• timeout -- tempo limite de execução em segundos
• waitForFinish -- tempo máximo de espera (0-300 segundos)
• fields -- lista de campos a serem incluídos, separada por vírgulas
• omit -- lista de campos a serem excluídos, separada por vírgulas

Exemplo de prompt: "Execute o scraper de Google Places para 'restaurantes em Nova York' e retorne os primeiros 50 resultados"

2. Executar um Actor Assincronamente

Acione a execução de um Actor sem esperar pela conclusão. Use para tarefas de scraping de longa duração.

Ferramenta: APIFY_RUN_ACTOR

Parâmetros principais:

• actorId (obrigatório) -- Slug ou ID do Actor
• body -- Objeto de entrada JSON para o Actor
• memory -- limite de memória em MB (deve ser potência de 2, mínimo 128)
• timeout -- tempo limite de execução em segundos
• maxItems -- limite de itens retornados
• build -- tag de build específica (ex: latest, beta)

Continue com APIFY_GET_DATASET_ITEMS para recuperar os resultados usando o datasetId da execução.

Exemplo de prompt: "Inicie o Actor de web scraper para example.com assincronamente com 1024MB de memória"

3. Recuperar Itens de Dataset

Busque dados de um dataset específico com paginação, seleção de campos e filtragem.

Ferramenta: APIFY_GET_DATASET_ITEMS

Parâmetros principais:

• datasetId (obrigatório) -- identificador do dataset
• limit (padrão/máximo 1000) -- itens por página
• offset (padrão 0) -- deslocamento de paginação
• format -- json (recomendado), csv, xlsx
• fields -- inclua apenas campos específicos
• omit -- exclua campos específicos
• clean -- remova metadados específicos do Apify
• desc -- ordem reversa (mais recentes primeiro)

Exemplo de prompt: "Obtenha os primeiros 500 itens do dataset myDatasetId no formato JSON"

4. Inspecionar Detalhes do Actor

Visualize metadados, esquema de entrada e configuração do Actor antes de executá-lo.

Ferramenta: APIFY_GET_ACTOR

Parâmetros principais:

• actorId (obrigatório) -- ID do Actor no formato username/actor-name ou ID hexadecimal

Exemplo de prompt: "Mostre-me os detalhes e o esquema de entrada para o Actor apify/web-scraper"

5. Criar Tarefas Reutilizáveis

Configure tarefas de Actor reutilizáveis com entradas pré-definidas para trabalhos de scraping recorrentes.

Ferramenta: APIFY_CREATE_TASK

Configure uma tarefa uma vez, depois acione-a repetidamente com parâmetros de entrada consistentes. Útil para fluxos de trabalho de coleta de dados agendados ou recorrentes.

Exemplo de prompt: "Crie uma tarefa Apify para o scraper do Google Search com a consulta padrão 'startups de IA' e localização EUA"

6. Gerenciar Execuções e Datasets

Liste execuções de Actor, navegue por datasets e inspecione detalhes de execução para monitoramento e depuração.

Ferramentas: APIFY_GET_LIST_OF_RUNS, APIFY_DATASETS_GET, APIFY_DATASET_GET, APIFY_GET_LOG

Para listar execuções:

• Filtre por Actor e opcionalmente por status
• Obtenha datasetId dos detalhes da execução para recuperação de dados

Para gerenciamento de datasets:

• APIFY_DATASETS_GET -- liste todos os seus datasets com paginação
• APIFY_DATASET_GET -- obtenha metadados para um dataset específico

Para depuração:

• APIFY_GET_LOG -- recupere logs de execução para uma execução ou build

Exemplo de prompt: "Liste as últimas 10 execuções para o Actor de web scraper e mostre os logs da mais recente"

Armadilhas Conhecidas

…