// MCP integration

Connect Litescrape to your AI tools

Use the hosted MCP server or run the local package, then choose a scraper and copy its tool call.

Connect to the hosted server

Add https://mcp.litescrape.com/mcp as an HTTP MCP server in your client. For Claude Code:

claude mcp add --transport http litescrape https://mcp.litescrape.com/mcp

Google Search, Google Maps, Bing Search and DuckDuckGo Search have a free keyless allowance. To use your existing key, set LITESCRAPE_API_KEY in your environment and configure a bearer header:

claude mcp add --transport http litescrape https://mcp.litescrape.com/mcp \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY"

Do not paste your key into a prompt or commit it to your project. Configure authentication through your client's server settings.

Or run the local MCP package

For a client that supports a local command, add this server configuration. Configure LITESCRAPE_API_KEY in the server environment when a key is needed.

{
  "mcpServers": {
    "litescrape": {
      "command": "npx",
      "args": [
        "-y",
        "litescrape-mcp-server"
      ]
    }
  }
}

Read the complete client setup and MCP reference →

// from request to code

Integrate in seconds

Build your request and copy it into your stack. Or let your coding agent set it up.

APIQueryRequired unless ludocid or kgmid is supplied; up to 2,048 characters.

More options 42

Query or entity

Supply a query, Google local CID, or Knowledge Graph machine ID.

Fast modeReturn organic results only. Skips AI Overview and all other result groups.Local CIDDecimal Google CID for a local entity search.Knowledge Graph IDGoogle Knowledge Graph machine ID.

Geography

Choose location, uule, or latitude and longitude. Radius depends on device.

LocationHuman-readable location; conflicts with uule and lat/lon.UULEPre-encoded Google location; conflicts with location and lat/lon.LatitudeBetween -90 and 90; supply with longitude.LongitudeBetween -180 and 180; supply with latitude.Radius (meters)Decimal meters from 1–199 on desktop or 1–1,000 on tablet/mobile; requires geography.

Knowledge Graph controls

Pass Google entity, layout, and cached-context tokens without rewriting them.

lsigOpaque local/Knowledge Graph signature.siOpaque cached Google search context.ibpGoogle layout or expansion control.udsOpaque Google filter token.Color schemeSelect Google’s light or dark result presentation.

Localization

Control Google domain, language, country, restrictions, and device.

LanguageGoogle interface and result language.CountryTwo-letter country localization code.Google domainA Google domain such as google.com or google.co.uk.Country restrictOne or more countryXX values joined with |.Language restrictOne or more lang_xx values joined with |.DeviceSelect desktop, tablet, or mobile request behavior.

Filtering & pagination

Apply native Google filtering, vertical, date, safety, and offset controls.

Search filterGoogle tbs filter string.Safe searchGoogle adult-content filtering.Auto-correctionSet Google nfpr to 0 or 1.Similar resultsSet Google result filtering to 0 or 1.PersonalizationSet Google pws to 0 or 1; 0 asks for non-personalized results.Personalization peekSet Google peek_pws to 0 or 1; forwarded to Google unchanged.VerticalGoogle vertical such as nws, shop, vid, lcl, or pts. Google Images (isch) is not supported.Start offsetNon-negative Google result offset.Results requestedBest-effort first-page result count, 1 to 100.

Advanced query

Expose Google’s complete advanced-search parameter family.

Site modeInclude or exclude as_sitesearch.Exact phraseExact phrase query.Exclude phraseExcluded phrase query.Links to URLRequire results that link to this HTTP(S) URL.Range lowInteger lower bound; requires as_nhi.Range highInteger upper bound; requires as_nlo.Any termsAny-of terms.All termsAdditional all-of terms.Date ranged, w, m, or y with an optional positive count.Related to URLFind pages related to this HTTP(S) URL.Site hostnameHostname to include or exclude.Original queryAutocomplete original-query lineage value; forwarded verbatim.Autocomplete lineageGoogle gs_lp autocomplete-session token; forwarded verbatim.Search clientGoogle client identifier such as gws-wiz-serp.

Your request updates the code instantly.

Open the Playground →

https://mcp.litescrape.com/mcp

Add the server URL to your MCP client, then call the tool below. A free allowance is available without a key.

tools/call.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_search",
    "arguments": {
      "q": "coffee maker",
      "hl": "en",
      "gl": "us",
      "device": "desktop"
    }
  }
}

Litescrape sells to AI agents - live prices and self-serve payment

Connect Litescrape to your AI tools

Connect to the hosted server

Or run the local MCP package

Integrate in seconds