apify-utils-mcp

Vier kleine Hilfsprogramme hinter einem MCP-Server: PDF-Text, Tabellen und OCR, YouTube-Thumbnail-URLs und -Dateien, Spielergebnisse und Tabellenstände und ATP/WTA-Tennis.

Jedes Tool ist ein dünner Client für einen öffentlichen Apify-Actor. Ausführungen werden von Apify Ihrem eigenen Konto in Rechnung gestellt – siehe Preise. Dieser Server leitet nie einen Aufruf weiter, sieht nie Ihr Token oder Ihre Ergebnisse und bezahlt nie eine Ausführung in Ihrem Namen.

Installation

Erfordert uv und ein kostenloses Apify-Token.

{
  "mcpServers": {
    "apify-utils": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/moonie0201/apify-utils-mcp", "apify-utils-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_..." }
    }
  }
}

Related MCP server: PDF Tools MCP Server

Tools

Filter (page_range, teams, status, max_pages_per_pdf) werden vor der Abrechnung angewendet, sodass eine enge Abfrage günstig ist, anstatt eine große Antwort zu erhalten, die Sie nachträglich filtern. Das Ausgabenobergrenzen-Argument ist bei jedem kostenpflichtigen Tool erforderlich — es gibt keine Möglichkeit, von hier aus eine unbegrenzte Ausführung zu starten.

Preise

Keiner der Actors erhebt eine Startgebühr, sodass eine Ausführung, die fehlschlägt oder nichts findet, nichts kostet.

Rechenbeispiele: eine 2-seitige Rechnung kostet $0.0006, ein 100-seitiges Handbuch $0.03, 20 gescannte Seiten mit OCR $0.06, 100 Videos $0.50, das heutige NBA-Programm mit 8 Spielen $0.016, 500 Spielzusammenfassungen $2.00.

Die Abrechnung erfolgt auf dem Apify-Konto, das zu Ihrem eigenen APIFY_TOKEN gehört. Das Ausgabenobergrenzen-Argument ist nicht nur Dokumentation: Der Server wandelt es in maxTotalChargeUsd der Ausführung um, sodass Apify die Dollar-Obergrenze selbst durchsetzt und die Ausführung stoppt, sobald sie erreicht ist. Da OCR-Seiten auf dasselbe max_pages-Budget zum zehnfachen Preis zugreifen, bedeutet max_pages=1000 $0.30 bei deaktiviertem ocr und $3.00 bei aktiviertem; die an Apify gesendete Obergrenze richtet sich nach dem jeweils zutreffenden Fall. Apify lehnt eine Obergrenze unterhalb des eigenen Minimums eines Actors ab ($0.05 für extract_pdf, $0.10 für die übrigen). Daher verlangen sehr kleine Ausführungen diesen Mindestbetrag — eine Obergrenze, keine Gebühr: Ein 2-seitiges PDF kostet weiterhin $0.0006.

Die Ausführung wird außerdem mit timeout=290 innerhalb von Apifys synchronem 300-Sekunden-Fenster gestartet, sodass eine Ausführung den Aufruf nie überleben und im Hintergrund weiter Kosten verursachen kann.

Sportdaten: zuerst lesen

Inoffiziell. Nicht mit ESPN, The Walt Disney Company oder einer Liga verbunden, von diesen unterstützt oder gesponsert. Die Daten stammen aus den unauthentifizierten JSON-Feeds, die espn.com selbst verwendet; sie sind undokumentiert, Disneys Nutzungsbedingungen für espn.com schränken automatisierten Zugriff ein, und ESPN kann den Zugriff ohne Vorankündigung ändern oder blockieren — falls das passiert, bricht der Actor die Ausführung ab und verrechnet nichts, und wir stoppen innerhalb von 48 h nach jeder Mitteilung von ESPN oder Disney. Ergebnisse, Spielpläne und Tabellenstände sind Fakten; ESPN-Artikel, -Videos und -Bilder sind urheberrechtlich geschütztes Material von ESPN und nicht enthalten. Quoten sind die Vorspiel-Linie eines Sportwettenanbieters, die auf ESPN angezeigt wird, nur zur Information — nicht zum Wetten. Team- und Ligabezeichnungen und -logos sind Marken ihrer jeweiligen Inhaber. Entfernungsanfragen: TAKEDOWN.md — werden innerhalb von 48 h bearbeitet.

