주요 변경 사항
이제 하나의 Auto 호출이 Dashboard에서 하나의 request로 표시됩니다. 내부적으로 실행된 Single, Proxy Finder, Browser 시도들은 호출 하위에 이름별로 그대로 나열되지만, 성공률과 latency는 요청한 작업을 기준으로 측정됩니다. 플랜 한도 초과로 인한 거부는 더 이상 트래픽으로 집계되지 않으며, Auto는 이를 rate limit으로 표시하고, Billing 페이지에서는 모든 충전 내역이 개별 항목으로 구분됩니다.
새로운 기능
Auto 호출의 단일 request 집계
이전에는 Auto 호출 시 내부 시도들이 Dashboard에 그대로 표시되어, 하나의 링크 요청이 여러 개의 request(일부 실패 포함)로 보일 수 있었습니다. 이제 Overview, Usage & Limits, Activity에서 Auto를 별도의 독립 제품으로 처리합니다. 각 호출은 단일 판정 결과와 함께 하나의 행으로 표시되며, 하위에 이름별로 나열된 내부 시도들의 크레딧과 바이트를 포함합니다. 엔진이 실제로 실행하는 request는 개별 시도이므로, rate limit은 기존과 같이 내부 시도 횟수를 기준으로 계산됩니다.
호출 직후 Activity를 열면 해당 행에 내부 시도가 처리 중으로 표시됩니다. 몇 초 후 페이지 새로고침 없이 시도 목록, 크레딧, 바이트가 제자리에 채워지므로 확인 중인 행의 위치가 바뀌지 않습니다.
이는 Auto의 본래 사용 목적과 일치합니다. Auto는 경로 탐색 도구입니다. 작동하는 단계를 찾도록 한 다음, 반환된 session를 /api/single 또는 /api/browser에서 재실행하여 해당 경로로 트래픽을 집중시키면 됩니다. 이제 Activity에서 특정 경로를 확정하기 전에 각 호출이 시도한 내용을 확인할 수 있습니다.
플랜 한도 초과 거부: 트래픽 미집계 및 Auto 명시
사용자 플랜의 한도 도달로 인해 거부된 request는 더 이상 전체 트래픽에 합산되지 않습니다. 데이터를 가져오지 않았으므로 집계되지 않습니다. 사이트에서 반환한 403이나 500 응답은 해당 응답을 사용자에게 전달했으므로 계속 트래픽으로 계산됩니다.
Auto 호출이 이러한 한도에 걸리면 Activity에는 실패 대신 Rate Limited로 표시되며, response에는 직접 호출과 동일한 X-FourA-Limit 헤더가 포함됩니다.
import requests
r = requests.post(
"https://api.foura.ai/api/auto",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
limit = r.headers.get("X-FourA-Limit")
if limit:
print("stopped by my plan:", limit)
else:
session = r.json().get("session") # replay on /api/single or /api/browser
실제 발생한 결과를 더 명확하게 안내합니다. 호스트 이름이 확인되지 않는 타깃은 Single, Browser, Proxy Finder, Auto에서 접근 불가능한 사이트와 동일하게 반환됩니다. 즉 status 0, 호스트를 명시하는 에러, 타깃 결과(application_fail, outcomes 참조)를 제공합니다. 사설 네트워크 타깃은 기존과 같이 400 거부 응답을 받습니다.
단일 단위로 통일된 트래픽
모든 허용량과 카운터에서 1기가바이트를 1,073,741,824바이트로 명확히 정의합니다. API 트래픽은 디코딩된 페이지를 기준으로 집계됩니다. 실제 브라우저가 사용되었든 페이지에서 요구한 추가 단계가 있었든, 해당 페이지가 사용자에게 전달되는 결과물이기 때문입니다. Proxy 포트 트래픽은 터널을 통과할 때 집계되며, 이 과정에서 연결만 중계할 뿐 내부 데이터는 수정하지 않습니다. Dashboard의 트래픽 수치 옆에서 이 정의를 확인할 수 있으며, How Your Plan Is Metered에서 전체 측정 방식을 다룹니다.
기가바이트 한도가 적용된 모든 곳에서 트래픽 수치가 기가바이트 단위로 표시되므로, 사용량과 한도를 직접 비교할 수 있습니다. Limits 페이지에는 Traffic 패널(전체, API, proxy 포트, 프리미엄 트래픽을 표시하며, 플랜에 한도가 있는 경우 각각 프로그레스 바 제공)이 추가되었고, API 키 테이블에는 Traffic 및 Premium 컬럼이 추가되었으며, Overview의 각 제품 패널에는 해당 제품의 트래픽이 표시됩니다.
또한 도달한 한도는 다음 request가 거부되므로 빨간색 At limit으로 표시됩니다. API 키 수와 같은 개수 한도에 도달한 경우에는 황색으로 표시되며, 다음 추가 작업만 제한됩니다.
결제: 4개의 카드와 충전 항목별 라인
Billing 페이지는 모든 플랜에서 동일한 4개의 카드를 표시합니다. 플랜의 과금 기준에 따라 크레딧 또는 기본 트래픽이 먼저 표시되고, 이어 다른 지표, Premium, Proxy 포트가 표시됩니다. 각 카드에는 Buy 버튼이 있습니다. 플랜에서 해당 항목을 제공하지 않는 경우 버튼에 안내 문구가 표시되며 문의 링크가 제공됩니다.
크레딧 기반 유료 플랜의 경우 proxy 포트에 별도의 포함 기가바이트가 제공되며, 해당 카드에서 추가 구매할 수 있습니다. 각 충전 내역은 구매 항목, 사용량, 잔여량을 개별 라인으로 표시합니다. 사용량은 만료일이 가장 빠른 충전분부터 차감됩니다.
사용량 알림 이메일도 더 자세한 정보를 제공합니다. 95% 도달 시 이번 주기 사용 속도를 기준으로 한 허용량 소진 예상일과 리셋 날짜, 그리고 한도를 늘리는 방법을 안내합니다. 100% 도달 알림 이메일에는 리셋까지 남은 일수와 초과 사용(overage) 지원 플랜의 초과 과금 단가가 표시됩니다.
MCP 0.7.3
FourA MCP 0.7.3은 JSON Schema draft-07과 2020-12를 모두 지원하는 툴 스키마를 제공하므로, 엄격한 2020-12 검증기를 사용하는 클라이언트도 4개 툴을 모두 조회하고 호출할 수 있습니다. 호출 시 허용되는 인자는 변경되지 않았습니다. @fouradata/mcp를 업데이트하거나, 이미 0.7.3이 적용된 호스팅 서버를 사용하십시오.
문서 및 사이트
- docs 검색에서 결과를 선택하면 단어가 처음 나타나는 위치로 페이지가 스크롤되고 하이라이트 처리됩니다. 결과가 표시되는 즉시 최상단 결과가 선택되므로 Enter 키로 바로 열 수 있습니다.
- 모바일과 태블릿 환경에서는 손가락을 떼는 순간 메인 사이트 메뉴가 열려 화면을 2단 컬럼으로 채우며, 모든 페이지는 첫 번째 프레임부터 스타일이 온전히 적용된 상태로 렌더링됩니다.
내부 동작 원리
새로 추가되는 Proxy Finder 용량은 기존 용량이 각 호스트에 대해 이미 학습한 정보를 반영하여 시작됩니다. 따라서 트래픽에 투입된 초기 몇 분 동안 안정화 과정을 거치지 않고, 합류하는 즉시 일정한 response time을 유지합니다.
Dashboard에 표시되는 숫자는 실행한 작업의 구체적인 결과로 이어져야 합니다. 그 수치의 원인을 파악하기 위해 계산기를 두드리고 문서를 찾아봐야 한다면, 수치를 수정하는 것은 FourA의 몫이지 사용자가 해석할 일이 아닙니다.