export AGENTQL_API_KEY="your-api-key"

AgentQL 技能

AgentQL 允许您使用自然语言查询网页，以提取结构化数据并自动化浏览器交互。它在底层使用 Playwright。

设置

AgentQL 需要一个 API 密钥。将其设置为环境变量：
bash
export AGENTQLAPIKEY=your-api-key

在 https://dev.agentql.com 获取免费 API 密钥

快速入门（Python）

python
import agentql
from playwright.syncapi import syncplaywright

with sync_playwright() as p:
browser = p.chromium.launch(headless=True)
page = agentql.wrap(browser.new_page())

page.goto(https://example.com)

# 使用自然语言查询
response = page.query_data(
{
title
main_heading
description
}
)

print(response)
browser.close()

编写并运行脚本

bash

创建新的脚本模板

agentql new-script scraper.py

运行它

python3 scraper.py

常见模式

提取结构化数据

python response = page.query_data( { products[] { name price rating } } )

与元素交互

python response = page.query_elements( { search_box submit_button } ) response.search_box.fill(query) response.submit_button.click()

无头抓取

python browser = p.chromium.launch(headless=True)

使用现有页面（连接到正在运行的浏览器）

python browser = p.chromium.connectovercdp(http://127.0.0.1:9222) # Brave/Chrome page = agentql.wrap(browser.contexts[0].pages[0])

命令行工具

bash agentql doctor # 检查设置 agentql new-script # 生成模板脚本

注意事项

• - 需要 API 密钥：https://dev.agentql.com（提供免费套餐）
• 通过以下命令运行脚本：python3 script.py
• 可以通过 CDP（端口 9222）连接到正在运行的 Brave 浏览器