> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Autom

The Autom connector lets your AI agent act in each user's Autom account. Each user connects their own Autom API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 21 tools.

**Authentication:** API Key
**Categories:** Search, Analytics
**Tools:** 21: 21 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=AUTOM)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Autom connection

   In **AgentKit > Connections**, create an Autom connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'autom'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Autom:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'autom_usage_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "autom"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Autom:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="autom_usage_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Autom credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'autom_bing_search',
  toolInput: {
    query: 'lion',
  },
  connector: 'autom',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="autom_bing_search",
    tool_input={
        "query": "lion",
    },
    connection_name="autom",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `autom_bing_search`

Bing Search · Read-only

Run a Bing web search with market, country or GPS origin options.
Returns organic results with title, link and snippet, plus pagination.
Use autom_search to fall back across engines.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query you want to run on Bing. Example: best project management software 2026.
- `cc` (`string`, optional): Country code to search from (2-letter ISO 3166-1). Cannot be used together with mkt. Example: US.
- `lat` (`number`, optional): GPS latitude for the search origin. Example: 40.7128.
- `location` (`string`, optional): Search origin location (e.g. city). Example: New York, NY.
- `lon` (`number`, optional): GPS longitude for the search origin. Example: -74.0060.
- `mkt` (`string`, optional): Market code where results come from (e.g. en-US). Cannot be used together with cc. Example: en-US.
- `num` (`integer`, optional): Number of results per page (e.g. 10, 20, 50). This value is a suggestion. Example: 10.
- `page` (`integer`, optional): Page number for pagination (1 = first page). Example: 1.

Example input: `{"query":"lion"}`

### `autom_brave_images`

Brave Images · Read-only

Search Brave Images, 50 results per page.
Returns image results with title, source page and image URLs.
Use autom_google_images for Google's image index.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query you want to run on Brave Images. Example: best project management software 2026.
- `gl` (`string`, optional): Country code (e.g. fr, us). Mapped to Brave country. Example: us.
- `hl` (`string`, optional): Language code (e.g. fr, en). Mapped to Brave lang. Example: en.
- `page` (`integer`, optional): Page number for pagination (50 results per page). Example: 1.
- `safe` (`string`, optional): SafeSearch: active | off | moderate | strict. Google-style active maps to Brave strict. Values: active or off. Example: active. One of: `active`, `off`, `moderate`, `strict`.

Example input: `{"query":"lion"}`

### `autom_brave_search`

Brave Search · Read-only

Run a Brave web search.
Returns organic results with title, link and snippet.
Use autom_search to fall back across engines.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query you want to run on Brave Search. Example: best project management software 2026.
- `gl` (`string`, optional): Country code, for example us, fr, gb, de. Example: us.
- `hl` (`string`, optional): Language code, for example en, fr, de. Example: en.
- `page` (`integer`, optional): Page number for pagination. Example: 1.

Example input: `{"query":"lion"}`

### `autom_brave_videos`

Brave Videos · Read-only

Search Brave Videos.
Returns video results with title, link, duration and thumbnail.
Use autom_google_videos for Google's video index.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query you want to run on Brave Videos. Example: best project management software 2026.
- `gl` (`string`, optional): Country code (e.g. fr, us). Mapped to Brave country. Example: us.
- `hl` (`string`, optional): Language code (e.g. fr, en). Mapped to Brave lang. Example: en.
- `page` (`integer`, optional): Page number for pagination. Example: 1.
- `safe` (`string`, optional): SafeSearch: active | off | moderate | strict. Google-style active maps to Brave strict. Values: active or off. Example: active. One of: `active`, `off`, `moderate`, `strict`.

Example input: `{"query":"lion"}`

### `autom_duckduckgo_search`

DuckDuckGo Search · Read-only

Run a DuckDuckGo web search.
Returns organic results with title, link and snippet.
Use autom_search to fall back across engines.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Search query sent to DuckDuckGo Search. Example: best project management software 2026.
- `gl` (`string`, optional): Country code, for example us, fr, gb, de, jp. Example: us.
- `hl` (`string`, optional): Language code, for example en, fr, de, ja, zh. Example: en.
- `page` (`integer`, optional): Page number. Page 1 is the first page of results. Example: 1.

Example input: `{"query":"lion"}`

### `autom_google_autocomplete`

Google Autocomplete · Read-only

Get Google's autocomplete suggestions for a partial query.
Returns the list of suggestions.
Use this for keyword research.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query for which you want to get autocomplete suggestions. Example: project manag.
- `cp` (`integer`, optional): Cursor position in the search query where you want to get autocomplete suggestions. Example: 10.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.

Example input: `{"query":"lion"}`

### `autom_google_countries_find`

Find Google Countries · Read-only

Look up the countries Google supports by code or name.
Returns matching countries with their gl codes.
Use the code as gl in the Google tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Filter countries by a search string (case-insensitive). Returns all countries whose code or name matches the specified query. Example: united.

