ComposioHQ/Apify-Automation

Was macht Apify-Automation?

Führen Sie Apify Web-Scraping-Actors aus und verwalten Sie Datasets direkt von Claude Code aus. Starten Sie Crawler synchron oder asynchron, rufen Sie strukturierte Daten ab, erstellen Sie wiederverwendbare Tasks und überprüfen Sie Ausführungslogs, ohne Ihr Terminal zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/apify

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Apify-Konto, wenn Sie dazu aufgefordert werden. Der Agent stellt einen Authentifizierungslink bereit.
3. Durchsuchen Sie verfügbare Actors unter apify.com/store. Jeder Actor hat ein eigenes, einzigartiges Eingabeschema – überprüfen Sie vor der Ausführung immer die Dokumentation des Actors.

---

Kern-Workflows

1. Einen Actor synchron ausführen und Ergebnisse abrufen

Führen Sie einen Actor aus und rufen Sie sofort dessen Dataset-Elemente in einem einzigen Aufruf ab. Optimal für schnelle Scraping-Aufträge.

Tool: APIFY_RUN_ACTOR_SYNC_GET_DATASET_ITEMS

Wichtige Parameter:

• actorId (erforderlich) – Actor-ID im Format benutzername/actor-name (z.B. compass/crawler-google-places)
• input – JSON-Eingabeobjekt, das dem Schema des Actors entspricht. Jeder Actor hat einzigartige Feldnamen – überprüfen Sie apify.com/store für das genaue Schema.
• limit – Maximale Anzahl zurückzugebender Elemente
• offset – Elemente für die Paginierung überspringen
• format – json (Standard), csv, jsonl, html, xlsx, xml
• timeout – Ausführungs-Timeout in Sekunden
• waitForFinish – Maximale Wartezeit (0–300 Sekunden)
• fields – Komma-separierte Liste der einzuschließenden Felder
• omit – Komma-separierte Liste der auszuschließenden Felder

Beispiel-Prompt: "Führe den Google-Places-Scraper für 'Restaurants in New York' aus und gib die ersten 50 Ergebnisse zurück"

---

2. Einen Actor asynchron ausführen

Starten Sie einen Actor, ohne auf dessen Abschluss zu warten. Verwenden Sie dies für länger laufende Scraping-Aufträge.

Tool: APIFY_RUN_ACTOR

Wichtige Parameter:

• actorId (erforderlich) – Actor-Slug oder ID
• body – JSON-Eingabeobjekt für den Actor
• memory – Speicherlimit in MB (muss eine Zweierpotenz sein, mindestens 128)
• timeout – Ausführungs-Timeout in Sekunden
• maxItems – Obergrenze für zurückgegebene Elemente
• build – Spezifischer Build-Tag (z.B. latest, beta)

Anschließend mit APIFY_GET_DATASET_ITEMS die Ergebnisse anhand der datasetId des Runs abrufen.

Beispiel-Prompt: "Starte den Web-Scraper-Actor für example.com asynchron mit 1024 MB Speicher"

---

3. Dataset-Elemente abrufen

Rufen Sie Daten aus einem bestimmten Dataset mit Paginierung, Feldauswahl und Filterung ab.

Tool: APIFY_GET_DATASET_ITEMS

Wichtige Parameter:

• datasetId (erforderlich) – Dataset-Identifikator
• limit (Standard/Maximum 1000) – Elemente pro Seite
• offset (Standard 0) – Paginierungs-Offset
• format – json (empfohlen), csv, xlsx
• fields – Nur bestimmte Felder einschließen
• omit – Bestimmte Felder ausschließen
• clean – Apify-spezifische Metadaten entfernen
• desc – Umgekehrte Reihenfolge (neueste zuerst)

Beispiel-Prompt: "Hole die ersten 500 Elemente aus dem Dataset myDatasetId im JSON-Format"

---

4. Actor-Details anzeigen

Zeigen Sie Actor-Metadaten, Eingabeschema und Konfiguration vor der Ausführung an.

Tool: APIFY_GET_ACTOR

Wichtige Parameter:

• actorId (erforderlich) – Actor-ID im Format benutzername/actor-name oder Hex-ID

Beispiel-Prompt: "Zeige mir die Details und das Eingabeschema für den Actor apify/web-scraper an"

---

5. Wiederverwendbare Tasks erstellen

Konfigurieren Sie wiederverwendbare Actor-Tasks mit voreingestellten Eingaben für wiederkehrende Scraping-Aufträge.

Tool: APIFY_CREATE_TASK

