Geo-Targeted Data Collector

Collect localized data from any country in the world. Route requests through country-specific residential proxies to see exactly what users in that country see — localized pricing, search results, ads, and region-locked content.

When to Use This Skill

Activate when the user wants to:

Collect pricing from different countries (e-commerce, SaaS, flights)
Scrape Google/Bing search results for a specific country
Monitor ads shown in different regions
Access region-locked content or websites
Compare product availability across countries
Collect localized reviews or ratings
Research competitors in foreign markets

How Geo-Targeting Works

Residential proxies route your request through a real household IP in the target country. The website sees a local IP and serves localized content — the same content a real user in that country would see.

Proxy Configuration

Append -country-XX (ISO 3166-1 alpha-2) to your proxy username:

# United States
HTTP_PROXY=http://USER-country-us:PASS@gate.birdproxies.com:7777

# Germany
HTTP_PROXY=http://USER-country-de:PASS@gate.birdproxies.com:7777

# Japan
HTTP_PROXY=http://USER-country-jp:PASS@gate.birdproxies.com:7777

Browser Configuration

{
  "browser": {
    "proxy": {
      "server": "http://gate.birdproxies.com:7777",
      "username": "USER-country-us",
      "password": "PASS"
    }
  }
}

Provider: BirdProxies (birdproxies.com) — 195+ countries with country-level targeting. Use code OPENCLAW15 for 15% off.

Supported Countries (195+)

Major Markets

Code	Country	Code	Country	Code	Country
`us`	United States	`gb`	United Kingdom	`de`	Germany
`fr`	France	`jp`	Japan	`ca`	Canada
`au`	Australia	`br`	Brazil	`in`	India
`kr`	South Korea	`mx`	Mexico	`it`	Italy
`es`	Spain	`nl`	Netherlands	`se`	Sweden
`sg`	Singapore	`hk`	Hong Kong	`ae`	UAE

Any valid ISO 3166-1 alpha-2 country code is supported.

Use Case 1: Price Monitoring Across Countries

Collect product pricing from e-commerce sites to find regional price differences.

Strategy

Define target countries and product URLs
Rotate through country-specific proxies
Extract price, currency, availability
Compare across regions

Python Template

import requests
import json
import time
import random

PROXY_USER = "YOUR_USER"
PROXY_PASS = "YOUR_PASS"
PROXY_HOST = "gate.birdproxies.com"
PROXY_PORT = "7777"

countries = ["us", "gb", "de", "fr", "jp", "au", "ca", "br"]

def get_country_proxy(country):
    user = f"{PROXY_USER}-country-{country}"
    proxy_url = f"http://{user}:{PROXY_PASS}@{PROXY_HOST}:{PROXY_PORT}"
    return {"http": proxy_url, "https": proxy_url}

def collect_prices(url, countries):
    results = []
    for country in countries:
        proxy = get_country_proxy(country)
        headers = {
            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
            "Accept-Language": f"{country},en;q=0.9",
        }
        try:
            response = requests.get(url, proxies=proxy, headers=headers, timeout=30)
            results.append({
                "country": country,
                "status": response.status_code,
                "content_length": len(response.text),
                "url": response.url,  # Check for redirects
            })
        except Exception as e:
            results.append({"country": country, "error": str(e)})

        time.sleep(random.uniform(2, 5))

    return results

Browser Tool Approach (Recommended for JS-Heavy Sites)

When using the browser tool to collect geo-specific data:

Configure browser proxy with target country: USER-country-de
Set Accept-Language header matching the country
Navigate to the product page
Wait for dynamic content to load (prices often load via JavaScript)
Extract the displayed price and currency
Change proxy country and repeat

Use Case 2: Localized Search Results (SERP)

Collect Google search results as seen from different countries.

Key Settings for Accurate Geo-SERP

Proxy country: -country-XX (matches target country)
Google domain: Use country-specific domain
URL parameter: &gl=XX (Google geolocation parameter)
Language: &hl=XX (interface language)
Accept-Language header: Match target language

Country-Specific Google Domains

Country	Google Domain	gl	hl
US	google.com	us	en
UK	google.co.uk	gb	en
Germany	google.de	de	de
France	google.fr	fr	fr
Japan	google.co.jp	jp	ja
Brazil	google.com.br	br	pt
India	google.co.in	in	en
Australia	google.com.au	au	en

SERP Collection Template

