주요 변경 사항
페이지를 가져올 수 없는 호출은 신속하게 실패를 반환해야 합니다. 이제 Auto는 사이트별로 추가 exit 노드 탐색이 효과가 있는지 학습하며, 성공 가능성이 거의 없는 경우 첫 번째 빈 탐색 시점에서 호출을 즉시 종료합니다. 또한 Single, Proxy Finder, Auto는 내부에 공백이 포함된 URL에 대해 명확한 400 응답을 반환하고, Dashboard에서 세션을 취소하면 해당 기기가 즉시 로그아웃되며, MCP 0.8.4는 페이로드 폴더가 정리된 후에도 offload_large가 계속 작동하도록 유지합니다.
새로운 기능
Auto: 추가 exit 탐색이 불필요한 사이트 감지
지난주 Auto는 3번째 이후 요청이 페이지를 반환할 가능성이 거의 없는 사이트에 대해 호출당 브라우저 요청을 3회로 제한하기 시작했습니다. 이제 다음 단계도 학습합니다. 해당 사이트에서 브라우저 3회 요청 후 exit 노드를 탐색해도 최근 결과가 나오지 않은 경우, 호출은 빈 결과를 반환하는 첫 번째 탐색에서 종료됩니다. 이 동작은 이후 24시간 동안 유지되며, 그 후 Auto가 상태를 재확인합니다.
응답에는 상세 원인이 명시됩니다. error는 the browser has not got through to this site로 시작하며, status에는 사이트의 마지막 응답이 포함됩니다. 따라서 재시도 여부를 결정하기 전에 호출이 종료된 이유를 정확히 파악할 수 있습니다.
이 중단 설정은 API key가 아닌 사이트 단위로 적용됩니다. 해당 사이트를 호출하는 모든 사용자에게 적용되므로, Auto는 사용자의 validate 규칙이 아니라 사이트 자체의 응답을 기준으로 이를 판단합니다. 사용자의 엄격한 검증 규칙으로 인해 이 동작이 활성화되지는 않습니다. 또한 exitClass: "premium"를 사용하는 호출에는 프리미엄 exit가 계속 제공됩니다.
Auto의 역할은 유효한 경로를 찾는 것입니다. Auto가 특정 사이트에서 작동하는 세션을 찾으면, 대량 작업 시 Single 또는 Browser에서 해당 세션을 재생하십시오. Smart Fetch (Auto)에서 세션 재생 방법과 Auto 호출이 조기 종료될 수 있는 모든 사례를 확인할 수 있습니다.
URL 내 공백에 대한 명확한 400 처리
크롤러는 페이지에 적힌 그대로 링크를 수집하며, 페이지에는 javascript: void(0)나 문장 전체가 포함된 공유 링크처럼 비정상적인 형태가 존재할 수 있습니다. 이제 공백이나 제어 문자가 포함된 URL을 Single, Proxy Finder 또는 Auto로 전달하면 요청이 FourA를 벗어나기 전에 400 에러를 반환합니다.
invalid URL: it contains a space; encode it as %20 (the URL as sent: "...")
아무것도 가져오지 않으며, 크레딧도 소모되지 않고, 결과는 client_error입니다 (Request Outcomes 참조). Browser는 예외로, 공백을 자체적으로 인코딩하여 페이지를 가져옵니다.
클라이언트 측 해결책은 몇 줄이면 됩니다. 각 링크를 원래 페이지 기준으로 확인하고(resolve), 페이지가 아닌 것은 건너뛰며, 나머지는 인코딩하세요:
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에서 증상과 해결 방법을 나란히 확인할 수 있습니다.
세션을 취소하면 해당 기기에서 즉시 로그아웃됩니다
Settings의 Sessions 탭에 모든 기기의 세션 목록이 표시됩니다. 세션을 선택하고 Revoke Selected를 클릭하면 Sign Out Others를 사용할 때와 마찬가지로 해당 기기들이 Dashboard에서 즉시 로그아웃됩니다. 취소된 기기에서는 다시 로그인해야 Dashboard를 열 수 있습니다.
고객사 사무실에 로그인해 둔 채로 두고 온 노트북에 적합한 기능입니다. 선택한 기기만 로그아웃되며 다른 세션은 그대로 유지됩니다.
MCP 0.8.4는 offload_large가 링크를 계속 반환하도록 유지합니다
offload_large: true를 사용하면 MCP 서버는 50 KB 이상의 response를 디스크에 기록하고 body 대신 클라이언트에 resource_link를 전달합니다. 자체 인스턴스에서는 문서에 명시된 대로 페이로드 디렉터리에서 1시간 이상 된 파일을 정리해야 합니다. 0.8.4에서는 해당 정리 후(또는 시스템이 임시 폴더를 비운 후)에도 서버가 매 쓰기 작업 전에 폴더를 다시 생성하므로 offload_large가 링크를 계속 반환합니다. 파일이 삭제된 페이로드는 Payload not found로 읽힙니다.
이번 릴리스에서는 잠긴 종속 항목도 새로고침하여 공개된 보안 권고를 해결했으며, npm audit는 알려진 취약점이 없다고 보고합니다. 도구, 스키마 및 이들이 보내는 request는 변경되지 않습니다. @fouradata/mcp를 업데이트하거나 이미 0.8.4를 실행 중인 호스팅 서버를 클라이언트에서 지정하십시오. 설정 및 모든 옵션은 MCP Server 문서에 있습니다.
가장 비용이 적게 드는 실패한 호출은 몇 초 만에 완료되어 어느 줄을 수정해야 하는지 알려주는 호출입니다.