x402serps

Working · 140 ms Security A

com.x402serps/searchv1.3.0 Domain verified

Pay-per-call Google search from $0.004, cited answers, crawl, research, SEO and leads via x402.

Web Search Marketing & SEO

Watch Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://x402serps.com/api/mcp

X-Trial (optional)

Set to 1 to use the free trial (25 calls per network, 10/min).

X-PAYMENT (optional)

x402 payment payload (USDC on Base or Solana) for paid tool calls.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

ai_visibility_check Read-only

For 1-10 keywords, report where a brand/domain ranks in search results plus AI Overview, answer box, People Also Ask and knowledge graph presence, top competitors and a 0-100 score. Paid via x402 ($0.10 USDC flat on Base or Solana); send X-PAYMENT. Not in the free trial.

brandstring, required

keywordsarray, required

glstring

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

Run in a terminal

claude mcp add --transport http search https://x402serps.com/api/mcp

Headers

X-Trial (optional, not in the config above): Set to 1 to use the free trial (25 calls per network, 10/min).
X-PAYMENT (optional, not in the config above): x402 payment payload (USDC on Base or Solana) for paid tool calls.

Tools (19)

Tool list last changed Nov 3, 2026.

ai_visibility_check

read-only

Argument	Type	Description
gl	string
brand*	string
keywords*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "brand",
    "keywords"
  ],
  "properties": {
    "gl": {
      "type": "string"
    },
    "brand": {
      "type": "string"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1
    }
  }
}

answer

cited answer — web search, read the top pages, and return a short answer with numbered citations (currently uses extractive summaries). Paid via x402 ($0.02 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.

read-only

Argument	Type	Description
n	number	Pages to read 2-6, default 4
q	string	Question (alias: query)
gl	string	Country code
query	string
freshness	string	hour, day, week, month or year

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "n": {
      "type": "number",
      "description": "Pages to read 2-6, default 4"
    },
    "q": {
      "type": "string",
      "description": "Question (alias: query)"
    },
    "gl": {
      "type": "string",
      "description": "Country code"
    },
    "query": {
      "type": "string"
    },
    "freshness": {
      "type": "string",
      "description": "hour, day, week, month or year"
    }
  }
}

batch_search

Up to 25 Web searches in one call via x402 ($0.08 USDC on base). Pass an x402 payment in the X-PAYMENT header.

read-only

Argument	Type	Description
num	number
queries*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "queries"
  ],
  "properties": {
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1
    },
    "queries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 25,
      "minItems": 1
    }
  }
}

competitor_report

competitor report — for a domain and 1-8 keywords: search rankings, ads/advertisers, SERP features, share of voice, top competitors with their top pages, and the domain's own top pages. Paid via x402 ($0.30 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.

read-only

Argument	Type	Description
gl	string	Country code, default us
domain*	string	Your domain, e.g. example.com
keywords*	array	1-8 keywords

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "keywords"
  ],
  "properties": {
    "gl": {
      "type": "string",
      "description": "Country code, default us"
    },
    "domain": {
      "type": "string",
      "description": "Your domain, e.g. example.com"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "1-8 keywords"
    }
  }
}

crawl_site

crawl a website — breadth-first from a start URL on the same host, returning clean markdown for up to 50 pages; priced per page of the requested limit. Paid via x402 ($0.002 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.

read-only

Argument	Type	Description
url*	string	Start URL
limit	number	Max pages 1-50, default 10 (you are charged for the limit)
include	string	Only follow paths containing this substring
maxChars	number	Max chars per page, default 8000

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Start URL"
    },
    "limit": {
      "type": "number",
      "description": "Max pages 1-50, default 10 (you are charged for the limit)"
    },
    "include": {
      "type": "string",
      "description": "Only follow paths containing this substring"
    },
    "maxChars": {
      "type": "number",
      "description": "Max chars per page, default 8000"
    }
  }
}

deep_research

Search the web, read the top 3-8 pages in parallel and return a concise cited brief with source excerpts. Paid via x402 ($0.08 USDC on Base or Solana); send X-PAYMENT. Not in the free trial. Set answer: true for an LLM-written cited answer.

read-only

Argument	Type	Description
n	number
q	string
query	string
answer	boolean
maxChars	number

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "n": {
      "type": "number",
      "maximum": 8,
      "minimum": 3
    },
    "q": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "answer": {
      "type": "boolean"
    },
    "maxChars": {
      "type": "number"
    }
  }
}

extract

Fetch a public URL and return clean markdown via x402 ($0.003 USDC on base). Pass an x402 payment in the X-PAYMENT header. Pass urls (up to 20) instead of url to fetch several pages in parallel, charged per URL.

read-only

Argument	Type	Description
url	string
urls	array
maxChars	number

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20
    },
    "maxChars": {
      "type": "number"
    }
  }
}

image_search

Image results (title, page url, imageUrl, thumbnail, size) for one query, up to 20. Paid via x402 ($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.

read-only

Argument	Type	Description
q	string
gl	string
num	number
query	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string"
    }
  }
}

lead_finder

local lead finder — Maps/places businesses for a query and location (up to 20) enriched with business contact details only (role emails such as info@/sales@, business phones, social links; personal-looking emails dropped; opt-outs honoured) extracted from each business website and contact page. Paid via x402 ($0.25 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.

read-only

Argument	Type	Description
q	string	Business type, e.g. dentists (alias: query)
gl	string	Country code
num	number	Businesses 1-20, default 20
query	string
location	string	e.g. Leeds, United Kingdom

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "q": {
      "type": "string",
      "description": "Business type, e.g. dentists (alias: query)"
    },
    "gl": {
      "type": "string",
      "description": "Country code"
    },
    "num": {
      "type": "number",
      "description": "Businesses 1-20, default 20"
    },
    "query": {
      "type": "string"
    },
    "location": {
      "type": "string",
      "description": "e.g. Leeds, United Kingdom"
    }
  }
}

map_site

map a website — discover up to 1000 URLs on a domain from robots.txt sitemaps and on-page links (flat price). Paid via x402 ($0.002 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.

read-only

Argument	Type	Description
url*	string	Site URL or domain
limit	number	Max URLs 1-1000, default 200
search	string	Only return URLs containing this substring

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Site URL or domain"
    },
    "limit": {
      "type": "number",
      "description": "Max URLs 1-1000, default 200"
    },
    "search": {
      "type": "string",
      "description": "Only return URLs containing this substring"
    }
  }
}

news_digest

news digest — News for 1-5 topics, deduplicated, with top sources per topic and a compact text digest; optional since=hour|day|week|month. Paid via x402 ($0.05 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.

read-only

Argument	Type	Description
gl	string	Country code
num	number	Items per topic 3-20, default 10
since	string	hour, day, week or month
topics*	array	1-5 topics

Input schema (JSON)

{
  "type": "object",
  "required": [
    "topics"
  ],
  "properties": {
    "gl": {
      "type": "string",
      "description": "Country code"
    },
    "num": {
      "type": "number",
      "description": "Items per topic 3-20, default 10"
    },
    "since": {
      "type": "string",
      "description": "hour, day, week or month"
    },
    "topics": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "1-5 topics"
    }
  }
}

news_search

Paid News search via x402 ($0.004 USDC on base). Pass an x402 payment in the X-PAYMENT header. Supports freshness (hour/day/week/month/year), dateFrom/dateTo, page and num up to 100.

read-only

Argument	Type	Description
q	string
gl	string
hl	string
num	number
page	number
query	string
dateTo	string	YYYY-MM-DD
dateFrom	string	YYYY-MM-DD
freshness	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "hl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 100,
      "minimum": 1
    },
    "page": {
      "type": "number",
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string"
    },
    "dateTo": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "dateFrom": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "freshness": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string"
    }
  }
}

places_search

Maps/places results (name, address, rating, phone, website, lat/lng) for one query, up to 20. Paid via x402 ($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.

read-only

Argument	Type	Description
q	string
gl	string
num	number
query	string
location	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string"
    },
    "location": {
      "type": "string"
    }
  }
}

scholar_search

Scholar results (title, url, snippet, publication, year, citations, pdf) for one query, up to 20. Paid via x402 ($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.

read-only

Argument	Type	Description
q	string
gl	string
num	number
query	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string"
    }
  }
}

search_extract

Web search plus clean markdown of the top N results (1-5) via x402 ($0.02 USDC on base). Pass an x402 payment in the X-PAYMENT header.

read-only

Argument	Type	Description
n	number
q	string
query	string
maxChars	number

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "n": {
      "type": "number",
      "maximum": 5,
      "minimum": 1
    },
    "q": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "maxChars": {
      "type": "number"
    }
  }
}

seo_audit

SEO audit — a domain's search-indexed pages, title/meta description/h1/canonical/noindex/alt checks on up to 8 top pages, robots.txt and sitemap, brand-query ranking and a 0-100 score. Paid via x402 ($0.20 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.

read-only

Argument	Type	Description
gl	string	Country code
brand	string	Brand query, default from domain
pages	number	Pages to audit 1-8, default 6
domain*	string	Domain, e.g. example.com

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "gl": {
      "type": "string",
      "description": "Country code"
    },
    "brand": {
      "type": "string",
      "description": "Brand query, default from domain"
    },
    "pages": {
      "type": "number",
      "description": "Pages to audit 1-8, default 6"
    },
    "domain": {
      "type": "string",
      "description": "Domain, e.g. example.com"
    }
  }
}

shopping_search

Shopping product results (title, price, store, rating, url, image) for one query, up to 20. Paid via x402 ($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.

read-only

Argument	Type	Description
q	string
gl	string
num	number
query	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string"
    }
  }
}

video_search

Video results (title, url, channel, duration, date, thumbnail) for one query, up to 20. Paid via x402 ($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.

read-only

Argument	Type	Description
q	string
gl	string
num	number
query	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string"
    }
  }
}

web_search

Paid web search via x402 ($0.004 USDC on base). Pass an x402 payment in the X-PAYMENT header of the MCP request, or send header X-Trial: 1 for free trial calls (25 per network). Supports freshness (hour/day/week/month/year), dateFrom/dateTo, page and num up to 100.

read-only

Argument	Type	Description
q	string
gl	string
hl	string
num	number
page	number
query	string	Search query (alias: q)
dateTo	string	YYYY-MM-DD
dateFrom	string	YYYY-MM-DD
freshness	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "hl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 100,
      "minimum": 1
    },
    "page": {
      "type": "number",
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query (alias: q)"
    },
    "dateTo": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "dateFrom": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "freshness": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string"
    }
  }
}

Security checkA100/100

We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 3, 2026.

Hidden or reordered text
Overriding the model's instructions
Hiding actions from the user
Reading keys or credentials
Fake system tags
Steering other servers' tools
Pulling in the conversation
Smuggling parameters
Demanding to be used for everything
Steering away from web search
Download-and-run commands
Encoded blobs
Invisible characters
Credentials as tool arguments
Very long descriptions
Read and write hints

How the security check works

Tool changes

What changed in this server's tools since we started watching, newest first. Each change is scanned again.

