HasData Google Search (SERP)
hasdata/google-search-mcp
Google SERP as JSON: organic, AI Overview, People Also Ask, AI Mode, news, shopping. No Cloud setup.
- GitHub stars
- 14
- tools
- 10
- auth
- Secret needed
- transport
- STDIO, HTTP
- env var
- 1
- last updated
- Sep 24, 2026
Install
From registry metadata$ npx add-mcp 'https://mcp.hasdata.com/mcp?apis=google_serp' --name google-search --header 'x-api-key: ${X_API_KEY}'Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http google-search 'https://mcp.hasdata.com/mcp?apis=google_serp' --header 'x-api-key: YOUR_X_API_KEY'Run in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 10 toolsVerified live against the running server on Nov 6, 2026.
hasdata_google_serp_ai_mode_getAiModeResponseGet AI Mode SERP Results Captures Gemini-powered AI Mode answers from Google Search. Returns the conversational response text, cited source links, subtopic breakdowns, and, when continuable is set, a subsequentRequestToken for multi-turn continuation. Use for next-gen search i...7 params
Get AI Mode SERP Results Captures Gemini-powered AI Mode answers from Google Search. Returns the conversational response text, cited source links, subtopic breakdowns, and, when continuable is set, a subsequentRequestToken for multi-turn continuation. Use for next-gen search i...
Parameters* required
continuablebooleanWhether to continue an existing AI Mode conversation.
glstringThe two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
hlstringThe two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
locationstringGoogle canonical location for the search.
q*stringSpecify the search term for which you want to scrape the SERP.
subsequentRequestTokenstringToken used to continue a previous AI Mode request.
uulestringThe encoded location parameter.
hasdata_google_serp_ai_overview_getAiOverviewResponseGet AI Overview Results Fetches the lazy-loaded Google AI Overview block via a pageToken returned by the Google SERP API (token valid for 1 minute). Returns the AI-generated answer text, referenced source URLs, and expanded subtopic sections. Use as a follow-up call to Google...1 params
Get AI Overview Results Fetches the lazy-loaded Google AI Overview block via a pageToken returned by the Google SERP API (token valid for 1 minute). Returns the AI-generated answer text, referenced source URLs, and expanded subtopic sections. Use as a follow-up call to Google...
Parameters* required
pageToken*stringToken from `aiOverview` block in Google SERP API. Valid for 1 minute.
hasdata_google_serp_events_getEventInformationGet Google Event Details Looks up a single Google event by the `pageToken` returned in a `google/serp` response's `eventsResults` array (or the ready-to-call `hasdataLink` next to it). Returns the venue name/rating/reviews/website/phone, a map link, a description, ticket sourc...1 params
Get Google Event Details Looks up a single Google event by the `pageToken` returned in a `google/serp` response's `eventsResults` array (or the ready-to-call `hasdataLink` next to it). Returns the venue name/rating/reviews/website/phone, a map link, a description, ticket sourc...
Parameters* required
pageToken*stringToken identifying a single event, taken from the `pageToken` field of an `eventsResults` entry in a `google/serp` response. Expires a few minutes after it is minted.
hasdata_google_serp_immersive_product_getImmersive_e29f691177Get Immersive Product Information Expands the Google Shopping Immersive Product pop-up given an immersiveProductPageToken from the Google Shopping API, with optional moreStores (up to ~13 merchants instead of 3–5) and nextPageToken for paginating stores. Returns multi-store of...3 params
Get Immersive Product Information Expands the Google Shopping Immersive Product pop-up given an immersiveProductPageToken from the Google Shopping API, with optional moreStores (up to ~13 merchants instead of 3–5) and nextPageToken for paginating stores. Returns multi-store of...
Parameters* required
moreStoresbooleanFetch additional store results in a single search. By default it returns 3–5 stores, and when true it returns up to 13 or the maximum available for the product.
nextPageTokenstringToken used to retrieve the next page of store results.
pageToken*stringToken for displaying more product info in the Google immersive pop-up, available in the Google Shopping API response as the `immersiveProductPageToken` property.
hasdata_google_serp_news_getGoogleNewsGet Google News Results Retrieves Google News results by free-text query, topicToken (World, Business, Technology, etc.), sectionToken, publicationToken (e.g. CNN, BBC), or storyToken (full-coverage cluster with sort by relevance/date). Returns article title, snippet, source p...8 params
Get Google News Results Retrieves Google News results by free-text query, topicToken (World, Business, Technology, etc.), sectionToken, publicationToken (e.g. CNN, BBC), or storyToken (full-coverage cluster with sort by relevance/date). Returns article title, snippet, source p...
Parameters* required
glstringThe two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
hlstringThe two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
publicationTokenstringToken for a specific publisher such as CNN or BBC. Not allowed with `q`, `storyToken`, or `topicToken`.
qstringFree-text query as used on news.google.com. Not allowed with `topicToken`, `storyToken`, or `publicationToken`.
sectionTokenstringToken for a sub-section under a topic, for example Business → Economy. Use only when `topicToken` or `publicationToken` is present.
sostringSort order for articles in a story. Use only with storyToken.one of
0 · 1storyTokenstringToken for a single news story cluster (the “Full coverage” page).
topicTokenstringToken for a Google News topic such as World, Business, or Technology. Not allowed with `q`, `storyToken`, or `publicationToken`.
hasdata_google_serp_product_getProductInformationGet Product Information Pulls detailed product data from Google Shopping by productId with searchType (offers, specs, reviews) and rich filters (free shipping, used-condition, sort by price/total price/deals/seller rating, reviews count). Returns product title, images, price,...9 params
Get Product Information Pulls detailed product data from Google Shopping by productId with searchType (offers, specs, reviews) and rich filters (free shipping, used-condition, sort by price/total price/deals/seller rating, reviews count). Returns product title, images, price,...
Parameters* required
domainstringGoogle domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`.
filterstringFilter parameter for refining search results. Supports various filters for offers and reviews. Multiple filters can be passed using a comma. The available filters are:
Offers filters:
- `freeship:...
glstringThe two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
hlstringThe two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
locationstringGoogle canonical location for the search.
productId*stringThe product ID to get results for.
searchTypestringParameter for fetching specific product information, such as 'offers', 'specs', or 'reviews'.one of
offers · specs · reviewsstartnumberThis parameter specifies the number of search results to skip and is used for pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and...
uulestringThe encoded location parameter.
hasdata_google_serp_serp_getSearchResultsGet Google Search Results Full-featured Google Search scraper with location/uule, country (gl), language (hl, lr), domain, device type, safesearch, time/date filters via tbs (qdr, cdr), and tbm vertical selection (images, videos, news, shopping, local), plus offset/num paginat...22 params
Get Google Search Results Full-featured Google Search scraper with location/uule, country (gl), language (hl, lr), domain, device type, safesearch, time/date filters via tbs (qdr, cdr), and tbm vertical selection (images, videos, news, shopping, local), plus offset/num paginat...
Parameters* required
deviceTypestringSpecify the device type for the search.one of
desktop · mobile · tabletdomainstringGoogle domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`.
filternumberDefines whether to enable or disable the filters for 'Similar Results' and 'Omitted Results'. Set to 1 (default) to enable these filters, or 0 to disable them.
glstringThe two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
hlstringThe two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
kgmidstringGoogle Knowledge Graph ID.
latnumberGPS latitude for the search origin.
locationstringGoogle canonical location for the search.
lonnumberGPS longitude for the search origin.
lrarrayThe 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content.
lsigstringAdditional Google Place ID.
ludocidstringThe Google Place ID for a specific location.
nfprnumberControls if auto-corrected results are shown. 0 includes them (default), 1 shows only the original query. Google may still return auto-corrected results if no others are available.
numnumberNumber of results per page, ranging from 10 to 100.
q*stringSpecify the search term for which you want to scrape the SERP.
radiusnumberRadius around the search origin in meters.
safestringAdult Content Filtering option.one of
active · offsistringGoogle Cached Search Parameters ID.
startnumberThis parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the seco...
tbmstringSpecify the type of search.one of
isch · vid · nws · shop · lcl+2 more parameters. See the server's own documentation for the full schema.
hasdata_google_serp_serp_light_getSearchResultsGet Google Light Search Results Google Search scraper served from the lightweight no-JS layout, cheaper and faster than the full SERP API. Returns organic results (title, link, displayed link, snippet, sitelinks, extensions, date, rating and review count), AI Overview with its...12 params
Get Google Light Search Results Google Search scraper served from the lightweight no-JS layout, cheaper and faster than the full SERP API. Returns organic results (title, link, displayed link, snippet, sitelinks, extensions, date, rating and review count), AI Overview with its...
Parameters* required
domainstringGoogle domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`.
filternumberDefines whether to enable or disable the filters for 'Similar Results' and 'Omitted Results'. Set to 1 (default) to enable these filters, or 0 to disable them.
glstringThe two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
hlstringThe two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
locationstringGoogle canonical location for the search.
lrarrayThe 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content.
numnumberNumber of results per page, ranging from 10 to 100.
q*stringSpecify the search term for which you want to scrape the SERP.
safestringAdult Content Filtering option.one of
active · offstartnumberThis parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the seco...
tbsstringThis parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:
- Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021`...
uulestringThe encoded location parameter.
hasdata_google_serp_shopping_getSearchResultsGet Shopping Search Results Scrapes Google Shopping listings for a query with location/uule, country/language/domain, time/date filters, device type, shoprs filter-helper IDs, and offset pagination. Returns product title, price, merchant/source, rating, reviews count, thumbnai...10 params
Get Shopping Search Results Scrapes Google Shopping listings for a query with location/uule, country/language/domain, time/date filters, device type, shoprs filter-helper IDs, and offset pagination. Returns product title, price, merchant/source, rating, reviews count, thumbnai...
Parameters* required
deviceTypestringSpecify the device type for the search.one of
desktop · mobile · tabletdomainstringGoogle domain to use. Default is google.com. Provide one exact documented value (195 allowed), e.g. `google.ac`, `google.ad`.
glstringThe two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
hlstringThe two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
locationstringGoogle canonical location for the search.
q*stringSpecify the search term for which you want to scrape the SERP.
shoprsstringSpecifies the helper ID for applying search filters. Must be used with the updated `q` parameter, which includes the selected filter (e.g., Coffee sale).
To apply filters, use the `hasdata_link` f...
startnumberThis parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 40 refers to the seco...
tbsstringThis parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:
- Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021`...
uulestringThe encoded location parameter.
hasdata_google_serp_short_videos_getShortVideosSearchResultsGet Short Videos Search Results Scrapes the Google Short Videos carousel (TikTok, YouTube Shorts, Instagram Reels, etc.) for a query with location/uule, country (gl/cr), language (hl/lr), device type, and page-based pagination. Supports Google's advanced filters (tbs). Returns...10 params
Get Short Videos Search Results Scrapes the Google Short Videos carousel (TikTok, YouTube Shorts, Instagram Reels, etc.) for a query with location/uule, country (gl/cr), language (hl/lr), device type, and page-based pagination. Supports Google's advanced filters (tbs). Returns...
Parameters* required
crstringThe country code for the country you want to limit the search to. Provide one exact documented value (237 allowed), e.g. `countryAF`, `countryAL`.
deviceTypestringSpecify the device type for the search.one of
desktop · mobile · tabletglstringThe two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
hlstringThe two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
locationstringGoogle canonical location for the search.
lrarrayThe 'lr' parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content.
pagenumberPage number for paginated results, where 0 is the first page.
q*stringSearch query term for retrieving short videos results.
tbsstringGoogle advanced search filters, combined with commas. For example:
- `qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`, `qdr:y` - Show videos from the past hour, day, week, month, or year.
uulestringThe encoded location parameter.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
HASDATA_API_KEY*secretHasData API key, created at app.hasdata.com. 1,000 free credits every month, no card.
Readme
Google Search MCP Server (SERP)
A hosted Google Search MCP server that gives Claude, Cursor, Windsurf and any other MCP client read-only Google Search tools. Pull the live SERP with its AI Overview and People Also Ask, run a Google AI Mode query, and read news, shopping, product detail and short-video results, all as structured JSON, with no Google Cloud project and no search-engine setup.
1,000 free credits every month, no card required, which is 100 full-SERP calls or 200 SERP Light calls.
https://mcp.hasdata.com/mcp?apis=google_serp
Details
- Repository
- github.com/hasdata/google-search-mcp
- Website
- hasdata.com/apis/google-serp-api
- Categories
- Search & Web Crawling, Data & Analytics
- Package
@hasdata/google-search-mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
- Resources
- 10
- Prompts
- 5
- Tools verified
- Nov 6, 2026