Example input: `{"query":"lion"}`

### `autom_google_images`

Google Images · Read-only

Search Google Images.
Returns image results with title, source page, image URL, thumbnail and dimensions.
Use autom_brave_images for Brave's image index.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Query you want to search on Google Images (e.g. "lion", "nike logo", "modern house exterior"). Example: modern house exterior.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `page` (`integer`, optional): Page number for pagination (1 = first page). Example: 1.
- `safe` (`string`, optional): Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active. One of: `active`, `off`.

Example input: `{"query":"lion"}`

### `autom_google_jobs`

Google Jobs · Read-only

Search Google Jobs listings.
Returns job listings with title, company, location, posting date and apply links, plus a next_page_token.
Pass next_page_token for the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The job search query to run on Google Jobs (e.g. developer, barista new york). Example: barista new york.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `location` (`string`, optional): Human-readable location to originate the search from (e.g. New York, NY, Paris, France). If several locations match, the most popular one is used. Note: location and uule cannot be used together. Example: New York, NY.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `lrad` (`integer`, optional): Search radius in kilometers. Does not strictly limit the radius, but influences result proximity. Example: 50.
- `ltype` (`integer`, optional): Filter results by work type. Set to 1 to filter for work from home / remote jobs. Example: 1.
- `next_page_token` (`string`, optional): Token to fetch the next page of results. Returned in the serpapi_pagination.next_page_token field of the previous response. Example: eyJmYyI6IkVxRUJDbUZCUVVSbk9WWnFRVWhrIn0.
- `uds` (`string`, optional): Advanced search filters string for Google Jobs (encoded filter chips). Example: ADvngMjcH0KdF7.
- `uule` (`string`, optional): Google encoded location parameter. Use for precise geo targeting. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.

Example input: `{"query":"lion"}`

### `autom_google_languages_find`

Find Google Languages · Read-only

Look up the languages Google supports by name.
Returns matching languages with their hl codes.
Use the code as hl in the Google tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Filter languages by a search string (case-insensitive). Returns all languages whose names contain the specified string. Example: span.

Example input: `{"query":"lion"}`

### `autom_google_locations_find`

Find Google Locations · Read-only

Look up supported search locations (cities, regions, countries) by name.
Returns matching locations ordered by reach, with their canonical names.
Use a name as location in the Google tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Search locations supported by Piloterr (cities, countries, etc.) by providing a query string. Returns matching locations ordered by reach. Example: Paris.

Example input: `{"query":"lion"}`

### `autom_google_maps`

Google Maps · Read-only

Search Google Maps for places and businesses.
Returns places with name, address, rating, reviews count, category, phone, website and coordinates.
Use ll to focus results around a coordinate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Search query for Google Maps (e.g. business type, brand, or place name). Example: coffee shop.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `ll` (`string`, optional): Map center / geo hint in Google format (e.g. @43.5131985,1.4600501,60m). Helps focus results around a coordinate and zoom radius. Example: @40.7128,-74.0060,14z.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `page` (`integer`, optional): Page number for pagination (1 = first page). Example: 1.

Example input: `{"query":"lion"}`

### `autom_google_news`

Google News · Read-only

Search Google News for articles on a topic, company or keyword.
Returns news articles with title, link, source, date and snippet.
Use this for news monitoring.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Query to search on Google News (keywords, company, topic). Example: OpenAI.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `num` (`integer`, optional): Maximum number of results per page (e.g. 10). Example: 10.
- `page` (`integer`, optional): Page number for pagination (1 = first page). Example: 1.

Example input: `{"query":"lion"}`

### `autom_google_search`

Google Search · Read-only

Run a Google web search with location, language, country, time and SafeSearch options.
Returns structured SERP data: organic results, ads, related searches, knowledge panel and other SERP features, plus pagination.
Use autom_google_search_light for cheaper organic-only results, autom_google_search_ai for Google AI Mode answers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query you want to run on Google (supports advanced operators like site:, inurl:, intitle:). Example: best project management software 2026.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `location` (`string`, optional): Human-readable location to originate the search from (e.g. New York, NY, Paris, France). If several locations match, the most popular one is used. Note: location and uule cannot be used together. Example: New York, NY.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `num` (`integer`, optional): Maximum number of results to return per page (deprecated). Example: 10.
- `page` (`integer`, optional): Page number / offset used for pagination. Example: 1.
- `safe` (`string`, optional): Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active. One of: `active`, `off`.
- `tbs` (`string`, optional): Advanced search filters string (e.g. time ranges: qdr:h last hour, qdr:d last day, qdr:w last week, qdr:m last month, qdr:y last year). Example: qdr:w.
- `uule` (`string`, optional): Google encoded location parameter. Use for precise geo targeting. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.

Example input: `{"query":"lion"}`

