# Agentql

AgentQL is a suite of tools designed to connect AI agents to the web, enabling web interaction and structured data extraction through a specialized query language.

- **Category:** ai web scraping
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `AGENTQL`
- **Version:** 20260312_00

## Tools

### Create Remote Browser Session

**Slug:** `AGENTQL_CREATE_REMOTE_BROWSER_SESSION`

Tool to create a remote browser session. Use when you need to run browser automation on remote infrastructure.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `proxy` | object | No | Proxy configuration for the remote browser session. |
| `browser_profile` | string ("light" | "stealth") | No | Browser rendering mode. 'light' provides fast headless browsing. 'stealth' enables anti-detection features for sites that block bots. Defaults to 'light' if not specified. |
| `browser_ua_preset` | string ("windows" | "macos" | "linux") | No | User agent preset to simulate different operating systems. Defaults to 'linux' if not specified. |
| `inactivity_timeout_seconds` | integer | No | Session inactivity timeout in seconds. The session will be automatically terminated after this period of inactivity. Defaults to 300 (5 minutes). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get AgentQL Usage Statistics

**Slug:** `AGENTQL_GET_USAGE`

Retrieves API usage statistics and subscription limits for the AgentQL account. Returns current billing cycle dates, lifetime usage limits, API key usage counts, and total account usage. Useful for monitoring quota consumption and planning usage. No parameters required - uses the authenticated API key from connection settings.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Data

**Slug:** `AGENTQL_QUERY_DATA`

Tool to query structured data as JSON from a web page using an AgentQL query or natural language prompt. Use after defining your query or prompt and a URL or HTML.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | URL of the public web page to query. Provide either 'url' or 'html'. |
| `html` | string | No | Raw HTML content to query. Provide either 'html' or 'url'. |
| `query` | string | No | AgentQL query string. Provide either 'query' or 'prompt'. |
| `params` | object | No | Parameters controlling wait time, scrolling, extraction mode, and screenshot. |
| `prompt` | string | No | Natural language prompt describing data to extract. Provide either 'prompt' or 'query'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |