agentql

用自然语言查询网页，让 AI 精准操控浏览器

AgentQL 是一套用于将 AI 连接到网页的工具集，核心是提供一种类似 SQL 的查询语言，让开发者能通过自然语言描述网页元素或数据，再结合 Playwright 自动化操作浏览器，实现精准、快速、大规模的网页元素交互和数据提取。它解决了传统网页抓取中依赖脆弱 CSS 选择器或 XPath 的问题，让 AI 代理能更稳定地理解网页结构。项目提供 REST API、Python 和 JavaScript SDK，以及浏览器调试器，方便集成到现有工作流。核心能力包括：基于语义的网页元素定位、结构化数据提取、与 Playwright 的无缝集成、支持云端 API 和本地 SDK 两种模式。适用于构建 AI 代理、网页数据采集、自动化测试等场景。

开源 freemium 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1467

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类自动化工作流

开发团队tinyfish-io

所属国家

官网地址https://agentql.com

GitHubhttps://github.com/tinyfish-io/agentql

定价模式freemium

价格说明提供免费额度，付费解锁更多功能，具体价格需查看官网。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,ai,aiagent,automation,javascript,playwright,python,rpa,scraping,web,web-scraping,web-scraping-colabs,web-scraping-javascript,web-scraping-python,web-scrapping,webagent

GitHub 星标★ 1467

30天Star增速

HF 下载量

上线时间2024-02-20 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-10

浏览次数9

使用教程

难度：入门约 10 分钟部署方式：库/依赖 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 环境（README 节选未注明最低版本，请以官方文档为准）
能访问 PyPI 与 GitHub 的网络环境
如使用云端模式，需要一个 AgentQL 账号（在 agentql.com 注册）
可选：Node.js/JavaScript 环境，用于 JS SDK（README 仅给出 SDK 存在，未给安装命令）

安装与启动步骤

1安装 Python SDK

README 徽章指向 PyPI 上的 agentql 包，可用 pip 安装官方 Python SDK；具体版本以 PyPI 页面为准。
```
pip install agentql
```
2克隆示例仓库

把官方仓库拉到本地，便于查看 README 全文与示例代码；后续步骤请以仓库内文档为准。
```
git clone https://github.com/tinyfish-io/agentql.git
cd agentql
```
3注册并获取密钥

前往官网 agentql.com 注册账号并获取访问凭证；README 节选未给出具体获取流程，以官网为准。
4阅读官方文档

安装与用法细节未包含在本次节选中，请以仓库 README 全文与 agentql.com 文档为唯一依据。

关键配置

配置项	必填	说明	示例
`API Key（具体变量名以官方文档为准）`	否	使用云端 AgentQL API 时需要的访问凭证；本地 SDK 模式是否必需以官方文档为准	`sk-xxxxxxxx`

如何确认成功

本次 README 节选未提供启动验证方式。可执行 pip show agentql 确认包已安装成功。

常见问题

Q：README 节选里没有完整安装步骤怎么办？

A：以 GitHub 仓库 README 全文和 agentql.com 官方文档为准；本教程只整理节选中可确认的信息，未确认的命令一律未写入。

Q：必须要有 API Key 吗？

A：项目支持云端 API 和本地 SDK 两种模式，云端模式需要凭证；是否需要以及如何配置请查阅官方文档。

Q：是否必须安装 Playwright？

A：AgentQL 与 Playwright 无缝集成用于浏览器自动化，但本次节选未给出 Playwright 的安装命令，请按官方文档操作。

Q：支持哪些编程语言？

A：项目提供 REST API、Python SDK 和 JavaScript SDK，可根据技术栈选择。

注意事项

本次 README 节选不完整，缺少安装与配置章节，执行前请先阅读仓库 README 全文。
不要照搬网络上其他教程里的端口、环境变量名或参数，一切以官方文档为准。
AgentQL 官网为 https://agentql.com，遇到问题可查阅官网或加入其 Discord 社区。

核心亮点

基于语义的查询语言，告别脆弱的 CSS 选择器，元素定位更稳定
与 Playwright 深度集成，可直接驱动浏览器自动化操作
提供 Python/JS SDK 和 REST API，多种方式接入，上手快

不足之处

项目较新，文档和社区生态仍在完善中
依赖 Playwright，对非浏览器环境支持有限

适用场景

AI 代理需要自动操作网页完成表单填写、点击等任务
大规模网页数据采集，需要稳定结构提取
网页自动化测试，替代传统选择器提高维护效率

替代项目

Scrapy、Beautiful Soup、Puppeteer

项目介绍

agentql 是自动化工作流领域的开源项目，由 tinyfish-io 开发，2024 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（1,467）位列前 30%，在自动化工作流分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,446 增加到 1,467，净增 21。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。提供免费额度，付费解锁更多功能，具体价格需查看官网。从国内网络环境看，可直接访问。

它主要面向的使用场景是：AI代理需要自动操作网页完成表单填写、点击等任务。同类可对比的替代方案包括 Scrapy、Beautiful Soup、Puppeteer。

上一篇：rpaframework

下一篇：testzeus-hercules