
關於 AgentQL
About
AgentQL 是什麼
AgentQL 查詢語言把解析器和 AI 層結合,用來讀取並操作網頁。你不必寫 XPath 或 CSS 選擇器,只要用接近日常語言描述想要的欄位,例如 products[] { name price },服務就會回傳同樣形狀的 JSON。AI 會讀取每個元素周遭的脈絡,所以改版把標記搬了位置,查詢照樣找得到資料。
產品涵蓋兩件事。擷取資料時,query_data 回傳結構化紀錄;執行動作時,query_elements 與 get_by_prompt 交出 Playwright 定位器,可以直接點擊、輸入或捲動頁面。TinyFish 提供 Python 與 JavaScript SDK、免開瀏覽器的 REST 端點、用來即時調整查詢的 Chrome 擴充功能,以及給代理框架使用的 MCP 伺服器。
方便的代價是依賴託管服務。每次查詢都帶著你的金鑰走 AgentQL 的 API,免費額度用完後每呼叫一次都計費,執行時也必須連網。以 canvas 繪製的介面、罕見版型,以及防機器人機制兇悍的網站仍可能失手。正式上線時請保留抽查。
開始使用
- 在 agentql.com 註冊帳號,到開發者入口複製 API 金鑰。
- 用
pip install agentql或npm install agentql安裝 SDK。 - 寫一段查詢列出需要的欄位,格式重要時加上
price(integer)這類型別提示。 - 在 Playwright 腳本裡呼叫
query_data取資料,或呼叫query_elements做互動。 - 先在 playground 或瀏覽器擴充功能測試,再放大規模執行。
產品資訊
快速了解 AgentQL 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- Python 與 JavaScript 開發者:SDK 直接放進 Playwright 專案,不必重寫,但前提是熟悉非同步瀏覽器程式碼。
- 沒有專職爬蟲工程師的資料與成長團隊:查詢語句看得懂,結構化資料擷取的門檻就低,不過金鑰管理與結果檢查還是得有人負責。
- AI 代理開發者:MCP 伺服器把擷取包成工具,代理不必自己寫解析器就能取得頁面資料。
任務
- 監看價格與商品目錄:一段查詢就能從版型相近的商店抓下品名、價格與庫存狀態。
- 收集名單與目錄:從列表頁取出公司名稱、地址與聯絡連結,再把 JSON 滙入 CRM。
- 填寫表單與完成結帳:靠描述定位欄位,而不是容易失效的選擇器,表單改樣式時特別有用。
- 餵語言模型乾淨的頁面資料:回傳小型 JSON 而不是原始 HTML,可減少 token 消耗與幻覺。
情境
- 改版讓爬蟲掛掉:重跑同一段查詢並比對輸出,不必到處找新的選擇器。
- 一段查詢套用多個相似網站:從互相競爭的市集抓商品,不必為每個網域寫一份解析器。
- 研究需要登入的頁面:遠端瀏覽器保有已驗證的工作階段,封閉的後台儀表板也進得去。
主要功能
語意選擇器
AgentQL 依意義與周遭脈絡尋找元素,不看它在 DOM 的位置。名為 product_price 的欄位就算 class 改名、區塊往下搬,照樣抓得到價格。查詢因此能耐住 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 端點不必啟動瀏覽器,直接從網址取回頁面資料。適合排程工作與 Serverless 函式,那些環境下載 Chromium 並不實際。送出網址與查詢,一次請求就拿到結構化結果。
瀏覽器除錯工具
Chrome 擴充功能在任何頁面開出側邊面板,你一邊寫查詢,一邊看到符合的元素即時標亮。從寫選擇器到確認能不能用,中間的路縮短了,頁面愈亂愈有感。
MCP 伺服器
開源的 MCP 伺服器把 AgentQL 的擷取能力接進支援 Model Context Protocol 的助理與代理執行環境。用 npx 安裝、填入金鑰,代理就能把網址查詢當成工具呼叫,不必寫串接程式。
優缺點
優點
- 查詢讀起來就是你要的資料,新成員不必精通選擇器也能改。
- 語意比對省下大量維護工作,而維護正是爬蟲預算的主要消耗。
- 免費 Starter 方案每月含 50 次 API 呼叫,夠在付費前驗證一個用例。
- 支援 Playwright,擷取與互動能寫在同一份腳本裡。
- REST API 與 MCP 伺服器分別照顧免瀏覽器的工作與代理流程。
缺點
- 呼叫次數要計費:Starter 每次 $0.02、Professional 超出額度後每次 $0.015,爬十萬頁就是實實在在的開銷。
- 遠端瀏覽器時數另計,每小時 $0.12 或 $0.10,長時間的網頁自動化比表面看來更貴。
- 一切依賴託管 API,沒有離線模式,服務中斷時你的流程也停擺。
- AI 比對不是決定性的:版型怪異時可能只回傳部分欄位或錯位,正式工作必須加上驗證與重試。
常見問題
兩件事:從網頁擷取資料,以及操作瀏覽器。常見用途包括監看價格、收集潛在客戶、填寫表單,以及把乾淨的頁面資料交給 AI 代理。
相關內容
探索與 AgentQL 相關的工具、技能與文章。
AgentQL 替代方案
Base Code
Base44 (Wix) · 程式設計 · 生產力Base Code 是 Base44 推出的共享雲端開發環境。團隊在對話中描述對既有 GitHub 儲存庫的修改,看著預覽確認結果,再以 Pull Request 交回工程團隊。
Google EmbeddingGemma 2
Google DeepMind · 寫作 · 圖片 · 程式設計Google EmbeddingGemma 2 是 7.4 億參數的開源模型,能把文字、程式碼、圖片、音訊與影片畫面轉成同一個 768 維空間裡的向量,在手機與筆電上就能執行。
GitGlow
GitGlow · 程式設計 · 生產力GitGlow 是桌面版 Git 用戶端,把你自己的程式碼與 AI 代理程式的變更集中在同一份審查裡,讓你在交付前看清楚機器上究竟要送出什麼。
