AgentQL은 무료인가

무료 Starter 플랜이 있고 월 50회 API 호출, 원격 브라우저 10시간, 동시 세션 5개를 준다. Professional은 월 $99에 1만 회 호출과 브라우저 500시간을 포함한다. Enterprise는 프로젝트별 견적이다.

Playwright와 함께 쓸 수 있나

그렇다. Python과 JavaScript SDK가 Playwright 페이지에 쿼리 메서드를 더하고, query_elements 가 돌려준 로케이터는 클릭, 입력, 키 누르기 같은 표준 동작을 받는다.

로그인이 필요한 페이지도 읽나

TinyFish는 공개 페이지와 비공개 페이지, 인증이 필요한 페이지까지 쿼리가 동작한다고 밝힌다. 실제로는 원격 브라우저나 이미 로그인한 Playwright 세션으로 실행한다. REST 엔드포인트는 쿠키를 보관하지 않기 때문이다.

있다. 브라우저 없는 추출용 REST API, Python과 JavaScript SDK, 오픈소스 MCP 서버가 있다. 키 하나로 세 가지를 모두 쓴다.

XPath나 CSS 선택자와 무엇이 다른가

XPath와 CSS는 구조를 겨냥하므로 마크업이 바뀌면 깨진다. AgentQL은 의미를 겨냥한다. 같은 쿼리가 개편을 견디는 일이 많고, 내용은 비슷하지만 HTML이 다른 사이트에도 자주 통한다.

주요 한계는 무엇인가

대량 처리 시 비용, 호스팅 서비스 의존, 특이한 레이아웃에서의 불안정이다. 아주 큰 크롤링은 맞춤 요금제를 검토하는 편이 낫고, 운영 파이프라인은 데이터베이스에 쓰기 전에 출력을 검증해야 한다. 중소 규모 작업이라면 읽기 쉬운 쿼리와 Playwright 제어를 함께 갖춘 대안을 찾기 어렵다.

AgentQL

TinyFish · 코딩

AgentQL은 TinyFish가 만든 쿼리 언어 겸 파서다. 요소를 의미로 찾기 때문에 사이트의 HTML이 바뀌어도 스크래퍼와 에이전트가 계속 돌아간다.

도구 방문

AgentQL 소개

About

AgentQL이란

AgentQL은 AI 웹 스크래핑을 위해 나왔다. AgentQL 쿼리 언어는 파서와 AI 계층을 묶어 웹페이지를 읽고 조작한다. XPath나 CSS 선택자를 쓰는 대신 원하는 필드를 일상어에 가깝게 적는다. 예를 들어 products[] { name price }라고 쓰면 그 모양의 JSON이 돌아온다. AI가 각 요소 주변의 맥락을 읽으므로, 개편으로 마크업이 옮겨져도 쿼리는 데이터를 찾아낸다.

이 제품은 두 가지 일을 맡는다. 데이터를 뽑을 때 query_data가 구조화된 레코드를 반환한다. 조작할 때는 query_elements와 get_by_prompt가 Playwright 로케이터를 넘겨주므로 바로 클릭하고 입력하고 스크롤할 수 있다. TinyFish는 Python과 JavaScript SDK, 브라우저가 필요 없는 REST 엔드포인트, 쿼리를 다듬는 크롬 확장, 에이전트 프레임워크용 MCP 서버를 함께 제공한다.

편의의 대가로 호스팅 서비스에 의존한다. 모든 쿼리는 키를 붙여 AgentQL API를 거치므로 무료 한도를 넘으면 호출마다 과금되고 실행 중에는 네트워크가 필요하다. 캔버스로 그린 화면, 드문 레이아웃, 봇 차단이 센 사이트에서는 여전히 실패할 수 있다. 운영 환경에서는 결과를 표본 검사하는 편이 좋다.

시작하는 방법

