# Receptury MCP

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

Dziewięć gotowych do wklejenia promptów, które możesz uruchomić w dowolnym kliencie zgodnym z MCP (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code) po zainstalowaniu [serwera MCP FourA](https://foura.ai/docs/mcp/server).

Każdy przepis wykorzystuje `foura_auto` (inteligentna wartość domyślna) lub jedno bądź więcej narzędzi niższego poziomu: `foura_single`, `foura_proxy`, `foura_browser` do typowych zadań scrapingu. Dwa sposoby użycia:

1. **Wywołaj wbudowany prompt** - każdy klient MCP udostępnia prompty dostarczane przez serwer jako polecenie z ukośnikiem lub panel `/prompts`. Wybierz prompt, uzupełnij argumenty, uruchom. Serwer MCP zwraca szablon przepływu pracy; LLM wykonuje go przy użyciu odpowiednich narzędzi.
2. **Skopiuj poniższą treść** do własnego czatu. Efekt jest ten sam, ale rozwiązanie jest mniej poręczne.

Serwer MCP dostarcza je jako natywne prompty: `smart_fetch`, `scrape_product_page`, `extract_article`, `monitor_pricing`, `check_endpoint_health`, `bulk_fetch_urls`.

> **Uwaga dotycząca dużych stron (v0.2.0+):** domyślnie treści odpowiedzi są zwracane w tekście w `structuredContent` bez względu na rozmiar - działa to w każdym kliencie MCP, w tym w Claude Desktop. Jeśli korzystasz z klienta obsługującego MCP `resources/read` ORAZ zależy Ci na oszczędzaniu tokenów przy dużych stronach, przekaż `offload_large: true` w wywołaniu narzędzia. Odpowiedzi >= 50 KB są wtedy zwracane jako `resource_link`, które klient pobiera na żądanie. Poniższe wbudowane prompty zakładają zachowanie domyślne (w tekście).


Open source na [GitHubie](https://github.com/fouradata/mcp); w [npm](https://www.npmjs.com/package/@fouradata/mcp) jako `@fouradata/mcp`.

## Smart fetch (auto): zacznij tutaj

Najprostszy przepis: przekaż URL do `foura_auto` i pozwól mu wykonać ograniczoną liczbę prób przy użyciu dostępnych metod requestów. Użyj go zawsze, gdy potrzebujesz zawartości i nie musisz samodzielnie wybierać pierwszego narzędzia.

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

Ręczny 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.
```

Kiedy to jest właściwa receptura: przy pierwszej próbie, gdy FourA powinien sam dobrać metodę, zwłaszcza jeśli walidacja treści pozwala odróżnić prawdziwą stronę od odmowy dostępu.

## 1. Scrapowanie strony produktu

Dla stron produktów e-commerce, w tym aplikacji typu SPA i stron z weryfikacją zabezpieczeń.

Wbudowane: `scrape_product_page(url)`

Ręczny 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": "..."}
```

Kiedy to właściwe rozwiązanie: agent porównujący ceny, powiadomienia o dostępności towaru, arkusz analizy konkurencji.

## 2. Wyodrębnij artykuł

Dla artykułów z wiadomościami, postów na blogu, dokumentacji technicznej i wszystkiego, gdzie potrzebny jest czysty tekst do czytania bez nawigacji, reklam i szumu w stopce.

Wbudowane: `extract_article(url)`

Ręczny 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": "..."}
```

Kiedy to właściwy wybór: podsumowanie badań, kanał RSS dla pojedynczej strony, codzienny przegląd wiadomości.

## 3. Monitorowanie ceny

Dla stron cenników i ofert produktów, z opcjonalnym porównaniem z ceną docelową.

Wbudowane: `monitor_pricing(url, target_price?)`

Własny 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"}
```

Kiedy to właściwe rozwiązanie: agent powiadomień o oszczędnościach, monitor cen podróży, tracker cen konkurencji B2B.

## 4. Sprawdzanie stanu endpointu

Do sondowania uptime i walidacji endpointów API.

Wbudowane: `check_endpoint_health(url, expected_text?)`

Ręczny 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}
```

Kiedy to właściwe rozwiązanie: zewnętrzny monitor uptime, smoke test wdrożenia, watchdog zewnętrznego API.

## 5. Równoległe pobieranie listy adresów URL

Do zadań wsadowych, w których potrzebujesz metadanych o wielu adresach URL bez pobierania ich treści inline.

Wbudowane: `bulk_fetch_urls(urls)`

Ręczny 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.
```

Kiedy warto wybrać ten schemat: weryfikacja dostępności sitemapy, audyt niedziałających linków, sprawdzenie typu „które z tych 50 adresów URL produktów nadal istnieją”.

## 6. Wybór i ponowne użycie węzła wyjściowego powiązanego z krajem

Stosuj to rozwiązanie, gdy cel musi widzieć żądanie z jednego z określonych krajów, w tym w przypadku stron JavaScript, gdzie wybór proxy musi nastąpić przed renderowaniem w przeglądarce.

Prompt ręczny:

```
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.
```

Kiedy to odpowiednie rozwiązanie: treści regionalne, rynki licencjonowane, ceny zależne od lokalizacji lub dowolny proces wymagający zweryfikowanego kraju widocznego dla celu, a następnie ponownego użycia wybranego punktu wyjścia. Określanie kraju jest dostępne od planu Startup wzwyż; w pozostałych planach `foura_proxy` zwraca `plan_limit_feature`, czego nie rozwiąże ponowna próba.

## 7. Chroniona strona: najpierw proxy, przeglądarka gdy wymagany jest JavaScript

Zastosuj ograniczoną liczbę prób przez proxy z walidacją treści, gdy bezpośrednie żądanie zwraca stronę odmowy. Jeśli zweryfikowana odpowiedź jest poprawna, ale oczekiwana treść nadal wymaga JavaScriptu, użyj ponownie tego samego proxy ID w przeglądarce. Widoczny dostawca zabezpieczeń nie gwarantuje powodzenia żadnej z metod.

Ręczny 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.
```

Kiedy ten schemat jest odpowiedni: chroniony cel, w przypadku którego HTTP może wybrać działający węzeł wyjściowy, ale ostateczna treść wymaga renderowania JavaScriptu.

## 8. Blokada na stronie statycznej: zmień prezentowaną przeglądarkę

Użyj tego, gdy statyczny cel zwraca blokadę lub stronę typu challenge, a problemem nie jest JavaScript. Request domyślnie przedstawia się jako najnowszy Google Chrome; niektóre cele akceptują inną przeglądarkę lub platformę.

Ręczny monit:

```
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.
```

Kiedy to odpowiednia metoda: cel renderowany po stronie serwera, który filtruje na podstawie widocznego klienta, a nie adresu wyjściowego. Zmiana prezentowanej przeglądarki nic nie kosztuje i warto ją wypróbować przed rotacją proxy.

## Wskazówki dotyczące wszystkich metod

- **Nie wiesz, którego narzędzia użyć? Użyj foura_auto.** Wybiera metodę i samodzielnie zarządza eskalacją. Sięgaj po konkretne narzędzie tylko wtedy, gdy potrzebujesz pełnej kontroli.
- **Zacznij od `foura_single`, gdy wystarczy zwykły HTTP.** Eskaluj do `foura_proxy`, gdy bezpośrednie requesty są blokowane, oraz do `foura_browser`, gdy docelowa treść wymaga JavaScriptu.
- **Nagłówki requestów imitujące przeglądarkę są domyślnie włączone (`unblocker`).** Zachowaj walidację treści, aby strona z odmową dostępu nie została uznana za sukces, i zmień prezentowaną przeglądarkę za pomocą `browser`, `os` lub `version`, gdy cel odrzuca ustawienie domyślne.
- **Reguły walidacji oszczędzają próby ponowienia.** Ustaw `validate.data.fail:["captcha", "blocked"]`, aby oczywiście zablokowana response była traktowana jako błąd i wymuszała ponowienie lub eskalację proxy, zamiast być parsowana jako sukces.
- **Zakres kraju jest ścisły.** Wynik `no_eligible_proxy` nie daje uprawnienia do ponowienia próby bez `exitCountries`; zachowaj ten wymóg lub zapytaj użytkownika przed jego zmianą.
- **Duże body są domyślnie przekazywane inline (v0.2.0+).** Przekaż `offload_large: true`, aby przełączyć się na `resource_link` + `resources/read` na klientach obsługujących te możliwości.

## Potrzebujesz metody, której tu nie ma?

Napisz na `support@foura.ai`, opisując swój use case. Serwer MCP udostępnia nowe prompty w tym samym cyklu wydawniczym, co REST API.
