MewCP Apify MCP

Retorna um objeto de status confirmando que o servidor está em execução e acessível.

Entradas: (nenhuma)

Saída:

{
  "status": "ok",
  "server": "CL Apify MCP Server"
}

Retorna uma lista paginada de Actors na sua conta Apify, incluindo ID, nome e nome de usuário.

Entradas:

- `my_only` (boolean, optional) — Only return Actors owned by you (default: true)
- `limit`   (integer, optional) — Maximum number of Actors to return, 1–1000 (default: 100)
- `offset`  (integer, optional) — Number of Actors to skip for pagination (default: 0)

Saída:

{
  "success": true,
  "total": 12,
  "count": 12,
  "actors": [
    { "id": "abc123", "name": "web-scraper", "username": "myuser" }
  ]
}

Inicia uma execução de Actor com a entrada fornecida e restrições opcionais de recursos. Retorna o ID da execução e o ID do conjunto de dados padrão para consultar resultados.

Entradas:

- `actor_id`      (string, required)  — Actor ID to run (e.g. 'username~actor-name' or Actor ID)
- `input_data`    (string, optional)  — JSON string of input data for the Actor (default: '{}')
- `timeout_secs`  (integer, optional) — Run timeout in seconds
- `memory_mbytes` (integer, optional) — Memory limit in MB (min 128)
- `build`         (string, optional)  — Build tag or number (default: 'latest')

Saída:

{
  "success": true,
  "run_id": "run_XXXXXXXXXX",
  "status": "RUNNING",
  "started_at": "2024-01-01T00:00:00.000Z",
  "default_dataset_id": "dataset_XXXXXXXXXX",
  "default_key_value_store_id": "kvs_XXXXXXXXXX"
}

Recupera o status e os metadados de uma execução específica de Actor. Opcionalmente, aguarda até 60 segundos para a execução terminar.

Entradas:

- `run_id`          (string, required)  — Actor run ID
- `wait_for_finish` (integer, optional) — Seconds to wait for run completion, 0–60 (default: 0)

Saída:

{
  "success": true,
  "run_id": "run_XXXXXXXXXX",
  "actor_id": "abc123",
  "status": "SUCCEEDED",
  "started_at": "2024-01-01T00:00:00.000Z",
  "finished_at": "2024-01-01T00:01:30.000Z",
  "default_dataset_id": "dataset_XXXXXXXXXX",
  "usage_total_usd": 0.012
}

Retorna uma lista paginada de execuções de Actors da sua conta, ordenadas das mais recentes para as mais antigas. Opcionalmente, filtre por status da execução.

Entradas:

- `status` (string, optional)  — Filter by status: 'SUCCEEDED', 'FAILED', 'RUNNING', 'ABORTED', etc.
- `limit`  (integer, optional) — Maximum number of runs to return, 1–1000 (default: 100)
- `offset` (integer, optional) — Number of runs to skip for pagination (default: 0)

Saída:

{
  "success": true,
  "total": 42,
  "count": 10,
  "runs": [
    {
      "id": "run_XXXXXXXXXX",
      "actor_id": "abc123",
      "status": "SUCCEEDED",
      "started_at": "2024-01-01T00:00:00.000Z",
      "finished_at": "2024-01-01T00:01:30.000Z"
    }
  ]
}

Busca itens extraídos do conjunto de dados padrão de uma execução de Actor. Esta é a principal forma de ler a saída do Actor após a conclusão de uma execução.

Entradas:

- `dataset_id` (string, required)  — Dataset ID (returned in the Actor run response)
- `limit`      (integer, optional) — Maximum number of items to return, 1–10000 (default: 100)
- `offset`     (integer, optional) — Number of items to skip for pagination (default: 0)
- `clean`      (boolean, optional) — Remove hidden fields starting with '#' (default: true)

Saída:

{
  "success": true,
  "count": 25,
  "items": [
    { "url": "https://example.com", "title": "Example Page", "price": 29.99 }
  ]
}

Retorna uma lista paginada de tarefas de Actors na sua conta. Tarefas são execuções de Actors pré-configuradas com entradas salvas.