Konfigurieren Sie einen Task einmal und führen Sie ihn dann wiederholt mit konsistenten Eingabeparametern aus. Nützlich für geplante oder wiederkehrende Datenerfassungs-Workflows.

Beispiel-Prompt: "Erstelle einen Apify-Task für den Google-Suche-Scraper mit der Standardabfrage 'KI-Startups' und dem Standort USA"

---

6. Runs und Datasets verwalten

Listen Sie Actor-Runs auf, durchsuchen Sie Datasets und überprüfen Sie Run-Details zur Überwachung und Fehlersuche.

Tools: APIFY_GET_LIST_OF_RUNS, APIFY_DATASETS_GET, APIFY_DATASET_GET, APIFY_GET_LOG

Für das Auflisten von Runs:

• Filtern Sie nach Actor und optional nach Status
• Holen Sie die datasetId aus den Run-Details für den Datenabruf

Für die Dataset-Verwaltung:

• APIFY_DATASETS_GET – Listet alle Ihre Datasets mit Paginierung auf
• APIFY_DATASET_GET – Ruft Metadaten für ein bestimmtes Dataset ab

Für die Fehlersuche:

• APIFY_GET_LOG – Ruft Ausführungslogs für einen Run oder Build ab

Beispiel-Prompt: "Liste die letzten 10 Runs für den Web-Scraper-Actor auf und zeige die Logs für den neuesten an"

---

Bekannte Fallstricke

• Actor-Eingabeschemata variieren stark: Jeder Actor hat eigene, einzigartige Eingabefelder. Allgemeine Feldnamen wie queries oder search_terms werden abgelehnt. Überprüfen Sie immer die Actor-Seite auf apify.com/store auf genaue Feldnamen (z.B. searchStringsArray für Google Maps, startUrls für Web-Scraper).
• URL-Format-Anforderungen: Fügen Sie immer das vollständige Protokoll (https:// oder http://) in URLs ein. Viele Actors erwarten URLs als Objekte mit einer url-Eigenschaft: {"startUrls": [{"url": "https://example.com"}]}.
• Dataset-Paginierungsgrenze: APIFY_GET_DATASET_ITEMS hat ein maximales limit von 1000 pro Aufruf. Für große Datasets iterieren Sie mit offset, um alle Elemente zu sammeln.
• Enum-Werte sind kleingeschrieben: Die meisten Actors erwarten kleingeschriebene Enum-Werte (z.B. relevance nicht RELEVANCE, all nicht ALL).
• Sync-Timeout bei 5 Minuten: APIFY_RUN_ACTOR_SYNC_GET_DATASET_ITEMS hat eine maximale waitForFinish von 300 Sekunden. Für längere Runs verwenden Sie APIFY_RUN_ACTOR (async) und fragen Sie mit APIFY_GET_DATASET_ITEMS ab.
• Datenvolumen-Kosten: Große Datasets können teuer im Abruf sein. Bevorzugen Sie moderate Limits und inkrementelle Verarbeitung, um Timeouts oder Speicherdruck zu vermeiden.
• JSON-Format empfohlen: Obwohl CSV-/XLSX-Formate verfügbar sind, ist JSON für die automatisierte Verarbeitung am zuverlässigsten. Vermeiden Sie CSV/XLSX für nachgelagerte Automatisierung.

---

Kurzreferenz

Tool-Slug	Beschreibung
APIFY_RUN_ACTOR_SYNC_GET_DATASET_ITEMS	Actor synchron ausführen und sofort Ergebnisse abrufen
APIFY_RUN_ACTOR	Actor asynchron ausführen (starten und zurückkehren)
APIFY_RUN_ACTOR_SYNC	Actor synchron ausführen, Ausgabedatensatz zurückgeben
APIFY_GET_ACTOR	Actor-Metadaten und Eingabeschema abrufen
APIFY_GET_DATASET_ITEMS	Elemente aus einem Dataset abrufen (paginiert)
APIFY_DATASET_GET	Dataset-Metadaten abrufen (Elementanzahl usw.)
APIFY_DATASETS_GET	Alle Benutzer-Datasets auflisten
APIFY_CREATE_TASK	Wiederverwendbaren Actor-Task erstellen
APIFY_GET_TASK_INPUT	Gespeicherte Eingabe eines Tasks anzeigen
APIFY_GET_LIST_OF_RUNS	Runs für einen Actor auflisten
APIFY_GET_LOG	Ausführungslogs für einen Run abrufen

---

Betrieben von Composio