Công thức MCP

Chín prompt sẵn sàng để dán mà bạn có thể chạy trong bất kỳ client nào tương thích MCP (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code) sau khi cài đặt FourA MCP server.

Mỗi công thức sử dụng foura_auto (mặc định thông minh) hoặc một hay nhiều công cụ cấp thấp hơn gồm foura_single, foura_proxy, foura_browser cho một tác vụ scraping phổ biến. Hai cách sử dụng:

  1. Gọi prompt tích hợp sẵn - mọi client MCP đều hiển thị các prompt do server cung cấp dưới dạng lệnh gạch chéo hoặc bảng điều khiển /prompts. Chọn prompt, điền các đối số, chạy. MCP server trả về quy trình làm việc theo mẫu; LLM sẽ thực thi nó với các công cụ phù hợp.
  2. Sao chép nội dung bên dưới vào đoạn chat của bạn. Hiệu quả tương đương, nhưng ít tiện khám phá hơn.

MCP server cung cấp sẵn các prompt gốc sau: smart_fetch, scrape_product_page, extract_article, monitor_pricing, check_endpoint_health, bulk_fetch_urls.

Lưu ý về các trang lớn (v0.2.0+): theo mặc định, response body trả về inline trong structuredContent bất kể kích thước - điều này hoạt động trong mọi client MCP bao gồm Claude Desktop. Nếu bạn đang dùng client hỗ trợ MCP resources/read VÀ muốn tiết kiệm token trên các trang lớn, hãy truyền offload_large: true trong lệnh gọi công cụ. Các response >= 50 KB khi đó sẽ được trả về dưới dạng resource_link mà client của bạn tìm nạp theo nhu cầu. Các prompt tích hợp sẵn bên dưới giả định chế độ mặc định (inline).

Mã nguồn mở trên GitHub; trên npm dưới tên @fouradata/mcp.

Smart fetch (tự động): bắt đầu tại đây

Công thức đơn giản nhất: cung cấp một URL cho foura_auto và để nó tự thực hiện các lần thử giới hạn trên các phương thức request khả dụng. Sử dụng công thức này bất cứ khi nào bạn muốn lấy nội dung mà không cần phải tự mình chọn công cụ đầu tiên.

Tích hợp sẵn: smart_fetch(url, must_contain?, extract?)

Prompt thủ công:

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.

Khi nào nên dùng công thức này: lần thử đầu tiên mà FourA nên tự chọn phương thức, đặc biệt khi việc xác thực nội dung có thể phân biệt trang thật với trang từ chối truy cập.

1. Thu thập dữ liệu trang sản phẩm

Dành cho các trang chi tiết sản phẩm thương mại điện tử, bao gồm các trang web dạng single-page-app và các trang có bước kiểm tra bảo vệ.

Tích hợp sẵn: scrape_product_page(url)

Prompt thủ công:

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

Trường hợp phù hợp: agent so sánh giá, công cụ thông báo có hàng trở lại, bảng tính phân tích cạnh tranh.

2. Trích xuất bài viết

Dành cho bài báo, bài đăng blog, tài liệu kỹ thuật, hoặc bất kỳ nội dung nào bạn cần văn bản đọc sạch sẽ mà không có thanh điều hướng, quảng cáo và phần footer gây nhiễu.

Tích hợp sẵn: extract_article(url)

Prompt thủ công:

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

Trường hợp phù hợp để dùng recipe này: tóm tắt nghiên cứu, RSS cho một trang duy nhất, bản tin tổng hợp hàng ngày.

3. Theo dõi giá

Dành cho các trang giá và ưu đãi sản phẩm, có tùy chọn so sánh với mức giá mục tiêu.

Tích hợp sẵn: monitor_pricing(url, target_price?)

Prompt thủ công:

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

Trường hợp phù hợp: agent cảnh báo giảm giá, trình theo dõi giá vé du lịch, công cụ theo dõi giá của đối thủ B2B.

4. Kiểm tra endpoint health

Dành cho uptime probe và xác thực API endpoint.

Tích hợp sẵn: check_endpoint_health(url, expected_text?)

Prompt thủ công:

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}

Trường hợp phù hợp để dùng: hệ thống giám sát uptime bên ngoài, smoke test khi deploy, watchdog giám sát API bên thứ ba.

5. Tải song song danh sách URL

Dành cho các tác vụ hàng loạt khi bạn cần metadata của nhiều URL mà không cần lấy nội dung body.

Tích hợp sẵn: bulk_fetch_urls(urls)