Entradas:

- `limit`  (integer, optional) — Maximum number of tasks to return, 1–1000 (default: 100)
- `offset` (integer, optional) — Number of tasks to skip for pagination (default: 0)

Saída:

{
  "success": true,
  "total": 5,
  "count": 5,
  "tasks": [
    {
      "id": "task_XXXXXXXXXX",
      "name": "my-scraper-task",
      "actor_id": "abc123",
      "username": "myuser",
      "created_at": "2024-01-01T00:00:00.000Z"
    }
  ]
}

• limit — Número máximo de registros a retornar por solicitação (máximo varia conforme o endpoint)
• offset — Número de registros a pular; use com limit para paginação
• desc — Ordem de classificação; endpoints de listagem retornam resultados do mais recente para o mais antigo por padrão

Actors:

{username}~{actor-name}  or  {actorId}
Example: apify~web-scraper  or  BwFbCCmwYxNqHr7TB

Execuções:

{runId}
Example: HG7ML7M8z78YcAPEB

Conjuntos de dados:

{datasetId}
Example: rHuMdwm6xCFt6WiEz

Tarefas:

{taskId}
Example: KoJgnDhzbtGnuH5md

• READY — Na fila e aguardando para iniciar
• RUNNING — Executando atualmente
• SUCCEEDED — Concluído com sucesso
• FAILED — Encerrado com erro
• ABORTING — Cancelamento em andamento
• ABORTED — Interrompido pelo usuário ou por tempo limite
• TIMED-OUT — Excedeu o limite de tempo

1. Acesse o Apify Console
2. Clique no avatar do seu perfil → Configurações → Integrações
3. Em Tokens de API, clique em + Adicionar novo token
4. Dê um nome ao token e clique em Criar — copie o valor do token imediatamente, ele é exibido apenas uma vez

Tokens de API pessoais têm as mesmas permissões da sua conta. Para integrações de produção, crie um token com escopo restrito e com as permissões mínimas necessárias.

• Causa: Token da API não fornecido nos cabeçalhos da solicitação ou formato incorreto
• Solução:
  1. Verifique se os cabeçalhos Authorization: Bearer YOUR_API_KEY e X-Mewcp-Credential-Id: CREDENTIAL-ID estão presentes
  2. Verifique se o token da API está ativo na sua conta MewCP

• Causa: As chamadas de API excederam seus limites de solicitação
• Solução:
  1. Verifique o uso de créditos no seu painel Curious Layer
  2. Faça upgrade para um plano pago ou adicione créditos para limites maiores
  3. Entre em contato com o suporte para ajustes de créditos

• Causa: Nenhuma credencial Apify vinculada à sua conta
• Solução:
  1. Acesse Credenciais no seu painel MewCP
  2. Adicione seu token da API Apify
  3. Tente novamente a solicitação com o cabeçalho X-Mewcp-Credential-Id correto

• Causa: O payload JSON é inválido ou está faltando campos obrigatórios
• Solução:
  1. Valide a sintaxe JSON antes de enviar
  2. Certifique-se de que todos os parâmetros obrigatórios da ferramenta estejam incluídos
  3. Ao usar apify_run_actor, passe input_data como uma string JSON, não como um objeto

• Causa: Nome incorreto do servidor no endpoint da API
• Solução:
  1. Verifique o formato do endpoint: {server-name}/mcp/{tool-name}
  2. Use o nome correto do servidor conforme a documentação
  3. Verifique os servidores disponíveis na sua conta Curious Layer

• Causa: A API Apify upstream retornou um erro
• Solução:
  1. Verifique o status do serviço Apify na Página de Status da Apify
  2. Verifique se seu token da API tem as permissões necessárias para a operação
  3. Revise a mensagem de erro para obter detalhes específicos (por exemplo, Actor não encontrado, unidades de computação insuficientes)

• Documentação da API Apify — Referência oficial da API
• Apify Console — Gerencie Actors, execuções e conjuntos de dados
• Docs do FastMCP — Especificação do FastMCP
• Credenciais do FastMCP — Pacote de Credenciais do FastMCP para gerenciamento de credenciais