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.
- Tools
- 21
- What they doRead · write · destructive
- 21 · 0 · 021 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Autom connection
In AgentKit > Connections, create an Autom connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'autom'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'autom_usage_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "autom"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="autom_usage_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Autom credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolautom_bing_searchRun a Bing web search with market, country or GPS origin options.Read-onlyBing Search
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.
Inputs
querystringrequired- The search query you want to run on Bing. Example: best project management software 2026.
ccstring- Country code to search from (2-letter ISO 3166-1). Cannot be used together with mkt. Example: US.
latnumber- GPS latitude for the search origin. Example: 40.7128.
locationstring- Search origin location (e.g. city). Example: New York, NY.
lonnumber- GPS longitude for the search origin. Example: -74.0060.
mktstring- Market code where results come from (e.g. en-US). Cannot be used together with cc. Example: en-US.
numinteger- Number of results per page (e.g. 10, 20, 50). This value is a suggestion. Example: 10.
pageinteger- Page number for pagination (1 = first page). Example: 1.
autom_brave_imagesSearch Brave Images, 50 results per page.Read-onlyBrave Images
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.
Inputs
querystringrequired- The search query you want to run on Brave Images. Example: best project management software 2026.
glstring- Country code (e.g. fr, us). Mapped to Brave country. Example: us.
hlstring- Language code (e.g. fr, en). Mapped to Brave lang. Example: en.
pageinteger- Page number for pagination (50 results per page). Example: 1.
safestring- SafeSearch: active | off | moderate | strict. Google-style active maps to Brave strict. Values: active or off. Example: active.one of
activeoffmoderatestrict
autom_brave_searchRun a Brave web search.Read-onlyBrave Search
Run a Brave web search. Returns organic results with title, link and snippet. Use autom_search to fall back across engines.
Inputs
querystringrequired- The search query you want to run on Brave Search. Example: best project management software 2026.
glstring- Country code, for example us, fr, gb, de. Example: us.
hlstring- Language code, for example en, fr, de. Example: en.
pageinteger- Page number for pagination. Example: 1.
autom_brave_videosSearch Brave Videos.Read-onlyBrave Videos
Search Brave Videos. Returns video results with title, link, duration and thumbnail. Use autom_google_videos for Google's video index.
Inputs
querystringrequired- The search query you want to run on Brave Videos. Example: best project management software 2026.
glstring- Country code (e.g. fr, us). Mapped to Brave country. Example: us.
hlstring- Language code (e.g. fr, en). Mapped to Brave lang. Example: en.
pageinteger- Page number for pagination. Example: 1.
safestring- SafeSearch: active | off | moderate | strict. Google-style active maps to Brave strict. Values: active or off. Example: active.one of
activeoffmoderatestrict
autom_duckduckgo_searchRun a DuckDuckGo web search.Read-onlyDuckDuckGo Search
Run a DuckDuckGo web search. Returns organic results with title, link and snippet. Use autom_search to fall back across engines.
Inputs
querystringrequired- Search query sent to DuckDuckGo Search. Example: best project management software 2026.
glstring- Country code, for example us, fr, gb, de, jp. Example: us.
hlstring- Language code, for example en, fr, de, ja, zh. Example: en.
pageinteger- Page number. Page 1 is the first page of results. Example: 1.
autom_google_autocompleteGet Google's autocomplete suggestions for a partial query.Read-onlyGoogle Autocomplete
Get Google's autocomplete suggestions for a partial query. Returns the list of suggestions. Use this for keyword research.
Inputs
querystringrequired- The search query for which you want to get autocomplete suggestions. Example: project manag.
cpinteger- Cursor position in the search query where you want to get autocomplete suggestions. Example: 10.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
autom_google_countries_findLook up the countries Google supports by code or name.Read-onlyFind Google Countries
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.
Inputs
querystringrequired- Filter countries by a search string (case-insensitive). Returns all countries whose code or name matches the specified query. Example: united.
autom_google_imagesSearch Google Images.Read-onlyGoogle Images
Search Google Images. Returns image results with title, source page, image URL, thumbnail and dimensions. Use autom_brave_images for Brave's image index.
Inputs
querystringrequired- Query you want to search on Google Images (e.g. "lion", "nike logo", "modern house exterior"). Example: modern house exterior.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
pageinteger- Page number for pagination (1 = first page). Example: 1.
safestring- Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active.one of
activeoff
autom_google_jobsSearch Google Jobs listings.Read-onlyGoogle Jobs
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.
Inputs
querystringrequired- The job search query to run on Google Jobs (e.g. developer, barista new york). Example: barista new york.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
locationstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
lradinteger- Search radius in kilometers. Does not strictly limit the radius, but influences result proximity. Example: 50.
ltypeinteger- Filter results by work type. Set to 1 to filter for work from home / remote jobs. Example: 1.
next_page_tokenstring- Token to fetch the next page of results. Returned in the serpapi_pagination.next_page_token field of the previous response. Example: eyJmYyI6IkVxRUJDbUZCUVVSbk9WWnFRVWhrIn0.
udsstring- Advanced search filters string for Google Jobs (encoded filter chips). Example: ADvngMjcH0KdF7.
uulestring- Google encoded location parameter. Use for precise geo targeting. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.
autom_google_languages_findLook up the languages Google supports by name.Read-onlyFind Google Languages
Look up the languages Google supports by name. Returns matching languages with their hl codes. Use the code as hl in the Google tools.
Inputs
querystringrequired- Filter languages by a search string (case-insensitive). Returns all languages whose names contain the specified string. Example: span.
autom_google_locations_findLook up supported search locations (cities, regions, countries) by name.Read-onlyFind Google Locations
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.
Inputs
querystringrequired- Search locations supported by Piloterr (cities, countries, etc.) by providing a query string. Returns matching locations ordered by reach. Example: Paris.
autom_google_mapsSearch Google Maps for places and businesses.Read-onlyGoogle Maps
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.
Inputs
querystringrequired- Search query for Google Maps (e.g. business type, brand, or place name). Example: coffee shop.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
llstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
pageinteger- Page number for pagination (1 = first page). Example: 1.
autom_google_newsSearch Google News for articles on a topic, company or keyword.Read-onlyGoogle News
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.
Inputs
querystringrequired- Query to search on Google News (keywords, company, topic). Example: OpenAI.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
numinteger- Maximum number of results per page (e.g. 10). Example: 10.
pageinteger- Page number for pagination (1 = first page). Example: 1.
autom_google_searchRun a Google web search with location, language, country, time and SafeSearch options.Read-onlyGoogle Search
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.
Inputs
querystringrequired- The search query you want to run on Google (supports advanced operators like site:, inurl:, intitle:). Example: best project management software 2026.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
locationstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
numinteger- Maximum number of results to return per page (deprecated). Example: 10.
pageinteger- Page number / offset used for pagination. Example: 1.
safestring- Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active.one of
activeoff tbsstring- 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.
uulestring- Google encoded location parameter. Use for precise geo targeting. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.
autom_google_search_aiAsk Google AI Mode a question.Read-onlyGoogle AI Mode
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.
Inputs
querystringrequired- 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?.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
locationstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
uulestring- Google encoded location parameter. Use for precise geo targeting. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.
autom_google_search_lightRun a lightweight Google web search.Read-onlyGoogle Search Light
Run a lightweight Google web search. Returns organic results with title, link and snippet. Use autom_google_search for full SERP features and pagination.
Inputs
querystringrequired- The search query you want to run on Google (supports advanced operators like site:, inurl:, intitle:). Example: best project management software 2026.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
autom_google_shoppingSearch Google Shopping for products.Read-onlyGoogle Shopping
Search Google Shopping for products. Returns product results with title, price, merchant, rating and link. Use this for price and product research.
Inputs
querystringrequired- Query to search on Google Shopping (product name, brand, category). Example: running shoes.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
locationstring- Location to localize results (e.g. New York, United States). Generates a UULE parameter automatically. Example: New York, NY.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
pageinteger- Page number for pagination (1 = first page). Example: 1.
safestring- Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active.one of
activeoff uulestring- Encoded location parameter (UULE). Use location instead if you don't have a pre-encoded value. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.
autom_google_videosSearch Google Videos.Read-onlyGoogle Videos
Search Google Videos. Returns video results with title, link, source, duration and thumbnail. Use autom_brave_videos for Brave's video index.
Inputs
querystringrequired- The search query you want to run on Google Videos. Example: best project management software 2026.
crstring- Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE). Example: countryUS.
glstring- 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_domainstring- Google domain to use for the search. Defaults to google.com. Example: google.com.
hlstring- 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.
locationstring- Human-readable location to originate the search from. Note: location and uule cannot be used together. Example: New York, NY.
lrstring- Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de). Example: lang_en.
numinteger- Maximum number of results per page (e.g. 10). Example: 10.
pageinteger- Page number for pagination (1 = first page). The docs list it as required; it defaults to 1 here. Example: 1.default
1 safestring- Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default. Values: active or off. Example: active.one of
activeoff uulestring- Google encoded location parameter. Note: uule and location cannot be used together. Example: w+CAIQICINVW5pdGVkIFN0YXRlcw.
autom_searchRun a web search that tries engines in order (Google, then Brave, Bing, DuckDuckGo, Yahoo and Baidu by default) and returns the first organic results.Read-onlySearch (Any Engine)
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.
Inputs
querystringrequired- Search query. Example: best project management software 2026.
enginesstring- 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.
glstring- Country code. Defaults to us when omitted. For example us, fr, gb, de. Example: us.
hlstring- Language code. Defaults to en when omitted. For example en, fr, de. Example: en.
autom_usage_getGet the account's live quota and credit usage.Read-onlyGet Usage
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.
Inputs
This tool takes no inputs.
autom_yahoo_searchRun a Yahoo web search.Read-onlyYahoo Search
Run a Yahoo web search. Returns organic results with title, link and snippet. Use autom_search to fall back across engines.
Inputs
querystringrequired- Search query sent to Yahoo Search. Example: best project management software 2026.
glstring- Country code, for example us, fr, gb, de, jp. Example: us.
hlstring- Language code, for example en, fr, de, ja, zh. Example: en.
pageinteger- Page number. Page 1 is the first page of results. Example: 1.
No tools match.