agentql.com에서 계정을 만들고 개발자 포털에서 API 키를 복사한다.
pip install agentql 또는 npm install agentql로 SDK를 설치한다.
필요한 필드를 나열한 쿼리를 쓴다. 형식이 중요하면 price(integer) 같은 타입 힌트를 붙인다.
Playwright 스크립트 안에서 추출은 query_data, 조작은 query_elements를 호출한다.
playground나 브라우저 확장에서 먼저 시험한 뒤 규모를 키운다.

제품 정보

AgentQL의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.

무료 플랜예

유료 플랜$0 - $99/mo

플랫폼Web, Python, JavaScript, REST API, Playwright, MCP

개발사TinyFish

카테고리코딩

출시일Feb 2024

최근 업데이트Oct 2026

웹사이트 방문 수9K

웹사이트 글로벌 순위2.5M

API 제공 여부예

주요 기능

의미 기반 선택자

AgentQL은 DOM 위치가 아니라 의미와 주변 맥락으로 요소를 찾는다. product_price라는 필드는 클래스 이름이 바뀌거나 블록이 아래로 내려가도 가격을 집어낸다. 덕분에 A/B 테스트와 느린 레이아웃 변화를 견디고, 다른 팀이 만든 사이트에도 같은 쿼리가 통한다.

쿼리가 곧 출력 스키마

쿼리는 출력 계약 역할을 겸한다. 객체를 중첩하고 목록은 대괄호로 표시하며 price(integer)나 product_price(include currency symbol) 같은 지시로 형식을 정한다. 적은 그대로의 JSON이 돌아오므로 구조화 데이터 추출에 정리 단계가 필요 없다.

Playwright 연동

Python과 JavaScript SDK는 Playwright 페이지를 감싸고 query_data, query_elements, get_by_prompt 메서드를 더한다. 화면 이동, 스크린샷, 파일 업로드에는 브라우저 API를 그대로 쓴다. 쿼리가 돌려준 로케이터는 일반 로케이터처럼 동작하므로 기존 테스트 도구도 살아 있다.

브라우저 없는 REST API

REST 엔드포인트는 브라우저를 띄우지 않고 URL에서 페이지 데이터를 가져온다. Chromium 다운로드가 현실적이지 않은 정기 작업과 서버리스 함수에 맞는다. URL과 쿼리를 보내면 한 번의 요청으로 구조화 결과가 온다.

브라우저 디버거

크롬 확장을 설치하면 어느 페이지에서든 옆 패널이 열린다. 쿼리를 쓰면서 일치한 요소가 바로 표시된다. 선택자를 쓰고 되는지 확인하기까지의 왕복이 짧아지며, 지저분한 페이지일수록 효과가 크다.

MCP 서버

오픈소스 MCP 서버는 Model Context Protocol을 쓰는 어시스턴트와 에이전트 런타임에 AgentQL 추출을 연결한다. npx로 설치하고 키를 넣으면 에이전트가 URL 조회를 도구 호출로 처리한다. 연결 코드는 필요 없다.

장단점

장점

쿼리가 원하는 데이터처럼 읽히므로 선택자에 익숙하지 않은 팀원도 고칠 수 있다.
의미 기반 매칭이 스크래핑 예산의 큰 몫을 차지하는 유지보수를 줄인다.
무료 Starter 플랜에 월 50회 API 호출이 포함돼 결제 전에 사례를 검증할 수 있다.
Playwright 지원으로 추출과 조작을 한 스크립트에서 처리한다.
REST API와 MCP 서버가 브라우저 없는 작업과 에이전트 흐름을 각각 맡는다.

단점

호출마다 과금된다. Starter는 회당 $0.02, Professional은 포함량을 넘으면 회당 $0.015라서 10만 페이지 크롤링은 실제 비용이 된다.
원격 브라우저 시간은 별도로 시간당 $0.12 또는 $0.10이 붙어, 긴 웹 자동화 세션은 겉보기보다 비싸다.
모든 처리가 호스팅 API에 의존한다. 오프라인 모드가 없고 서비스가 멈추면 파이프라인도 멈춘다.
AI 매칭은 결정적이지 않다. 특이한 레이아웃에서는 일부 필드만 오거나 위치가 어긋날 수 있어 운영 작업에는 검증과 재시도가 필요하다.