localization
Look up a country's language, Accept-Language, timezone, currency and date formats, or run a country-targeted search. Returns values only — pass them to your fetch or search tool.
Instructions
Use this to look up the locale settings of a country - language, Accept-Language header, timezone, currency, search domain, date and number formats - or to run a search targeted at a country (operation:"localize_search"). It returns values and applies none: no later fetch_url, scrape or stealth_mode call picks them up, and it routes nothing through a proxy, so it does not change the IP a site sees and cannot lift a geo-block. Pass the returned values to the tool that makes the request: fetch_url headers:{"Accept-Language": acceptLanguage}; stealth_mode stealthConfig:{locale: language, timezone: timezone}; search_web localization:{countryCode, language}. scrape has no locale parameter. Not for an ordinary page read (scrape). Cost: 2 credits. Example: localization({operation:"configure_country", countryCode:"DE", language:"de"})
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL — required for handle_geo_blocking; for auto_detect it is optional metadata used only as a TLD country hint (the page is never fetched) | |
| content | No | Page content (HTML or plain text) to analyze — required for auto_detect; no fetching is performed | |
| currency | No | ISO 4217 currency code (e.g. 'USD', 'EUR') - configure_country only | |
| language | No | Language code (e.g. 'en', 'fr', 'de-CH') - configure_country only; other values are refused | |
| response | No | HTTP response for geo-blocking analysis | |
| timezone | No | IANA timezone identifier (e.g. 'America/New_York') - configure_country and generate_timezone_spoof | |
| operation | No | Localization operation to perform. Every operation returns data; none changes how another tool behaves. configure_country: the country's settings (language, acceptLanguage, timezone, currency, searchDomain, browserLocale). localize_search: runs search_web for searchParams.query in the country and its language. localize_browser: Playwright-style context options for the country (locale, timezoneId, geolocation, extraHTTPHeaders) - no browser is launched. generate_timezone_spoof: a JavaScript snippet that overrides Date and Intl for the timezone - nothing is injected. handle_geo_blocking: classifies a response you supply (url + response) and lists suggestions - nothing is fetched or bypassed. auto_detect: language and country detected in content you supply. get_stats: counters for this server process. get_supported_countries: the accepted country codes. | configure_country |
| userAgent | No | Not used by any operation. To carry a user agent through localize_browser, set browserOptions.userAgent | |
| countryCode | No | ISO 3166-1 alpha-2 country code, upper or lower case; operation:"get_supported_countries" lists the accepted ones. When omitted, the other operations use the country of the last configure_country call in this server process (US at start) - pass it on every call | |
| geoLocation | No | Coordinates echoed back in the configure_country result; nothing is emulated | |
| searchParams | No | Search parameters for localized search queries | |
| customHeaders | No | Headers echoed back in the configure_country result; nothing is sent | |
| proxySettings | No | Echoed back in the configure_country result. No request is routed through it: CrawlForge supplies no proxies, and your own go on stealth_mode stealthConfig.proxyRotation | |
| acceptLanguage | No | Accept-Language value to return from configure_country in place of the one built from the language and country | |
| browserOptions | No | Browser context options for localize_browser to build on: returned with the country's locale, timezoneId, geolocation and Accept-Language set, and your userAgent and other extraHTTPHeaders kept |