agentql

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

开源 🏷️基础免费，高级付费 ✅ 目前可打开自动化工作流 🍴 复刻 178 🐛 待处理 18 👀 关注 19

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1501

维护状态较活跃

是否开源开源

定价模式 🏷️基础免费，高级付费支持限时试用 · 提供免费额度，付费解锁更多功能，具体价格需查看官网。

项目预览

项目数据

分类自动化工作流

开发团队tinyfish-io

官网地址https://agentql.com

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

定价模式🏷️基础免费，高级付费

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

访问状态✅ 目前可打开

是否开源是

开源协议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 星标★ 1501

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

代码更新2026-11-03

仓库体积1.3 MB

本站数据更新2026-11-10

维护状态较活跃

收录时间2026-08-10

浏览次数10

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 1501

技术标签

agent ai aiagent automation javascript

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 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`