include_odds ist hier standardmäßig deaktiviert, anders als beim Actor. Aktivieren Sie es nur, wenn Sie die Vorspiel-Linie in die Zeile übernehmen möchten. timezone ist standardmäßig UTC und wirkt sich nur auf das Feld dateLocal aus; Feed-Daten sind in beiden Fällen in UTC.

Verfügbarkeit. Alle vier Actors sind öffentlich: acotr_moonie/pdf-text-extractor, acotr_moonie/youtube-thumbnail-downloader, acotr_moonie/espn-sports-scraper und acotr_moonie/tennis-scores-scraper (die beiden Sport-Auflistungen seit 2026-08-28). Jedes Tool wurde Ende-zu-Ende gegen seinen Live-Actor verifiziert.

leagues akzeptiert: nfl, ncaaf, nba, wnba, ncaab, ncaaw, mlb, nhl, mls, nwsl, epl, championship, fa-cup, la-liga, serie-a, bundesliga, ligue-1, eredivisie, primeira-liga, liga-mx, saudi-pro-league, wsl, ucl, uel, uecl, nations-league, world-cup, copa-libertadores, atp, wta, pga, f1, ufc — oder jeden rohen ESPN-Pfad wie soccer/bra.1, der bei Unbekanntheit als kostenlose Fehlerzeile zurückkommt.

YouTube

Nur namentliche Bezugnahme: Dieses Tool liest das öffentliche Thumbnail-CDN i.ytimg.com und den öffentlichen oEmbed-Endpunkt von YouTube. Nicht mit YouTube oder Google verbunden, von diesen unterstützt oder gesponsert; der Name und das Logo von YouTube sind Marken von Google LLC. Thumbnails unterliegen dem Urheberrecht des Uploaders oder seiner Lizenzgeber — das Tool ruft sie ab, gewährt Ihnen jedoch keine Lizenz, sie erneut zu veröffentlichen.

Was es nicht tun wird

• Nichts wird abgeleitet. Wo ein Wert nicht bestimmt werden kann, ist das Feld null.

• extract_pdf liest PDFs, die Sie mit einem einfachen GET angeben, ohne Proxy und ohne Anmeldung. Sie sind für die Nutzungsbedingungen und Robots-Regeln der Hosting-Website verantwortlich. PDFs, deren Eigentümer das Kopieren von Text deaktiviert hat, werden immer übersprungen – mit einer kostenlosen Fehlerzeile und ohne Überschreibungsmöglichkeit.

• Markdown-Überschriften und -Absätze sind Heuristiken auf Basis von Schriftgröße und Zeilenabständen, kein Layoutmodell. Die Tabellenextraktion findet mit Linien gezeichnete Tabellen; Tabellen ohne Linien bleiben im Text.

• youtube_thumbnails erweitert keine Playlist- oder Kanal-URLs und lädt kein Video herunter.

• Die Sport-Tools enthalten weder Nachrichten, Artikel, Kader, Verletzungen, Athleten-Biografien, Play-by-Play noch Videos und auch kein ITF- oder Challenger-Tennis.

Entwicklung

uv venv && uv pip install -e ".[dev]"
python -m pytest tests -q       # offline: httpx is monkeypatched, nothing is billed
ruff check . && ruff format --check .
python -m apify_utils_mcp --list-tools

Links

• Actor-Quellcode, MIT: https://github.com/moonie0201/apify-utils

• Datenschutzerklärung: https://github.com/moonie0201/apify-utils/blob/main/PRIVACY.md

• Entfernungsrichtlinie: https://github.com/moonie0201/apify-utils/blob/main/TAKEDOWN.md

Offenlegung

Ich habe das gebaut, und die vier dahinterstehenden Actors sind kostenpflichtig. Der Adapter-Code ist offen und MIT-lizenziert.