Google News MCP server

📰 Google News API: News Search Results in Clean JSON

The efficient, reliable, and developer-friendly way to use the Google News API.

Actor page: apify.com/johnvc/GoogleNewsAPI Input schema: apify.com/johnvc/GoogleNewsAPI/input-schema

The Google News API searches Google News and returns clean, structured JSON, one item per page of results. Each item carries the search parameters, search metadata (total results, pages processed), and a news_results array where every article includes title, link, source, snippet, and ranking position. Supports location targeting, country and language filtering, safe search, duplicate filtering, and pagination control.

Video Walkthrough

Quick Start

Prerequisites

• Python 3.11 or higher
• An Apify account and API key (get a free key here)

1. Clone the repository

git clone https://github.com/johnisanerd/Apify-Google-News-Scraper.git
   cd Apify-Google-News-Scraper

1. Install dependencies with UV

# Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # Install project dependencies:
   uv sync

1. Configure your API key

cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3

1. Run the example

uv run python google-news-scraper.py

Alternative: set the API key directly

export APIFY_API_TOKEN="your_api_key_here"
uv run python google-news-scraper.py

Why Use This Google News API?

Real-time coverage at scale. Google News aggregates tens of thousands of publishers. Instead of maintaining a client for each outlet, you query the aggregated index and get ranked results across all of them in a single call.

Geo-targeted results. Filter by country code (gl), language (hl), Google domain, and location string for precise control over the geographic and linguistic scope.

Configurable depth. Set max_pages for a quick headline snapshot or a deeper sweep. Each page is returned as a discrete item, easy to stream, filter, or load into a pipeline.

Predictable, pay-per-use pricing. A small per-run setup fee plus a per-page fee, with no subscription. You control cost with the page limit.

Consistent JSON output. Every article comes back with the same fields (title, link, source, snippet, position), so there is no schema variance between publishers.

Easy to automate. Call it from Python in a few lines, or load it as an MCP tool so assistants like Claude and Cursor can pull fresh news for you on demand.

Features

Core Capabilities

• Aggregated news search across thousands of publishers in one call
• Location targeting by country code (gl), language (hl), and Google domain
• Safe search and duplicate filtering toggles
• Auto-correction control with nfpr for exact-match queries
• Pagination control with a configurable page cap

Data Quality

• One item per page with a stable structure
• newsresults array** with title, link, source, snippet, and position per article
• Search metadata (total results, pages processed) on every item
• Echoed search parameters so each item is self-describing
• Consistent JSON shape across every query

Usage Examples

Basic search

{
  "q": "artificial intelligence",
  "max_pages": 1
}

Geo-targeted search with language filtering

{
  "q": "artificial intelligence breakthroughs",
  "google_domain": "google.com",
  "gl": "us",
  "hl": "en",
  "safe": "off",
  "max_pages": 2
}

Input Parameters

Shortened. The full README is on GitHub.