Điểm nổi bật
Một lệnh gọi không thể tải được trang cần phản hồi nhanh chóng. Hiện tại Auto tự học theo từng trang web để biết liệu việc tìm kiếm thêm exit có mang lại kết quả hay không. Tại những trang gần như không bao giờ thành công, lệnh gọi sẽ kết thúc ngay ở lần tìm kiếm rỗng đầu tiên. Single, Proxy Finder và Auto cũng trả về mã 400 rõ ràng đối với URL chứa khoảng trắng, việc thu hồi session trong Dashboard sẽ đăng xuất thiết bị đó ngay lập tức, và MCP 0.8.4 giữ cho offload_large tiếp tục hoạt động sau khi thư mục payload bị xóa.
Có gì mới
Auto nhận biết trường hợp thêm exit không còn hiệu quả
Tuần trước Auto đã bắt đầu giới hạn ở mức ba browser request cho mỗi lệnh gọi trên các trang mà những lần thử sau lần thứ ba hầu như không bao giờ tải lại được trang. Giờ đây hệ thống học tiếp bước tiếp theo. Nếu việc tìm kiếm exit sau ba lượt browser đó gần đây cũng không mang lại kết quả trên trang web đó, lệnh gọi sẽ dừng ngay ở lần tìm kiếm đầu tiên trả về rỗng. Quy tắc này có hiệu lực trong 24 giờ tiếp theo, sau đó Auto sẽ kiểm tra lại.
Phản hồi nêu rõ điều gì đã xảy ra: error bắt đầu bằng the browser has not got through to this site, và status lưu phản hồi cuối cùng của trang web. Nhờ đó bạn biết lý do lệnh gọi kết thúc trước khi quyết định có thử lại hay không.
Điểm dừng được thiết lập theo từng trang web, không phải theo từng API key. Vì quy tắc này áp dụng cho mọi người gọi đến trang web đó, Auto đánh giá dựa trên chính phản hồi của trang web chứ không dựa trên quy tắc validate của bạn (quy tắc nghiêm ngặt của bạn không thể kích hoạt trạng thái này). Và một lệnh gọi có exitClass: "premium" vẫn nhận được các exit premium.
Nhiệm vụ của Auto là tìm ra tuyến đường. Khi hệ thống cung cấp cho bạn một session hoạt động tốt trên một trang web, hãy phát lại session đó trên Single hoặc Browser để xử lý lưu lượng lớn. Smart Fetch (Auto) hướng dẫn cách phát lại và liệt kê mọi trường hợp lệnh gọi Auto có thể kết thúc sớm.
Phản hồi 400 rõ ràng khi URL chứa khoảng trắng
Trình thu thập dữ liệu lấy liên kết chính xác như cách trang web ghi, và các trang web thường ghi những giá trị bất thường: javascript: void(0), một liên kết chia sẻ chứa cả một câu văn. Khi gửi đến Single, Proxy Finder hoặc Auto một URL chứa khoảng trắng hoặc ký tự điều khiển, hiện tại bạn sẽ nhận được 400 trước khi request rời khỏi FourA:
invalid URL: it contains a space; encode it as %20 (the URL as sent: "...")
Không có dữ liệu nào được fetch, không tốn credit, và kết quả trả về là client_error (xem Request Outcomes). Trình duyệt là ngoại lệ: nó tự encode khoảng trắng và fetch trang.
Cách xử lý phía bạn chỉ mất vài dòng code. Phân giải từng link dựa trên trang nguồn của nó, bỏ qua các link không phải là trang, và encode phần còn lại:
from urllib.parse import urljoin, quote
import requests
SKIP = ("javascript:", "mailto:", "tel:")
def to_fetch(page_url, href):
href = href.strip()
if href.lower().startswith(SKIP):
return None
# %20 for a space; an already-encoded link stays as it is
return quote(urljoin(page_url, href), safe=":/?#[]@!$&'()*+,;=%")
url = to_fetch("https://example.com/shop/", "/items/blue shoes?size=42")
# -> https://example.com/items/blue%20shoes?size=42
r = requests.post(
"https://api.foura.ai/api/single",
headers={"X-API-Key": "pk_live_..."},
json={"url": url},
).json()
Common Issues trình bày trực quan các triệu chứng cùng giải pháp xử lý tương ứng.
Thu hồi phiên đăng xuất thiết bị ngay lập tức
Mục Settings có tab Sessions liệt kê toàn bộ phiên đăng nhập trên các thiết bị của bạn. Chọn phiên tại đó, nhấp vào Revoke Selected, và những thiết bị này sẽ bị đăng xuất khỏi Dashboard ngay lập tức, tương tự như Sign Out Others. Thiết bị bị thu hồi quyền phải đăng nhập lại mới có thể truy cập vào Dashboard của bạn.
Đây là tính năng dành cho chiếc laptop bạn lỡ để đăng nhập tại văn phòng khách hàng. Một thiết bị bị đăng xuất, trong khi tất cả các phiên khác của bạn vẫn được giữ nguyên.
MCP 0.8.4 giữ cho offload_large tiếp tục trả về liên kết
Với offload_large: true, MCP server sẽ ghi response từ 50 KB trở lên vào đĩa và trả về cho client của bạn một resource_link thay cho phần body. Trên instance tự lưu trữ, tài liệu yêu cầu bạn xóa các tệp cũ hơn một giờ khỏi thư mục payload. Trong 0.8.4, offload_large vẫn tiếp tục trả về liên kết sau quá trình dọn dẹp đó (hoặc sau khi hệ thống làm trống thư mục temp), vì server sẽ tạo lại thư mục trước mỗi lần ghi. Payload có các tệp đã bị xóa sẽ hiển thị là Payload not found.
Bản phát hành này cũng cập nhật các dependency bị khóa, giải quyết các cảnh báo bảo mật đã công bố, và npm audit báo cáo không có lỗ hổng bảo mật nào được phát hiện. Các tool, schema của chúng và request gửi đi đều không thay đổi. Hãy cập nhật @fouradata/mcp, hoặc trỏ client của bạn tới hosted server, nơi đã chạy phiên bản 0.8.4. Hướng dẫn thiết lập và tất cả tùy chọn đều có trong tài liệu MCP Server.
Lần gọi thất bại ít tốn kém nhất là lần kết thúc trong vài giây và chỉ rõ cho bạn cần sửa dòng code nào.