Prompt thủ công:

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.

Thời điểm phù hợp để dùng công thức này: quét khả năng truy cập sitemap, kiểm tra link hỏng, kiểm tra xem "URL nào trong số 50 URL sản phẩm này vẫn còn tồn tại".

6. Chọn và sử dụng lại exit node theo quốc gia

Sử dụng tùy chọn này khi mục tiêu yêu cầu request phải đến từ một trong các quốc gia cụ thể, bao gồm cả các trang JavaScript cần chọn proxy trước khi trình duyệt render.

Prompt thủ công:

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.

Trường hợp phù hợp với công thức này: nội dung theo vùng, thị trường được cấp phép, giá theo khu vực địa lý, hoặc bất kỳ quy trình làm việc nào cần một quốc gia hiển thị mục tiêu đã được xác minh rồi tái sử dụng điểm thoát đã chọn. Giới hạn phạm vi quốc gia được bao gồm từ gói Startup trở lên; trên các gói khác foura_proxy sẽ trả về plan_limit_feature, lỗi này không thể khắc phục bằng cách thử lại.

7. Trang được bảo vệ: ưu tiên proxy, dùng trình duyệt khi cần JavaScript

Sử dụng số lần thử proxy có giới hạn kết hợp xác thực nội dung khi một request trực tiếp trả về trang từ chối. Nếu response đã xác thực thành công nhưng nội dung mong muốn vẫn cần JavaScript, hãy tái sử dụng chính xác proxy ID đó trong trình duyệt. Sự xuất hiện của nhà cung cấp giải pháp bảo vệ không đảm bảo rằng mọi phương pháp đều sẽ thành công.

Prompt thủ công:

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.

Thời điểm phù hợp để áp dụng: mục tiêu được bảo vệ nơi HTTP có thể chọn một exit node hoạt động nhưng nội dung cuối cùng yêu cầu render bằng JavaScript.

8. Bị chặn trên trang tĩnh: thay đổi trình duyệt bạn hiển thị

Sử dụng phương pháp này khi mục tiêu tĩnh trả về trang chặn hoặc trang xác thực challenge và vấn đề không nằm ở JavaScript. Request mặc định sẽ hiển thị Google Chrome mới nhất; một số mục tiêu sẽ chấp nhận trình duyệt hoặc nền tảng khác.

Prompt thủ công:

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.

Khi nào nên dùng giải pháp này: trang đích hiển thị phía máy chủ (server-rendered) lọc theo client thay vì địa chỉ IP thoát. Thay đổi trình duyệt khai báo không tốn thêm chi phí và rất đáng thử trước khi luân chuyển proxy.

Mẹo áp dụng cho tất cả giải pháp

  • Không chắc chắn nên dùng công cụ nào? Hãy dùng foura_auto. Công cụ này tự chọn phương thức và xử lý chuyển cấp cho bạn. Chỉ dùng công cụ cụ thể khi bạn cần kiểm soát rõ ràng.
  • Bắt đầu với foura_single khi HTTP thông thường là đủ. Chuyển cấp lên foura_proxy khi request trực tiếp bị chặn và lên foura_browser khi nội dung cần lấy yêu cầu JavaScript.
  • Header request kiểu trình duyệt được bật mặc định (unblocker). Duy trì xác thực nội dung để trang từ chối không bị tính là thành công, và đổi trình duyệt khai báo bằng browser, os, hoặc version khi trang đích từ chối cấu hình mặc định.
  • Quy tắc xác thực giúp tiết kiệm lượt thử lại. Thiết lập validate.data.fail:["captcha", "blocked"] để response rõ ràng bị chặn được tính là thất bại và kích hoạt thử lại/chuyển cấp proxy, thay vì bị phân tích cú pháp như kết quả thành công.
  • Phạm vi quốc gia là bắt buộc. Kết quả no_eligible_proxy không đồng nghĩa với việc được phép thử lại mà không có exitCountries; hãy giữ nguyên yêu cầu này hoặc hỏi người dùng trước khi thay đổi.
  • Body lớn được trả về dạng inline theo mặc định (v0.2.0+). Truyền offload_large: true để chuyển sang resource_link + resources/read trên các client hỗ trợ những tính năng này.

Cần một giải pháp chưa có ở đây?

Gửi email đến support@foura.ai kèm trường hợp sử dụng của bạn. MCP server sẽ cập nhật prompt mới cùng nhịp với các bản phát hành REST API.

Cập nhật: 28 tháng 10, 2026