cloro
Scrape AI answer engines and Google Search/News with country and state-level geo-targeting.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"cloro": {
"url": "https://mcp.cloro.dev/mcp"
}
}
}リモートエンドポイント
https://mcp.cloro.dev/mcpstreamable-httpできること
ツール一覧
ツール(11)
🟢scrape_chatgpt(prompt, country, include, legacy, disableWebSearch, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"prompt": {
"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.",
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 10000
},
{
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 10000
}
}
]
},
"country": {
"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.",
"type": "string"
},
"include": {
"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.",
"type": "object",
"properties": {
"markdown": {
"type": "boolean"
},
"rawResponse": {
"type": "boolean"
},
"searchQueries": {
"type": "boolean"
},
"html": {
"type": "boolean"
},
"ads": {
"type": "boolean"
},
"shopping": {
"type": "boolean"
},
"productDetails": {
"type": "boolean"
}
}
},
"legacy": {
"description": "Serve ChatGPT's desktop UI instead of the default mobile-web UI. Defaults to false.",
"type": "boolean"
},
"disableWebSearch": {
"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.",
"type": "boolean"
},
"state": {
"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.",
"type": "string"
}
},
"required": [
"prompt",
"country"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢scrape_gemini(prompt, country, include, state)
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.
入力スキーマ
{
"type": "object",
"properties": {
"prompt": {
"description": "The prompt to submit to Google Gemini.",
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"country": {
"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.",
"type": "string"
},
"include": {
"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.",
"type": "object",
"properties": {
"html": {
"type": "boolean"
},
"markdown": {
"type": "boolean"
},
"rawResponse": {
"type": "boolean"
}
}
},
"state": {
"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.",
"type": "string"
}
},
"required": [
"prompt",
"country"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢scrape_bing_aimode(prompt, country, include, state)
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.
入力スキーマ
{
"type": "object",
"properties": {
"prompt": {
"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.",
"type": "string",
"minLength": 1
},
"country": {
"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.",
"type": "string"
},
"include": {
"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.",
"type": "object",
"properties": {
"markdown": {
"type": "boolean"
},
"html": {
"type": "boolean"
}
}
},
"state": {
"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.",
"type": "string"
}
},
"required": [
"prompt",
"country"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢scrape_google_ai_mode(prompt, country, gl, hl, location, ...)
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).
入力スキーマ
{
"type": "object",
"properties": {
"prompt": {
"description": "The prompt to submit to Google AI Mode.",
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"country": {
"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.",
"type": "string"
},
"gl": {
"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.",
"type": "string"
},
"hl": {
"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.",
"type": "string"
},
"location": {
"description": "Optional location name to target search results (e.g. \"Austin, Texas, United States\"). Mutually exclusive with uule.",
"type": "string"
},
"uule": {
"description": "Optional Google UULE location parameter. Mutually exclusive with location.",
"type": "string"
},
"device": {
"description": "Device type to emulate. Defaults to desktop.",
"default": "desktop",
"type": "string",
"enum": [
"desktop",
"mobile"
]
},
"include": {
"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.",
"type": "object",
"properties": {
"markdown": {
"type": "boolean"
},
"html": {
"type": "boolean"
},
"expandProducts": {
"type": "boolean"
}
}
}
},
"required": [
"prompt"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢scrape_google(query, url, country, gl, hl, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"description": "The search query. Required unless url is provided.",
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"url": {
"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.",
"type": "string"
},
"country": {
"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.",
"type": "string"
},
"gl": {
"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.",
"type": "string"
},
"hl": {
"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.",
"type": "string"
},
"location": {
"description": "Optional location name to target search results (e.g. \"Austin, Texas, United States\"). Mutually exclusive with uule.",
"type": "string"
},
"uule": {
"description": "Optional Google UULE location parameter. Mutually exclusive with location.",
"type": "string"
},
"device": {
"description": "Device to emulate: desktop, mobile, ios (Safari on iPhone), or android (Chrome on Android). mobile is an alias for android. Defaults to desktop.",
"default": "desktop",
"type": "string",
"enum": [
"desktop",
"mobile",
"ios",
"android"
]
},
"pages": {
"description": "Number of result pages to fetch (1-10). Defaults to 1.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10
},
"include": {
"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.",
"type": "object",
"properties": {
"html": {
"type": "boolean"
},
"aioverview": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "object",
"properties": {
"markdown": {
"type": "boolean"
}
}
}
]
},
"paaAioverview": {
"type": "boolean"
}
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢scrape_google_news(query, country, gl, hl, device, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"description": "The search query.",
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"country": {
"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.",
"type": "string"
},
"gl": {
"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.",
"type": "string"
},
"hl": {
"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.",
"type": "string"
},
"device": {
"description": "Device to emulate: desktop, mobile, ios (Safari on iPhone), or android (Chrome on Android). mobile is an alias for android. Defaults to desktop.",
"default": "desktop",
"type": "string",
"enum": [
"desktop",
"mobile",
"ios",
"android"
]
},
"pages": {
"description": "Number of result pages to fetch (1-10). Defaults to 1.",
"default": 1,
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10
},
"include": {
"description": "Optional flag, off by default: html (the result page HTML). Leave unset for the leanest response.",
"type": "object",
"properties": {
"html": {
"type": "boolean"
}
}
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢resolve_google_redirect(url)
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 1 credit, with no sync surcharge, and only when the destination is returned.
入力スキーマ
{
"type": "object",
"properties": {
"url": {
"description": "The redirectLink value: an absolute https://www.google.com/goto?url=... or https://www.google.com/url?... link.",
"type": "string",
"format": "uri"
}
},
"required": [
"url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_google_product(productResultToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"productResultToken": {
"description": "The productResultToken value from a shopping card or inline product of a scrape_google or scrape_google_ai_mode result. Send it unchanged.",
"type": "string",
"minLength": 1,
"maxLength": 512
}
},
"required": [
"productResultToken"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_countries(model)
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).
入力スキーマ
{
"type": "object",
"properties": {
"model": {
"description": "Optionally filter to countries supported by a specific engine.",
"type": "string",
"enum": [
"aimode",
"aioverview",
"bing_aimode",
"chatgpt",
"gemini",
"google"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"countries": {
"description": "ISO 3166-1 alpha-2 country codes.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"countries"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_states(country)
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.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2 country code to list states for. Only countries with state-level targeting are supported.",
"type": "string",
"enum": [
"US"
]
}
},
"required": [
"country"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"states": {
"description": "States available for state-level targeting.",
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"name"
],
"additionalProperties": false
}
}
},
"required": [
"states"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_credits
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.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"remaining": {
"description": "Credits left in the organization.",
"type": "number"
},
"perCycle": {
"description": "Credits granted per billing cycle. Null on the free tier.",
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cycleResetsAt": {
"description": "When the billing cycle ends and the credits reset (ISO 8601). Null on the free tier.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"remaining",
"perCycle",
"cycleResetsAt"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}コミュニティ
エビデンス