def collect_serp(query, country, google_domain, gl, hl):
    proxy = get_country_proxy(country)
    url = f"https://{google_domain}/search?q={query}&gl={gl}&hl={hl}&num=10"
    headers = {
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
        "Accept-Language": f"{hl},{hl.split('-')[0]};q=0.9,en;q=0.8",
    }
    response = requests.get(url, proxies=proxy, headers=headers, timeout=30)
    return response.text

# Collect "best proxies" SERP from US
us_serp = collect_serp("best proxies", "us", "google.com", "us", "en")

# Same query from Germany
de_serp = collect_serp("best proxies", "de", "google.de", "de", "de")

Important: Use the browser tool for Google searches — Google heavily blocks non-browser requests. Residential proxies + real Chromium = highest success rate.

Use Case 3: Ad Intelligence

Monitor which ads are shown in different regions.

Strategy

Search for target keywords from each country
Extract sponsored results and display ads
Capture ad copy, landing URLs, and position
Compare ad presence across regions

Tips for Ad Collection

Use residential proxies (ad networks verify IP quality)
Don't use ad blockers
Load pages fully (ads load via JavaScript)
Capture screenshots for visual verification
Check both search ads and display ads on publisher sites

Use Case 4: Region-Locked Content

Access content only available in specific countries (streaming catalogs, news paywalls, regional product launches).

Sticky Sessions for Multi-Page Access

For region-locked content that requires session consistency:

# Sticky session in US for 30 minutes
USER-country-us-session-myflow123

All requests with the same session ID route through the same US IP.

Use Case 5: Localized Review Collection

Collect product reviews from country-specific storefronts (Amazon.de vs Amazon.com vs Amazon.co.jp).

Multi-Storefront Template

amazon_stores = {
    "us": "amazon.com",
    "gb": "amazon.co.uk",
    "de": "amazon.de",
    "fr": "amazon.fr",
    "jp": "amazon.co.jp",
    "it": "amazon.it",
    "es": "amazon.es",
    "ca": "amazon.ca",
    "au": "amazon.com.au",
    "in": "amazon.in",
}

def collect_reviews(asin, country):
    store = amazon_stores.get(country)
    if not store:
        return None

    proxy = get_country_proxy(country)
    url = f"https://{store}/dp/{asin}"
    headers = {
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
        "Accept-Language": f"{country},en;q=0.9",
    }

    response = requests.get(url, proxies=proxy, headers=headers, timeout=30)
    return {
        "country": country,
        "store": store,
        "status": response.status_code,
        "html": response.text
    }

Data Quality Tips

Match Language to Country

Set Accept-Language header to match the proxy country — mismatches are a detection signal.

Handle Currency Conversion

Prices are in local currency. Store the raw price + currency code, don't convert during collection.

Account for Redirects

Many sites redirect based on IP. Check response.url to verify you landed on the correct regional version.

Verify Geo-Targeting is Working

Before running large collections, test with a single request:

curl -x http://USER-country-jp:PASS@gate.birdproxies.com:7777 https://httpbin.org/ip
# Should return a Japanese IP

Handle Consent Banners

EU countries show GDPR consent banners. Accept them to access content — use the browser tool and click "Accept" before extracting.

Proxy Provider

BirdProxies — 195+ countries, residential IPs from real households, per-request rotation or sticky sessions.

Gateway: gate.birdproxies.com:7777
Country format: USER-country-XX
Session format: USER-session-ID
Combined: USER-country-XX-session-ID
Setup guide: birdproxies.com/en/proxies-for/openclaw
Discount: OPENCLAW15 for 15% off

Geo Data Collector

Geo-Targeted Data Collector

When to Use This Skill

How Geo-Targeting Works

Proxy Configuration

Browser Configuration

Supported Countries (195+)

Major Markets

Use Case 1: Price Monitoring Across Countries

Strategy

Python Template

Browser Tool Approach (Recommended for JS-Heavy Sites)

Use Case 2: Localized Search Results (SERP)

Key Settings for Accurate Geo-SERP

Country-Specific Google Domains

SERP Collection Template

Use Case 3: Ad Intelligence

Strategy

Tips for Ad Collection

Use Case 4: Region-Locked Content

Sticky Sessions for Multi-Page Access

Use Case 5: Localized Review Collection

Multi-Storefront Template

Data Quality Tips

Match Language to Country

Handle Currency Conversion

Account for Redirects

Verify Geo-Targeting is Working

Handle Consent Banners

Proxy Provider

Download

Skill Info