MCP Рецепти

Девет готови за поставяне промпта, които можете да стартирате във всеки съвместим с MCP клиент (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code) след инсталиране на FourA MCP server.

Всяка рецепта използва foura_auto (интелигентната опция по подразбиране) или един или повече от инструментите от по-ниско ниво foura_single, foura_proxy, foura_browser за често срещана задача по извличане на данни. Два начина за използването им:

  1. Извикване на вградения промпт - всеки MCP клиент показва предоставените от сървъра промптове като команда с наклонена черта или /prompts панел. Изберете промпта, попълнете аргументите, стартирайте. MCP сървърът връща шаблонирания работен процес; LLM моделът го изпълнява с подходящите инструменти.
  2. Копиране на текста по-долу във вашия чат. Същият резултат, но по-трудно за откриване.

MCP сървърът предоставя следните вградени промптове: smart_fetch, scrape_product_page, extract_article, monitor_pricing, check_endpoint_health, bulk_fetch_urls.

Бележка относно големи страници (v0.2.0+): по подразбиране телата на отговорите се връщат вградени в structuredContent независимо от размера - това работи във всеки MCP клиент, включително Claude Desktop. Ако използвате клиент, който поддържа MCP resources/read И искате да спестите токени при големи страници, подайте offload_large: true в извикването на инструмента. Отговори с размер >= 50 KB тогава се връщат като resource_link, който вашият клиент изтегля при поискване. Вградените промптове по-долу предполагат поведението по подразбиране (inline).

Отворен код в GitHub; в npm като @fouradata/mcp.

Интелигентно извличане (автоматично): започнете оттук

Най-простата рецепта: подайте URL на foura_auto и го оставете да направи ограничен брой опити чрез наличните методи за заявка. Използвайте я винаги, когато искате съдържанието и не е необходимо сами да избирате първия инструмент.

Вграден: smart_fetch(url, must_contain?, extract?)

Ръчен промпт:

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.

Кога това е правилната рецепта: първи опит, при който FourA трябва да избере метода, особено когато валидирането на съдържанието може да различи реална страница от страница с отказ.

1. Скрапване на продуктова страница

За страници с подробности за продукти в електронната търговия, включително single-page-app сайтове и страници със защита или проверка.

Вградено: scrape_product_page(url)

Ръчен промпт:

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": "..."}

Кога това е правилната рецепта: агент за сравнение на цени, известител за наличност, таблица за анализ на конкуренцията.

2. Извличане на статия

За новинарски статии, публикации в блогове, техническа документация или всичко, където искате чист текст за четене без навигация, реклами и излишен шум във футъра.

Вградено: extract_article(url)

Ръчен промпт:

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": "..."}

Кога това е правилната рецепта: обобщаване на проучвания, RSS за един сайт, ежедневен дайджест с новини.

3. Мониторинг на цена

За страници с ценообразуване и продуктови оферти, с опция за сравнение спрямо целева цена.

Вградено: monitor_pricing(url, target_price?)

Ръчен 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"}

Кога това е подходящата рецепта: агент за известия за спестявания, инструмент за следене на цени за пътувания, тракер за цени на B2B конкуренти.

4. Проверка на изправността на endpoint

За uptime проверки и валидация на API endpoint.

Вградено: check_endpoint_health(url, expected_text?)

Ръчен промпт:

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}

Кога това е правилната рецепта: външен мониторинг на ъптайм, диплой smoke тест, watchdog за third-party API.

5. Паралелно извличане на списък с URL адреси

За batch задачи, при които ви трябват метаданни за множество URL адреси без вграждане на телата им.

Вградено: bulk_fetch_urls(urls)

Ръчен промпт:

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.

Кога това е правилната рецепта: обхождане на достъпността на sitemap, одит за неработещи линкове, проверка от типа "кои от тези 50 продуктови URL адреса все още съществуват".

6. Изберете и използвайте повторно изходна точка по държава

Използвайте това, когато целта трябва да вижда заявката от конкретен набор от държави, включително JavaScript страници, където изборът на proxy трябва да се извърши преди рендирането в браузъра.

Ръчен промпт:

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.

Кога тази рецепта е подходяща: регионално съдържание, лицензирани пазари, гео-специфично ценообразуване или всеки работен процес, който изисква верифицирана видима за таргета държава и след това преизползва избрания изход. Задаването на обхват по държава е включено от план Startup нагоре; при останалите планове foura_proxy връща plan_limit_feature, което не се изчиства с повторен опит.

7. Защитена страница: първо proxy, браузър при нужда от JavaScript

Използвайте ограничен опит през proxy с валидация на съдържанието, когато директната заявка връща страница с отказ. Ако валидираният отговор е успешен, но желаното съдържание все още изисква JavaScript, преизползвайте същия proxy ID в браузъра. Наличието на видим вендор за защита не гарантира, че даден метод ще успее.

Ръчен 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.

Кога това е правилната рецепта: защитена цел, при която HTTP може да избере работещ изходен възел, но крайното съдържание изисква JavaScript рендериране.

8. Блокирани на статична страница: променете браузъра, който представяте

Използвайте това, когато статична цел връща страница с блокиране или предизвикателство, а JavaScript не е проблемът. Заявката представя най-новия Google Chrome по подразбиране; някои цели приемат различен браузър или платформа.

Ръчен промпт:

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.

Кога това е правилната рецепта: сървърно рендирана целева страница, която филтрира според клиента, който вижда, а не според изходния адрес. Промяната на представяния браузър не струва нищо допълнително и си струва да се опита преди ротация на proxy.

Съвети, приложими за всички тях

  • Не сте сигурни кой инструмент да изберете? Използвайте foura_auto. Той избира метода и управлява ескалацията вместо вас. Използвайте конкретен инструмент само когато искате изричен контрол.
  • Започнете с foura_single, когато обикновен HTTP е достатъчен. Ескалирайте към foura_proxy, когато директната request е блокирана, и към foura_browser, когато желаното съдържание изисква JavaScript.
  • Браузъроподобните request headers са включени по подразбиране (unblocker). Запазете валидацията на съдържанието активна, за да не се брои страница за отказ като успех, и променете представяния браузър с browser, os или version, когато целевият адрес отхвърля този по подразбиране.
  • Правилата за валидация спестяват повторни опити. Задайте validate.data.fail:["captcha", "blocked"], така че очевидно блокиран response да се отчита като грешка и да задейства повторен опит или ескалация към proxy, вместо да бъде обработен като успех.
  • Обхватът по държава е стриктен. Резултатът no_eligible_proxy не дава разрешение за повторен опит без exitCountries; запазете изискването или попитайте потребителя, преди да го промените.
  • Големите тела са вградени по подразбиране (v0.2.0+). Подайте offload_large: true, за да превключите към resource_link + resources/read на клиенти, които поддържат тези възможности.

Търсите рецепта, която липсва тук?

Изпратете имейл на support@foura.ai с вашия случай на употреба. MCP сървърът предоставя нови prompts със същия ритъм, както версиите на REST API.

Обновено: 28 октомври 2026 г.