# MCP-Rezepte

> URL: https://foura.ai/de/docs/mcp/recipes
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

Neun sofort einsatzbereite Prompts, die du nach der Installation des [FourA-MCP-Servers](https://foura.ai/docs/mcp/server) in jedem MCP-kompatiblen Client (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code) ausführen kannst.

Jedes Rezept nutzt `foura_auto` (den intelligenten Standard) oder eines bzw. mehrere der Low-Level-Tools `foura_single`, `foura_proxy`, `foura_browser` für gängige Scraping-Aufgaben. Zwei Nutzungswege:

1. **Integrierten Prompt aufrufen**: Jeder MCP-Client stellt vom Server bereitgestellte Prompts als Slash-Befehl oder über das `/prompts`-Panel bereit. Wähle den Prompt aus, fülle die Argumente aus und starte ihn. Der MCP-Server gibt den vorbereiteten Workflow zurück; das LLM führt ihn mit den passenden Tools aus.
2. **Text kopieren**: Kopiere den unten stehenden Text in deinen Chat. Gleicher Effekt, weniger komfortabel auffindbar.

Der MCP-Server liefert diese als native Prompts aus: `smart_fetch`, `scrape_product_page`, `extract_article`, `monitor_pricing`, `check_endpoint_health`, `bulk_fetch_urls`.

> **Hinweis zu großen Seiten (v0.2.0+):** Standardmäßig werden Response-Bodies unabhängig von ihrer Größe inline in `structuredContent` zurückgegeben. Das funktioniert in jedem MCP-Client, einschließlich Claude Desktop. Wenn dein Client MCP-`resources/read` unterstützt UND du bei großen Seiten Token sparen möchtest, übergib `offload_large: true` im Tool-Call. Antworten ab 50 KB werden dann als `resource_link` bereitgestellt, die dein Client bei Bedarf abruft. Die unten aufgeführten integrierten Prompts setzen den Standard (inline) voraus.


Open Source auf [GitHub](https://github.com/fouradata/mcp); auf [npm](https://www.npmjs.com/package/@fouradata/mcp) als `@fouradata/mcp`.

## Smart Fetch (automatisch): Starte hier

Das einfachste Rezept: Übergib eine URL an `foura_auto` und lass das Tool begrenzte Versuche über alle verfügbaren Request-Methoden ausführen. Nutze es immer dann, wenn du den Inhalt benötigst und das Start-Tool nicht selbst wählen möchtest.

Integriert: `smart_fetch(url, must_contain?, extract?)`

Manueller Prompt:

```
Fetch <URL> using foura_auto.

Pass validate.data.accept:["<a string the real page must contain>"] so only the real page counts as success. Auto makes bounded attempts and returns an error if none satisfies the validation.

For a plain follow-up, call foura_single with session.proxy as proxy, session.cookies serialized as a Cookie header, and session.userAgent as a User-Agent header. For JavaScript, pass the session values to the matching foura_browser fields.

Return the content, or extract the requested fields as JSON.
```

Wann dies das richtige Rezept ist: ein erster Versuch, bei dem FourA die Methode wählen soll, besonders wenn die Inhaltsvalidierung eine echte Seite von einer Verweigerungsseite unterscheiden kann.

## 1. Eine Produktseite scrapen

Für E-Commerce-Produktdetailseiten, einschließlich Single-Page-App-Websites und Seiten mit Site-Check.

Integriert: `scrape_product_page(url)`

Manueller Prompt:

```
Fetch the product page at <URL> using foura_browser - most product pages are single-page apps and need JavaScript to render.

From the response body extract:
- product title
- price (with currency)
- primary product image URL (absolute, not relative)
- availability / stock status
- product SKU or ID if visible

Return as JSON: {"title": "...", "price": 0, "currency": "USD", "image_url": "...", "in_stock": true, "sku": "..."}
```

Wann dieses Rezept passt: Preisvergleichs-Agents, Verfügbarkeits-Benachrichtigungen, Tabellen zur Konkurrenzanalyse.

## 2. Artikel extrahieren

Für Nachrichtenartikel, Blogposts, technische Dokumentationen, alles, wofür du sauberen Lesetext ohne Navigation, Werbung und Footer-Rauschen brauchst.

Integriert: `extract_article(url)`

Manueller Prompt:

```
Fetch <URL> using foura_single with unblocker:true. Use plain HTTP first when the article is present in the server-rendered response.

If foura_single returns a 403, a verification page, or empty content, retry the same URL with foura_proxy (maxTries:3) - it routes through a rotating proxy pool.

From the response, extract:
- headline (the main H1, not the page title bar)
- author byline (may be inside .author, [rel=author], itemprop)
- publication date (look for <time>, .published, or JSON-LD)
- main article body (strip navigation, ads, related-content, footer, comments)
- canonical URL (rel=canonical or og:url)

Return as JSON: {"title": "...", "author": "...", "date_published": "ISO8601", "body": "...", "canonical_url": "..."}
```

Wann dieses Rezept passt: Research-Zusammenfassungen, ein RSS-Feed für eine einzelne Website, ein täglicher News-Digest.

## 3. Preis überwachen

Für Preisseiten und Produktangebote, mit optionalem Abgleich gegen einen Zielpreis.

Integriert: `monitor_pricing(url, target_price?)`

Manueller Prompt:

```
Use foura_proxy with maxTries:5 to fetch <URL>. Pricing pages often have aggressive bot detection, so go through the proxy pool from the start.

Extract the current price (look for visible $/€/£ amounts, JSON-LD Offer schema, [itemprop=price]).

If a target price is provided, compare: report whether current is below/at/above target and the absolute difference.

Return as JSON: {"url": "...", "current_price": 0.00, "currency": "USD", "target_price": 0, "difference": 0, "status": "below|at|above"}
```

Wann dieses Rezept passt: ein Sparalarm-Agent, ein Reise-Tarif-Watcher, ein B2B-Mitbewerber-Preistracker.

## 4. Endpoint-Health prüfen

Für Uptime-Probes und API-Endpoint-Validierung.

Integriert: `check_endpoint_health(url, expected_text?)`

Manueller Prompt:

```
Use foura_single with GET on <URL>, timeout_ms:5000, and validate.status.accept:[200]. If an expected substring is provided, also set validate.data.accept:["<EXPECTED>"] so the request only counts as success when the body contains it.

Report:
- reachable (true if any response came back, false on connection error/timeout)
- status_code (HTTP code from target)
- total_time_ms (the total_time field is in seconds: multiply by 1000)
- validation_passed (true if status + body validation conditions were met)

Return as JSON: {"url": "...", "reachable": true, "status_code": 200, "total_time_ms": 0, "validation_passed": true}
```

Wann dieses Rezept passt: ein externer Uptime-Monitor, ein Deploy-Smoke-Test, ein Watchdog für Drittanbieter-APIs.

## 5. Eine Liste von URLs parallel abrufen

Für Batch-Jobs, bei denen du Metadaten zu vielen URLs benötigst, ohne deren Bodies einzubinden.

Integriert: `bulk_fetch_urls(urls)`

Manueller Prompt:

```
Parse the following comma-separated URLs and fetch each one concurrently using foura_single (unblocker:true).

URLs: <COMMA_SEPARATED>

For any URL that returns 403, a verification page, or empty body - retry that single URL with foura_proxy (maxTries:3).

Return a JSON array, one entry per URL in input order:
[{"url": "...", "status": 200, "success": true, "body_size_bytes": 0, "via": "single|proxy", "error": null}, ...]

Do NOT inline full response bodies in the output - only metadata. If you need body content, call foura_single individually after this report.
```

Wann dieses Rezept das richtige ist: ein Sitemap-Erreichbarkeits-Sweep, ein Link-Rot-Audit, ein Check, welche dieser 50 Produkt-URLs noch existieren.

## 6. Einen länderspezifischen Exit wählen und wiederverwenden

Verwende dies, wenn das Ziel den Request aus einem bestimmten Set von Ländern sehen muss. Das gilt auch für JavaScript-Seiten, bei denen die Proxy-Auswahl vor dem Browser-Rendering erfolgen muss.

Manueller Prompt:

```
First call foura_proxy for the actual target:
{
  "maxTries": 5,
  "exitCountries": ["FR", "GB"],
  "request": { "method": "GET", "url": "<TARGET_URL>" }
}

Treat exitCountries as a strict allowlist. On success, verify that exitCountry is FR or GB and capture the returned proxy ID.

If the page then needs JavaScript, call foura_browser with the returned proxy ID in foura_browser.proxy. Do not start a new proxy selection, because that may choose a different exit.

If foura_proxy returns no_eligible_proxy, preserve the requested country scope and retry later. Change or widen the list only after the user explicitly changes the requirement. Never retry silently without exitCountries.
```

Wann dieses Recipe passt: regionale Inhalte, lizenzierte Maerkte, laenderspezifische Preise oder jeder Workflow, der ein verifiziertes, fuer das Ziel sichtbares Land benoetigt und den ausgewaehlten Exit anschliessend wiederverwendet. Country-Scoping ist ab dem Startup-Plan enthalten; bei anderen Plaenen gibt `foura_proxy` `plan_limit_feature` zurueck, was auch durch einen Retry nicht behoben wird.

## 7. Geschuetzte Seite: Zuerst Proxy, Browser bei JavaScript-Bedarf

Nutze einen begrenzten Proxy-Versuch mit Inhaltsvalidierung, wenn ein direkter Request eine Ablehnungsseite zurueckgibt. Wenn die validierte Response erfolgreich ist, der gewuenschte Inhalt aber noch JavaScript benoetigt, verwende genau diese Proxy-ID im Browser wieder. Ein sichtbarer Protection-Anbieter garantiert nicht, dass eine Methode erfolgreich ist.

Manueller Prompt:

```
Step 1 - call foura_proxy for <TARGET_URL>. Put a string unique to the real page in request.validate.data.accept. If the user supplied an allowed country list, pass it as exitCountries; do not guess country codes.

Step 2 - if the response passes validation and JavaScript is still required, call foura_browser with the returned proxy ID in the proxy field.

Do not call foura_proxy again after a successful selection, because the new call may choose a different exit. If the bounded attempt fails, report the failure honestly instead of claiming support for the target's protection vendor.
```

Wann dies das richtige Rezept ist: ein geschütztes Ziel, bei dem HTTP einen funktionierenden Exit wählen kann, der finale Inhalt jedoch JavaScript-Rendering erfordert.

## 8. Auf einer statischen Seite blockiert: Ändere den vorgegebenen Browser

Nutze dies, wenn ein statisches Ziel eine Blockier- oder Challenge-Seite zurückgibt und JavaScript nicht das Problem ist. Der Request gibt standardmäßig das neueste Google Chrome vor; manche Ziele akzeptieren einen anderen Browser oder eine andere Plattform.

Manueller Prompt:

```
Step 1 - call foura_single for <TARGET_URL> with request validation: put a string unique to the real page in validate.data.accept.

Step 2 - if the response is a refusal page, or defense comes back with solved false, call foura_single again with a different presented browser, for example {"browser": "Firefox"} or {"browser": "Chrome", "os": "Android"}. Keep the same validation.

If the tool answers that the combination does not exist, pick one from the list it returns. Do not retry the same impossible combination, and do not assume another browser was used instead: the request was refused, not substituted.

Step 3 - if changing the presented browser does not help, escalate to foura_proxy for a different exit, and to foura_browser only when the content genuinely needs JavaScript.
```

Wann dies das richtige Rezept ist: ein serverseitig gerendertes Ziel, das nach dem erkannten Client filtert statt nach der Exit-Adresse. Den vorgegebenen Browser zu aendern kostet nichts extra und lohnt einen Versuch vor der Proxy-Rotation.

## Tipps fuer alle Methoden

- **Nicht sicher, welches Tool? Nutze foura_auto.** Es waehlt die Methode und uebernimmt die Eskalation fuer dich. Greife nur zu einem spezifischen Tool, wenn du explizite Kontrolle willst.
- **Starte mit `foura_single`, wenn einfaches HTTP ausreicht.** Eskaliere auf `foura_proxy`, wenn der direkte Request blockiert wird, und auf `foura_browser`, wenn der gewuenschte Inhalt JavaScript benoetigt.
- **Browser-aehnliche Request-Header sind standardmaessig aktiv (`unblocker`).** Behalte die Content-Validierung bei, damit eine Blockierseite nicht als Erfolg gewertet wird, und aendere den vorgegebenen Browser ueber `browser`, `os` oder `version`, wenn ein Ziel den Standard ablehnt.
- **Validierungsregeln sparen Retries.** Setze `validate.data.fail:["captcha", "blocked"]`, damit eine offensichtlich blockierte Response als Fehlschlag zaehlt und Retry- oder Proxy-Eskalation ausloest, statt als Erfolg geparst zu werden.
- **Laenderspezifische Scopes sind strikt.** Ein `no_eligible_proxy`-Ergebnis ist keine Erlaubnis fuer einen erneuten Versuch ohne `exitCountries`; behalte die Anforderung bei oder frage den Nutzer, bevor du sie aenderst.
- **Grosse Bodies sind standardmaessig inline (v0.2.0+).** Uebergib `offload_large: true`, um bei Clients, die diese Faehigkeiten unterstuetzen, zu `resource_link` + `resources/read` zu wechseln.

## Fehlt dir ein Rezept?

Sende eine E-Mail mit deinem Use Case an `support@foura.ai`. Der MCP-Server veroeffentlicht neue Prompts im selben Rhythmus wie die REST-API-Releases.
