cloro is an MCP server published by dev.cloro, hosted at mcp.cloro.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including scrape_chatgpt, scrape_gemini, scrape_bing_aimode, scrape_google_ai_mode, scrape_google.
Scrape AI answer engines, Google Search/News and Bing Search with country and state geo-targeting.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Submit a prompt to ChatGPT from a chosen country (and optionally US state) and return the full answer: text, cited sources, and optionally markdown, search queries, shopping results, and ads. Use this to see how ChatGPT answers a prompt and which brands/sources it mentions. Costs 7 credits (5 base + 2 sync surcharge); any of include.rawResponse, searchQueries, ads or shopping adds 2 once; include.productDetails adds 2 more; each prompt after the first adds 1; a state adds 2.
| Parameter | Type | Description |
|---|---|---|
| state | string | Optional state code for state-level targeting (e.g. "CA" when country is "US"). Only some countries support this — call list_states for the supported countries and their codes. |
| legacy | boolean | Serve ChatGPT's desktop UI instead of the default mobile-web UI. Defaults to false. |
| prompt * | any | The prompt to submit to ChatGPT, or an array of up to 5 prompts asked in order as follow-ups in the same conversation (1 extra credit per prompt after the first). An array returns an array of results, one per prompt. |
| country * | string | ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. "US"). Use list_countries to see supported codes per model. |
| include | object | Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (the answer page HTML), rawResponse (the engine's unprocessed response payload), searchQueries (the web searches ChatGPT issued while answering), ads and shopping (sponsored and product r… |
| disableWebSearch | boolean | Stop cloro from forcing web search, to get the answer ChatGPT gives on its own. ChatGPT then searches only when it decides to, so expect empty sources, citationPills and searchQueries. Defaults to false (web search forced). Same cost. |
{
"name": "scrape_chatgpt",
"title": "Scrape ChatGPT",
"description": "Submit a prompt to ChatGPT from a chosen country (and optionally US state) and return the full answer: text, cited sources, and optionally markdown, search queries, shopping results, and ads. Use this to see how ChatGPT answers a prompt and which brands/sources it mentions. Costs 7 credits (5 base + 2 sync surcharge); any of include.rawResponse, searchQueries, ads or shopping adds 2 once; include.productDetails adds 2 more; each prompt after the first adds 1; a state adds 2.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt",
"country"
],
"properties": {
"state": {
"type": "string",
"description": "Optional state code for state-level targeting (e.g. \"CA\" when country is \"US\"). Only some countries support this — call list_states for the supported countries and their codes."
},
"legacy": {
"type": "boolean",
"description": "Serve ChatGPT's desktop UI instead of the default mobile-web UI. Defaults to false."
},
"prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 10000,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 10000,
"minLength": 1
},
"maxItems": 5,
"minItems": 1
}
],
"description": "The prompt to submit to ChatGPT, or an array of up to 5 prompts asked in order as follow-ups in the same conversation (1 extra credit per prompt after the first). An array returns an array of results, one per prompt."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. \"US\"). Use list_countries to see supported codes per model."
},
"include": {
"type": "object",
"properties": {
"ads": {
"type": "boolean"
},
"html": {
"type": "boolean"
},
"markdown": {
"type": "boolean"
},
"shopping": {
"type": "boolean"
},
"rawResponse": {
"type": "boolean"
},
"searchQueries": {
"type": "boolean"
},
"productDetails": {
"type": "boolean"
}
},
"description": "Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (the answer page HTML), rawResponse (the engine's unprocessed response payload), searchQueries (the web searches ChatGPT issued while answering), ads and shopping (sponsored and product results; ChatGPT tends to serve ads on follow-up prompts, so pass prompt as an array to see them), productDetails (the What to know summary and reviews of each product; needs shopping, and has no effect without it). Leave unset for the leanest response."
},
"disableWebSearch": {
"type": "boolean",
"description": "Stop cloro from forcing web search, to get the answer ChatGPT gives on its own. ChatGPT then searches only when it decides to, so expect empty sources, citationPills and searchQueries. Defaults to false (web search forced). Same cost."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Submit a prompt to Google Gemini from a chosen country (and optionally US state) and return the answer with cited sources. Use this to see how Google Gemini answers a prompt and which brands/sources it mentions. Costs 6 credits (4 base + 2 sync surcharge); a state adds 2.
| Parameter | Type | Description |
|---|---|---|
| state | string | Optional state code for state-level targeting (e.g. "CA" when country is "US"). Only some countries support this — call list_states for the supported countries and their codes. |
| prompt * | string | The prompt to submit to Google Gemini. |
| country * | string | ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. "US"). Use list_countries to see supported codes per model. |
| include | object | Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (the answer page HTML), rawResponse (the engine's unprocessed response payload). Leave unset for the leanest response. |
{
"name": "scrape_gemini",
"title": "Scrape Google Gemini",
"description": "Submit a prompt to Google Gemini from a chosen country (and optionally US state) and return the answer with cited sources. Use this to see how Google Gemini answers a prompt and which brands/sources it mentions. Costs 6 credits (4 base + 2 sync surcharge); a state adds 2.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt",
"country"
],
"properties": {
"state": {
"type": "string",
"description": "Optional state code for state-level targeting (e.g. \"CA\" when country is \"US\"). Only some countries support this — call list_states for the supported countries and their codes."
},
"prompt": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"description": "The prompt to submit to Google Gemini."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. \"US\"). Use list_countries to see supported codes per model."
},
"include": {
"type": "object",
"properties": {
"html": {
"type": "boolean"
},
"markdown": {
"type": "boolean"
},
"rawResponse": {
"type": "boolean"
}
},
"description": "Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (the answer page HTML), rawResponse (the engine's unprocessed response payload). Leave unset for the leanest response."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Submit a prompt to Bing AI Mode from a chosen country (and optionally US state) and return the answer text, cited sources and inline citation pills. Use this to see how Bing AI Mode answers a prompt and which brands/sources it mentions. Costs 6 credits (4 base + 2 sync surcharge); a state adds 2.
| Parameter | Type | Description |
|---|---|---|
| state | string | Optional state code for state-level targeting (e.g. "CA" when country is "US"). Only some countries support this — call list_states for the supported countries and their codes. |
| prompt * | string | The prompt to submit to Bing AI Mode. The maximum is 3,500 characters after URL encoding, so non-Latin scripts get fewer characters. |
| country * | string | ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. "US"). Use list_countries to see supported codes per model. |
| include | object | Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (a CDN URL of the rendered Bing page). Leave unset for the leanest response. |
{
"name": "scrape_bing_aimode",
"title": "Scrape Bing AI Mode",
"description": "Submit a prompt to Bing AI Mode from a chosen country (and optionally US state) and return the answer text, cited sources and inline citation pills. Use this to see how Bing AI Mode answers a prompt and which brands/sources it mentions. Costs 6 credits (4 base + 2 sync surcharge); a state adds 2.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt",
"country"
],
"properties": {
"state": {
"type": "string",
"description": "Optional state code for state-level targeting (e.g. \"CA\" when country is \"US\"). Only some countries support this — call list_states for the supported countries and their codes."
},
"prompt": {
"type": "string",
"minLength": 1,
"description": "The prompt to submit to Bing AI Mode. The maximum is 3,500 characters after URL encoding, so non-Latin scripts get fewer characters."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. \"US\"). Use list_countries to see supported codes per model."
},
"include": {
"type": "object",
"properties": {
"html": {
"type": "boolean"
},
"markdown": {
"type": "boolean"
}
},
"description": "Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (a CDN URL of the rendered Bing page). Leave unset for the leanest response."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Submit a prompt to Google AI Mode from a chosen country and return the AI answer with cited sources. Supports location or UULE targeting and desktop/mobile emulation. An entry in shoppingCards or inlineProducts can carry a productResultToken; pass it to get_google_product within 5 minutes to get the full product. Costs 6 credits (4 base + 2 sync surcharge).
| Parameter | Type | Description |
|---|---|---|
| gl | string | ISO 3166-1 alpha-2 code for the result geography, sent to Google as gl (e.g. "us"). Use list_countries to see supported codes per model. |
| hl | string | Optional Google interface-language code, sent as hl (e.g. "de", "pt-br"). Defaults to the language derived from gl — set it when the geography's dominant language is not the one you want. |
| uule | string | Optional Google UULE location parameter. Mutually exclusive with location. |
| device | string | Device type to emulate. Defaults to desktop. |
| prompt * | string | The prompt to submit to Google AI Mode. |
| country | string | ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. "US"). Use list_countries to see supported codes per model. Deprecated — use gl instead; country is kept for compatibility and must not disagree with gl. |
| include | object | Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (the answer page HTML). Leave unset for the leanest response. |
Run a Google search from a chosen country and return organic results, with optional AI Overview extraction (include.aioverview) and People-Also-Ask AI answers (include.paaAioverview). Two modes: structured (query + gl, with optional location/uule/pages) or url (a complete google.com/search URL that owns query, location, and pagination). Supports desktop, mobile, iOS, and Android emulation and multi-page results. A result link can come back empty with a redirectLink beside it; pass the redirectLink to resolve_google_redirect to get the destination. An entry in shoppingCards or aioverview.inlineProducts can carry a productResultToken; pass it to get_google_product within 5 minutes to get the full product. Costs 5 credits (3 base + 2 sync surcharge); include.aioverview and/or include.paaAioverview add 2 once; each page after the first adds 2.
| Parameter | Type | Description |
|---|---|---|
| gl | string | ISO 3166-1 alpha-2 code for the result geography, sent to Google as gl (e.g. "us"). Use list_countries to see supported codes per model. Required in query mode; in url mode it is read from the URL's gl parameter unless supplied here, and an explicit value wins. |
| hl | string | Optional Google interface-language code, sent as hl (e.g. "de", "pt-br"). Defaults to the language derived from gl — set it when the geography's dominant language is not the one you want. In url mode it is read from the URL's hl parameter unless supplied here, and an explicit value wins. |
| udm | number | Optional. Set to 14 to search Google's Web tab, which lists web results only. No other value is accepted. In url mode, udm=14 inside the URL does the same. |
| url | string | A complete google.com/search URL to fetch instead of building one from structured fields. When set, query/location/uule/pages must be omitted (the URL owns them); gl and hl are read from the URL's gl/hl parameters; an explicit gl or hl must agree with the URL's copy. |
Run a Google News search from a chosen country and return news results. Supports desktop, mobile, iOS, and Android emulation and multi-page results. Costs 5 credits (3 base + 2 sync surcharge); each page after the first adds 2.
| Parameter | Type | Description |
|---|---|---|
| gl | string | ISO 3166-1 alpha-2 code for the result geography, sent to Google as gl (e.g. "us"). Use list_countries to see supported codes per model. |
| hl | string | Optional Google interface-language code, sent as hl (e.g. "de", "pt-br"). Defaults to the language derived from gl — set it when the geography's dominant language is not the one you want. |
| pages | number | Number of result pages to fetch (1-10). Defaults to 1. |
| query * | string | The search query. |
| device | string | Device to emulate: desktop, mobile, ios (Safari on iPhone), or android (Chrome on Android). mobile is an alias for android. Defaults to desktop. |
| country | string | ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. "US"). Use list_countries to see supported codes per model. Deprecated — use gl instead; country is kept for compatibility and must not disagree with gl. |
| include | object | Optional flag, off by default: html (the result page HTML). Leave unset for the leanest response. |
Resolve one Google redirect link to its destination URL. Use it when a link or url field from scrape_google, scrape_google_news or scrape_google_ai_mode is empty, missing, or a google.com/goto URL: pass that result's redirectLink. Returns { url }. A link that does not resolve returns a 502; retry it later. Costs 0 credits.
| Parameter | Type | Description |
|---|---|---|
| url * | string | The redirectLink value: an absolute https://www.google.com/goto?url=... or https://www.google.com/url?... link. |
{
"name": "resolve_google_redirect",
"title": "Resolve a Google redirect link",
"description": "Resolve one Google redirect link to its destination URL. Use it when a link or url field from scrape_google, scrape_google_news or scrape_google_ai_mode is empty, missing, or a google.com/goto URL: pass that result's redirectLink. Returns { url }. A link that does not resolve returns a 502; retry it later. Costs 0 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The redirectLink value: an absolute https://www.google.com/goto?url=... or https://www.google.com/url?... link."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Get the full details of one Google shopping product: merchant offers, images, description, specifications, reviews and related products. Pass a productResultToken from scrape_google (result.shoppingCards[] or result.aioverview.inlineProducts[]) or scrape_google_ai_mode (result.shoppingCards[] or result.inlineProducts[]). A token lasts at most 5 minutes from the scrape that issued it, so call this tool directly after that scrape. Returns result.productResults with one product. A 410 (productResultTokenExpired) means the token expired: run the scrape again to get a new token. A 404 (productResultTokenUnknown) means the token is not recognized. A 502 means Google returned no usable product data. Costs 3 credits (1 base + 2 sync surcharge); charged only when the product is returned.
| Parameter | Type | Description |
|---|---|---|
| productResultToken * | string | The productResultToken value from a shopping card or inline product of a scrape_google or scrape_google_ai_mode result. Send it unchanged. |
{
"name": "get_google_product",
"title": "Get a Google product",
"description": "Get the full details of one Google shopping product: merchant offers, images, description, specifications, reviews and related products. Pass a productResultToken from scrape_google (result.shoppingCards[] or result.aioverview.inlineProducts[]) or scrape_google_ai_mode (result.shoppingCards[] or result.inlineProducts[]). A token lasts at most 5 minutes from the scrape that issued it, so call this tool directly after that scrape. Returns result.productResults with one product. A 410 (productResultTokenExpired) means the token expired: run the scrape again to get a new token. A 404 (productResultTokenUnknown) means the token is not recognized. A 502 means Google returned no usable product data. Costs 3 credits (1 base + 2 sync surcharge); charged only when the product is returned.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"productResultToken"
],
"properties": {
"productResultToken": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "The productResultToken value from a shopping card or inline product of a scrape_google or scrape_google_ai_mode result. Send it unchanged."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the ISO 3166-1 alpha-2 country codes supported for geo-targeting. Pass a model to get the codes available for that specific engine (some engines block certain countries).
| Parameter | Type | Description |
|---|---|---|
| model | string | Optionally filter to countries supported by a specific engine. |
{
"name": "list_countries",
"title": "List supported countries",
"description": "List the ISO 3166-1 alpha-2 country codes supported for geo-targeting. Pass a model to get the codes available for that specific engine (some engines block certain countries).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"model": {
"enum": [
"aimode",
"aioverview",
"bing",
"bing_aimode",
"chatgpt",
"gemini",
"google"
],
"type": "string",
"description": "Optionally filter to countries supported by a specific engine."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"countries"
],
"properties": {
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISO 3166-1 alpha-2 country codes."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the state codes available for state-level geo-targeting in a country (used as the "state" parameter on the scrape tools). Only countries with state-level targeting are accepted.
| Parameter | Type | Description |
|---|---|---|
| country * | string | ISO 3166-1 alpha-2 country code to list states for. Only countries with state-level targeting are supported. |
{
"name": "list_states",
"title": "List states for a country",
"description": "List the state codes available for state-level geo-targeting in a country (used as the \"state\" parameter on the scrape tools). Only countries with state-level targeting are accepted.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country"
],
"properties": {
"country": {
"enum": [
"US"
],
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to list states for. Only countries with state-level targeting are supported."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"states"
],
"properties": {
"states": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "States available for state-level targeting."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the organization's credit balance: credits remaining, credits per billing cycle, and when the cycle resets. Free. Call it before a large run to check that the credits cover it. The balance can lag by up to 60 seconds.
No parameters.
{
"name": "get_credits",
"title": "Get the credit balance",
"description": "Get the organization's credit balance: credits remaining, credits per billing cycle, and when the cycle resets. Free. Call it before a large run to check that the credits cover it. The balance can lag by up to 60 seconds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"remaining",
"perCycle",
"cycleResetsAt"
],
"properties": {
"perCycle": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Credits granted per billing cycle. Null on the free tier."
},
"remaining": {
"type": "number",
"description": "Credits left in the organization."
},
"cycleResetsAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the billing cycle ends and the credits reset (ISO 8601). Null on the free tier."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}cloro scrapes AI answer engines (ChatGPT, Gemini, Google AI Mode, Bing AI Mode) and Google Search and News, geo-targeted by country. Costs: every scrape tool calls the sync API and costs its base credits, plus any add-ons, plus a 2-credit sync surcharge. Each tool description states its cost. Each result carries credits.charged and credits.remaining. list_countries, list_states, get_credits and resolve_google_redirect are free. get_google_product costs 1 credit plus the sync surcharge. Large or long-running jobs: these tools wait for the answer, up to about 5 minutes per call. For many prompts, or for scheduled runs, use the async API (POST /v1/async/task and /v1/async/task/batch, https://cloro.dev/docs) directly instead. It has no sync surcharge and returns results by webhook or polling. Empty links: a Google result link can come back empty, missing, or as a google.com/goto URL, with a redirectLink beside it. Pass that redirectLink to resolve_google_redirect to get the destination. Do not open a /goto URL yourself. Product details: a Google or AI Mode shopping card or inline product can carry a productResultToken. Pass it to get_google_product within 5 minutes of the scrape that returned it. A 410 means the token expired; run the scrape again for a new token.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
| location | string | Optional location name to target search results (e.g. "Austin, Texas, United States"). Mutually exclusive with uule. |
{
"name": "scrape_google_ai_mode",
"title": "Scrape Google AI Mode",
"description": "Submit a prompt to Google AI Mode from a chosen country and return the AI answer with cited sources. Supports location or UULE targeting and desktop/mobile emulation. An entry in shoppingCards or inlineProducts can carry a productResultToken; pass it to get_google_product within 5 minutes to get the full product. Costs 6 credits (4 base + 2 sync surcharge).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"gl": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code for the result geography, sent to Google as gl (e.g. \"us\"). Use list_countries to see supported codes per model."
},
"hl": {
"type": "string",
"description": "Optional Google interface-language code, sent as hl (e.g. \"de\", \"pt-br\"). Defaults to the language derived from gl — set it when the geography's dominant language is not the one you want."
},
"uule": {
"type": "string",
"description": "Optional Google UULE location parameter. Mutually exclusive with location."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"default": "desktop",
"description": "Device type to emulate. Defaults to desktop."
},
"prompt": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"description": "The prompt to submit to Google AI Mode."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. \"US\"). Use list_countries to see supported codes per model. Deprecated — use gl instead; country is kept for compatibility and must not disagree with gl."
},
"include": {
"type": "object",
"properties": {
"html": {
"type": "boolean"
},
"markdown": {
"type": "boolean"
},
"expandProducts": {
"type": "boolean"
}
},
"description": "Optional flags for heavier payload fields, each off by default: markdown (the answer rendered as markdown), html (the answer page HTML). Leave unset for the leanest response."
},
"location": {
"type": "string",
"description": "Optional location name to target search results (e.g. \"Austin, Texas, United States\"). Mutually exclusive with uule."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| uule | string | Optional Google UULE location parameter. Mutually exclusive with location. |
| pages | number | Number of result pages to fetch (1-10). Defaults to 1. |
| query | string | The search query. Required unless url is provided. |
| device | string | Device to emulate: desktop, mobile, ios (Safari on iPhone), or android (Chrome on Android). mobile is an alias for android. Defaults to desktop. |
| country | string | ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. "US"). Use list_countries to see supported codes per model. Deprecated — use gl instead; country is kept for compatibility and must not disagree with gl. |
| include | object | Optional flags. Set aioverview: true to extract Google's AI Overview (or { markdown: true } for markdown), paaAioverview: true to hydrate AI answers in People Also Ask. Leave unset for organic results only. |
| location | string | Optional location name to target search results (e.g. "Austin, Texas, United States"). Mutually exclusive with uule. |
{
"name": "scrape_google",
"title": "Scrape Google Search",
"description": "Run a Google search from a chosen country and return organic results, with optional AI Overview extraction (include.aioverview) and People-Also-Ask AI answers (include.paaAioverview). Two modes: structured (query + gl, with optional location/uule/pages) or url (a complete google.com/search URL that owns query, location, and pagination). Supports desktop, mobile, iOS, and Android emulation and multi-page results. A result link can come back empty with a redirectLink beside it; pass the redirectLink to resolve_google_redirect to get the destination. An entry in shoppingCards or aioverview.inlineProducts can carry a productResultToken; pass it to get_google_product within 5 minutes to get the full product. Costs 5 credits (3 base + 2 sync surcharge); include.aioverview and/or include.paaAioverview add 2 once; each page after the first adds 2.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"gl": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code for the result geography, sent to Google as gl (e.g. \"us\"). Use list_countries to see supported codes per model. Required in query mode; in url mode it is read from the URL's gl parameter unless supplied here, and an explicit value wins."
},
"hl": {
"type": "string",
"description": "Optional Google interface-language code, sent as hl (e.g. \"de\", \"pt-br\"). Defaults to the language derived from gl — set it when the geography's dominant language is not the one you want. In url mode it is read from the URL's hl parameter unless supplied here, and an explicit value wins."
},
"udm": {
"type": "number",
"const": 14,
"description": "Optional. Set to 14 to search Google's Web tab, which lists web results only. No other value is accepted. In url mode, udm=14 inside the URL does the same."
},
"url": {
"type": "string",
"description": "A complete google.com/search URL to fetch instead of building one from structured fields. When set, query/location/uule/pages must be omitted (the URL owns them); gl and hl are read from the URL's gl/hl parameters; an explicit gl or hl must agree with the URL's copy."
},
"uule": {
"type": "string",
"description": "Optional Google UULE location parameter. Mutually exclusive with location."
},
"pages": {
"type": "number",
"maximum": 10,
"description": "Number of result pages to fetch (1-10). Defaults to 1.",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"description": "The search query. Required unless url is provided."
},
"device": {
"enum": [
"desktop",
"mobile",
"ios",
"android"
],
"type": "string",
"default": "desktop",
"description": "Device to emulate: desktop, mobile, ios (Safari on iPhone), or android (Chrome on Android). mobile is an alias for android. Defaults to desktop."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. \"US\"). Use list_countries to see supported codes per model. Deprecated — use gl instead; country is kept for compatibility and must not disagree with gl."
},
"include": {
"type": "object",
"properties": {
"html": {
"type": "boolean"
},
"aioverview": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "object",
"properties": {
"expand": {
"type": "boolean"
},
"markdown": {
"type": "boolean"
}
}
}
]
},
"paaAioverview": {
"type": "boolean"
}
},
"description": "Optional flags. Set aioverview: true to extract Google's AI Overview (or { markdown: true } for markdown), paaAioverview: true to hydrate AI answers in People Also Ask. Leave unset for organic results only."
},
"location": {
"type": "string",
"description": "Optional location name to target search results (e.g. \"Austin, Texas, United States\"). Mutually exclusive with uule."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "scrape_google_news",
"title": "Scrape Google News",
"description": "Run a Google News search from a chosen country and return news results. Supports desktop, mobile, iOS, and Android emulation and multi-page results. Costs 5 credits (3 base + 2 sync surcharge); each page after the first adds 2.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"gl": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code for the result geography, sent to Google as gl (e.g. \"us\"). Use list_countries to see supported codes per model."
},
"hl": {
"type": "string",
"description": "Optional Google interface-language code, sent as hl (e.g. \"de\", \"pt-br\"). Defaults to the language derived from gl — set it when the geography's dominant language is not the one you want."
},
"pages": {
"type": "number",
"default": 1,
"maximum": 10,
"description": "Number of result pages to fetch (1-10). Defaults to 1.",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"description": "The search query."
},
"device": {
"enum": [
"desktop",
"mobile",
"ios",
"android"
],
"type": "string",
"default": "desktop",
"description": "Device to emulate: desktop, mobile, ios (Safari on iPhone), or android (Chrome on Android). mobile is an alias for android. Defaults to desktop."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to geo-target the request from (e.g. \"US\"). Use list_countries to see supported codes per model. Deprecated — use gl instead; country is kept for compatibility and must not disagree with gl."
},
"include": {
"type": "object",
"properties": {
"html": {
"type": "boolean"
}
},
"description": "Optional flag, off by default: html (the result page HTML). Leave unset for the leanest response."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}