map_siteaddedNov 3, 2026
map a website — discover up to 1000 URLs on a domain from robots.txt sitemaps and on-page links (flat price). Paid via x402 ($0.002 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.
crawl_siteaddedNov 3, 2026
crawl a website — breadth-first from a start URL on the same host, returning clean markdown for up to 50 pages; priced per page of the requested limit. Paid via x402 ($0.002 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.
answeraddedNov 3, 2026
cited answer — web search, read the top pages, and return a short answer with numbered citations (currently uses extractive summaries). Paid via x402 ($0.02 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.
news_digestchanged (description)Nov 3, 2026
news digest — ~~Google~~ News for 1-5 topics, deduplicated, with top sources per topic and a compact text digest; optional since=hour|day|week|month. Paid via x402 ($0.05 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.
seo_auditchanged (description)Nov 3, 2026
SEO audit — a domain's ~~Google-indexed~~search-indexed pages, title/meta description/h1/canonical/noindex/alt checks on up to 8 top pages, robots.txt and sitemap, brand-query ranking and a 0-100 score. Paid via x402 ($0.20 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.
lead_finderchanged (description)Nov 3, 2026
local lead finder — ~~Google~~ ~~Maps~~Maps/places businesses for a query and location (up to 20) enriched with ~~emails,~~business ~~phones~~contact ~~and~~details only (role emails such as info@/sales@, business phones, social ~~links~~links; personal-looking emails dropped; opt-outs honoured) extracted from each business website and contact page. Paid via x402 ($0.25 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.
competitor_reportchanged (description)Nov 3, 2026
competitor report — for a domain and 1-8 keywords: ~~Google~~search rankings, ads/advertisers, SERP features, share of voice, top competitors with their top pages, and the domain's own top pages. Paid via x402 ($0.30 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.
ai_visibility_checkchanged (description)Nov 3, 2026
For 1-10 keywords, report where a brand/domain ranks onin ~~Google~~search results plus AI Overview, answer box, People Also Ask and knowledge graph presence, top competitors and a 0-100 score. Paid via x402 ($0.10 USDC flat on Base or Solana); send X-PAYMENT. Not in the free trial.

deep_researchchanged (description, inputs)Nov 3, 2026

Search ~~Google,~~the web, read the top 3-8 pages in parallel and return a concise cited brief with source excerpts. Paid via x402 ($0.08 USDC on Base or Solana); send X-PAYMENT. Not in the free trial. Set answer: true for an LLM-written cited answer.

{
  "type": "object",
  "properties": {
    "n": {
      "type": "number",
      "maximum": 8,
      "minimum": 3
    },
    "q": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "maxChars": {
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "n": {
      "type": "number",
      "maximum": 8,
      "minimum": 3
    },
    "q": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "answer": {
      "type": "boolean"
    },
    "maxChars": {
      "type": "number"
    }
  }
}

video_searchchanged (description)Nov 3, 2026
~~Google~~ ~~Videos~~Video results (title, url, channel, duration, date, thumbnail) for one query, up to 20. Paid via x402 ~~($0.01~~($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.
scholar_searchchanged (description)Nov 3, 2026
~~Google~~ Scholar results (title, url, snippet, publication, year, citations, pdf) for one query, up to 20. Paid via x402 ~~($0.01~~($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.
shopping_searchchanged (description)Nov 3, 2026
~~Google~~ Shopping product results (title, price, store, rating, url, image) for one query, up to 20. Paid via x402 ~~($0.01~~($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.
places_searchchanged (description)Nov 3, 2026
~~Google~~ ~~Maps/Places~~Maps/places results (name, address, rating, phone, website, lat/lng) for one query, up to 20. Paid via x402 ~~($0.01~~($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.
image_searchchanged (description)Nov 3, 2026
~~Google~~ ~~Images~~Image results (title, page url, imageUrl, thumbnail, size) for one query, up to 20. Paid via x402 ~~($0.01~~($0.004 USDC on Base or Solana); send X-PAYMENT, or X-Trial: 1 for free trial calls.
batch_searchchanged (description)Nov 3, 2026
Up to 25 ~~Google~~ ~~web~~Web searches in one call via x402 ~~($0.15~~($0.08 USDC on base). Pass an x402 payment in the X-PAYMENT header.
search_extractchanged (description)Nov 3, 2026
~~Google~~ ~~web~~Web search plus clean markdown of the top N results (1-5) via x402 ($0.02 USDC on base). Pass an x402 payment in the X-PAYMENT header.

extractchanged (description, inputs)Nov 3, 2026

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "maxChars": {
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20
    },
    "maxChars": {
      "type": "number"
    }
  }
}

news_searchchanged (description, inputs)Nov 3, 2026

Paid ~~Google~~ News search via x402 ~~($0.01~~($0.004 USDC on base). Pass an x402 payment in the X-PAYMENT header. Supports freshness (hour/day/week/month/year), dateFrom/dateTo, page and num up to 100.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "hl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 100,
      "minimum": 1
    },
    "page": {
      "type": "number",
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string"
    },
    "dateTo": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "dateFrom": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "freshness": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string"
    }
  }
}

web_searchchanged (description, inputs)Nov 3, 2026

Paid web search via x402 ~~($0.01~~($0.004 USDC on base). Pass an x402 payment in the X-PAYMENT header of the MCP request, or send header X-Trial: 1 for free trial calls (25 per network). Supports freshness (hour/day/week/month/year), dateFrom/dateTo, page and num up to 100.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 20,
      "minimum": 1,
      "description": "Results, default 10"
    },
    "query": {
      "type": "string",
      "description": "Search query (alias: q)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "gl": {
      "type": "string"
    },
    "hl": {
      "type": "string"
    },
    "num": {
      "type": "number",
      "maximum": 100,
      "minimum": 1
    },
    "page": {
      "type": "number",
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query (alias: q)"
    },
    "dateTo": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "dateFrom": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "freshness": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string"
    }
  }
}

news_digestaddedNov 3, 2026
news digest — Google News for 1-5 topics, deduplicated, with top sources per topic and a compact text digest; optional since=hour|day|week|month. Paid via x402 ($0.05 USDC on Base or Solana; send X-PAYMENT) or a prepaid credit key (Authorization: Bearer xs_...). Not in the free trial.