### `autom_google_search_ai`

Google AI Mode · Read-only

Ask Google AI Mode a question.
Returns the AI-generated answer with its text blocks and cited sources.
Use autom_google_search for classic results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The question or search query you want Google AI Mode to answer (supports advanced operators like site:, inurl:, intitle:). Example: What is the tallest building in Europe?.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `location` (`string`, optional): Human-readable location to originate the search from (e.g. New York, NY, Paris, France). If several locations match, the most popular one is used. Note: location and uule cannot be used together. Example: New York, NY.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `uule` (`string`, optional): Google encoded location parameter. Use for precise geo targeting. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.

Example input: `{"query":"lion"}`

### `autom_google_search_light`

Google Search Light · Read-only

Run a lightweight Google web search.
Returns organic results with title, link and snippet.
Use autom_google_search for full SERP features and pagination.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query you want to run on Google (supports advanced operators like site:, inurl:, intitle:). Example: best project management software 2026.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.

Example input: `{"query":"lion"}`

### `autom_google_shopping`

Google Shopping · Read-only

Search Google Shopping for products.
Returns product results with title, price, merchant, rating and link.
Use this for price and product research.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Query to search on Google Shopping (product name, brand, category). Example: running shoes.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `location` (`string`, optional): Location to localize results (e.g. New York, United States). Generates a UULE parameter automatically. Example: New York, NY.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `page` (`integer`, optional): Page number for pagination (1 = first page). Example: 1.
- `safe` (`string`, optional): Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active. One of: `active`, `off`.
- `uule` (`string`, optional): Encoded location parameter (UULE). Use location instead if you don't have a pre-encoded value. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.

Example input: `{"query":"lion"}`

### `autom_google_videos`

Google Videos · Read-only

Search Google Videos.
Returns video results with title, link, source, duration and thumbnail.
Use autom_brave_videos for Brave's video index.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The search query you want to run on Google Videos. Example: best project management software 2026.
- `cr` (`string`, optional): Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
- `gl` (`string`, optional): Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France). Example: us.
- `google_domain` (`string`, optional): Google domain to use for the search. Defaults to google.com. Example: google.com.
- `hl` (`string`, optional): Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419). Example: en.
- `location` (`string`, optional): Human-readable location to originate the search from. Note: location and uule cannot be used together. Example: New York, NY.
- `lr` (`string`, optional): Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
- `num` (`integer`, optional): Maximum number of results per page (e.g. 10). Example: 10.
- `page` (`integer`, optional): Page number for pagination (1 = first page). The docs list it as required; it defaults to 1 here. Example: 1. Default: `1`.
- `safe` (`string`, optional): Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active. One of: `active`, `off`.
- `uule` (`string`, optional): Google encoded location parameter. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.

Example input: `{"query":"lion"}`

### `autom_search`

Search (Any Engine) · Read-only

Run a web search that tries engines in order (Google, then Brave, Bing, DuckDuckGo, Yahoo and Baidu by default) and returns the first organic results.
Returns page 1 of organic results and which engine answered.
Use this for a resilient general search. Use autom_google_search for pagination and Google-specific features.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Search query. Example: best project management software 2026.
- `engines` (`string`, optional): Engine order. Default auto tries google, brave, bing, duckduckgo, yahoo, then baidu. A comma-separated list is followed as given. ddg and duck mean duckduckgo. Unknown names are ignored. Example: google,brave,bing.
- `gl` (`string`, optional): Country code. Defaults to us when omitted. For example us, fr, gb, de. Example: us.
- `hl` (`string`, optional): Language code. Defaults to en when omitted. For example en, fr, de. Example: en.

Example input: `{"query":"lion"}`

### `autom_usage_get`

Get Usage · Read-only

Get the account's live quota and credit usage.
Returns remaining, total_used, renewal_date, subscription and credits balances, packs, rate limits, and the API key's alias, category, expiry and quotas.
Use this to check balance before large runs. It costs no credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `autom_yahoo_search`

Yahoo Search · Read-only

Run a Yahoo web search.
Returns organic results with title, link and snippet.
Use autom_search to fall back across engines.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Search query sent to Yahoo Search. Example: best project management software 2026.
- `gl` (`string`, optional): Country code, for example us, fr, gb, de, jp. Example: us.
- `hl` (`string`, optional): Language code, for example en, fr, de, ja, zh. Example: en.
- `page` (`integer`, optional): Page number. Page 1 is the first page of results. Example: 1.

Example input: `{"query":"lion"}`

## Related

Other Search connectors ([all 89](/agentkit/connectors/?category=search)):

- [Supadata](/agentkit/connectors/supadata/): Scalekit connector, API key, 21 tools
- [Exa](/agentkit/connectors/exa/): Scalekit connector, API key, 21 tools
- [Brave Search](/agentkit/connectors/brave/): Scalekit connector, API key, 18 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
