AgentQL

AgentQL

TinyFish · 程式設計

AgentQL 是 TinyFish 推出的查詢語言與解析器,靠語意尋找頁面元素,網站改動 HTML 之後,爬蟲與代理程式依然能正常運作。

AgentQL 的介面預覽

關於 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 繪製的介面、罕見版型,以及防機器人機制兇悍的網站仍可能失手。正式上線時請保留抽查。

開始使用

  1. 在 agentql.com 註冊帳號,到開發者入口複製 API 金鑰。
  2. 用 pip install agentql 或 npm install agentql 安裝 SDK。
  3. 寫一段查詢列出需要的欄位,格式重要時加上 price(integer) 這類型別提示。
  4. 在 Playwright 腳本裡呼叫 query_data 取資料,或呼叫 query_elements 做互動。
  5. 先在 playground 或瀏覽器擴充功能測試,再放大規模執行。

產品資訊

快速了解 AgentQL 的定價、支援平台與效能。

免費方案是
付費方案$0 - $99/mo
平台Web, Python, JavaScript, REST API, Playwright, MCP
開發者TinyFish
類別程式設計
發布日期Feb 2024
最近更新Oct 2026
網站訪問量9K
網站全球排名2.5M
API 提供狀態是

適合對象

這項工具最適合的使用者、任務與情境。

使用者

  • 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 代理。