agentql-mcpAgentQL

스크립트가 페이지에 모든 요소가 나타날 때까지 충분히 대기하도록 하려면 어떻게 해야 하나요?

AgentQL SDK는 페이지 준비 상태를 확인하기 위한 wait_for_page_ready_state() API를 제공합니다. 이 메서드는 페이지가 준비 상태가 되고 필요한 모든 네트워크 요청이 완료될 때까지 기다립니다. 하지만 메서드가 반환된 후에도 페이지가 준비되지 않은 경우가 있을 수 있습니다. 이는 페이지의 동적 특성 때문일 수 있습니다. 그런 경우에는 page.wait_for_timeout 함수를 사용해 스크립트에 추가 지연을 넣을 수 있습니다. ```js const { wrap } = require("agentql"); const { chromium } = require("playwright"); const QUERY = ` { related_videos[] { video_name video_rating } } `; async function main() { const browser = await chromium.launch({headless: false}); const page = await wrap(await browser.newPage()); await page.goto("https://www.youtube.com/watch?v=1ZvYrAaJOH4"); await page.waitForPageReadyState(); await page.waitForTimeout(5000); const response = await page.queryData(QUERY); console.log(`Related videos: \n${JSON.stringify(response, null, 2)}`); await browser.close(); } main(); ```

Asked by Tunde Balogun · May 12, 2026

AgentQL 스크립트를 작성할 때 웹 페이지가 완전히 로드되었는지 어떻게 확인할 수 있나요?

현재 페이지가 완전히 로드되었는지 프로그래밍적으로 정의하는 것은 불가능합니다—스크립트가 무한 스크롤이나 지연 로딩 이미지 같은 새로운 정보를 페이지에 가져올 수 있기 때문입니다. Playwright API를 사용하여 페이지를 위아래로 스크롤해 더 많은 콘텐츠를 로드할 수 있습니다. ```js const { wrap } = require("agentql"); const { chromium } = require("playwright"); const QUERY = ` { comments[] } `; async function main() { const browser = await chromium.launch({headless: false}); const page = await wrap(await browser.newPage()); await page.goto("https://www.youtube.com/watch?v=1ZvYrAaJOH4"); for (let i = 0; i < 3; i++) { await page.mouse.wheel(delta_x=0, delta_y=1000); await page.waitForPageReadyState(); } await page.mouse.wheel(delta_x=0, delta_y=-3000); const response = await page.queryData(QUERY); console.log(`Video comments: \n${JSON.stringify(response, null, 2)}`); await browser.close(); } main(); ```

Asked by Liam O’Connor · Apr 1, 2026

어떻게 AgentQL이 반환하는 데이터 포맷을指定할 수 있을까요?

AgentQL의 버전 0.4.7부터, query에 컨텍스트를 제공하여 다음의 방법으로 data 포맷을 지정할 수 있습니다: { products[] { price(숫자 값으로만 포맷, 달러 기호를 제외함) name(아마존_ prefix로 포맷) } } 컨텍스트를 제공하여 포맷을 지정하여 data 포맷을 예상하는대로 반환할 수 있습니다.

Asked by Xander de Vries · Mar 13, 2026