google-news
Skill4 starsChanged 8 months agoApache-2.0View on GitHub
Google News is a free news aggregator by Google that surfaces headlines from thousands of publishers worldwide. Use this skill to fetch top stories, topic feeds, location-specific news, and keyword searches via the public Google News RSS feeds. No API key or authentication is required.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- rocosen/flashdata-mcptheir own version, first seen Oct 17, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- rocosen/flashdata-mcp★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- alph-bot-strategySkill
- kalshiSkill
- manifoldSkill
- metaculusSkill
- noaa-weatherSkill
- openfootballSkill
- polymarketSkill
- shippSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 49
All feed URLs are built by appending paths and query parameters to this base.
- Distinctive: line 55
Every feed URL accepts the following query parameters to control region and language:
- Distinctive: line 168
All feeds return RSS 2.0 XML.
- Distinctive: line 403
If you receive an HTTP 429 response, back off exponentially (e.g., 1 min → 2 min → 4 min).
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Google News RSS API
Google News is a free news aggregator that collects headlines from thousands of publishers around the world. Google exposes its feeds via public RSS 2.0 endpoints that require no authentication or API key.
Base URL
https://news.google.com/rssAll feed URLs are built by appending paths and query parameters to this base.
Query Parameters
Every feed URL accepts the following query parameters to control region and language:
| Parameter | Required | Description | Example |
hl | Yes | Interface language / locale code | en-US, fr, de, ja, pt-BR, es-419 |
gl | Yes | Country / geographic location (ISO 3166-1 alpha-2) | US, GB, IN, DE, JP, BR |
ceid | Yes | Compound locale key in the form {gl}:{language} | US:en, GB:en, DE:de, JP:ja, BR:pt-419 |
Important: All three parameters should be consistent. Mismatched values may return unexpected or empty results.
Supported Locations (Validated)
The following locations have been tested and confirmed to return valid RSS feeds (HTTP 200):
| Location | hl | gl | ceid | Example URL |
| 🇺🇸 United States | en-US | US | US:en | https://news.google.com/rss?hl=en-US&gl=US&ceid=US:en |
| 🇬🇧 United Kingdom | en-GB | GB | GB:en | https://news.google.com/rss?hl=en-GB&gl=GB&ceid=GB:en |
| 🇮🇳 India | en-IN | IN | IN:en | https://news.google.com/rss?hl=en-IN&gl=IN&ceid=IN:en |
| 🇦🇺 Australia | en-AU | AU | AU:en | https://news.google.com/rss?hl=en-AU&gl=AU&ceid=AU:en |
| 🇨🇦 Canada | en-CA | CA | CA:en | https://news.google.com/rss?hl=en-CA&gl=CA&ceid=CA:en |
| 🇩🇪 Germany | de | DE | DE:de | https://news.google.com/rss?hl=de&gl=DE&ceid=DE:de |
| 🇫🇷 France | fr | FR | FR:fr | https://news.google.com/rss?hl=fr&gl=FR&ceid=FR:fr |
| 🇯🇵 Japan | ja | JP | JP:ja | https://news.google.com/rss?hl=ja&gl=JP&ceid=JP:ja |
| 🇧🇷 Brazil | pt-BR | BR | BR:pt-419 | https://news.google.com/rss?hl=pt-BR&gl=BR&ceid=BR:pt-419 |
| 🇲🇽 Mexico | es-419 | MX | MX:es-419 | https://news.google.com/rss?hl=es-419&gl=MX&ceid=MX:es-419 |
| 🇮🇱 Israel | en-IL | IL | IL:en | https://news.google.com/rss?hl=en-IL&gl=IL&ceid=IL:en |
Feed Types
1. Top Stories (Headlines)
Returns the current top stories for a given location.
URL pattern:
https://news.google.com/rss?hl={hl}&gl={gl}&ceid={gl}:{lang}Example — US top stories:
https://news.google.com/rss?hl=en-US&gl=US&ceid=US:en2. Topic Feeds
Returns articles for a specific news topic / section.
URL pattern:
https://news.google.com/rss/topics/{TOPIC_ID}?hl={hl}&gl={gl}&ceid={gl}:{lang}Known Topic IDs (English, US):
| Topic | Topic ID |
| World | CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx1YlY4U0FtVnVHZ0pWVXlnQVAB |
| Nation / U.S. | CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjU0FtVnVLQUFQAQ |
| Business | CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx6TVdZU0FtVnVHZ0pWVXlnQVAB |
| Technology | CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB |
| Entertainment | CAAqJggKIiBDQkFTRWdvSUwyMHZNREpxYW5RU0FtVnVHZ0pWVXlnQVAB |
| Sports | CAAqJggKIiBDQkFTRWdvSUwyMHZNRFp1ZEdvU0FtVnVHZ0pWVXlnQVAB |
| Science | CAAqJggKIiBDQkFTRWdvSUwyMHZNRFp0Y1RjU0FtVnVHZ0pWVXlnQVAB |
| Health | CAAqIQgKIhtDQkFTRGdvSUwyMHZNR3QwTlRFU0FtVnVLQUFQAQ |
Example — Technology news (US):
https://news.google.com/rss/topics/CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB?hl=en-US&gl=US&ceid=US:enNote: Topic IDs are base64-encoded protocol buffer strings. They can differ by language/region. The IDs above are for
en-US. To find topic IDs for other locales, inspect the RSS link on the Google News website for that locale.
3. Keyword / Search Feeds
Returns articles matching a search query.
URL pattern:
https://news.google.com/rss/search?q={query}&hl={hl}&gl={gl}&ceid={gl}:{lang}Query modifiers:
| Modifier | Description | Example |
+ or space | AND (default) | q=artificial+intelligence |
OR | OR operator | q=Tesla+OR+SpaceX |
- | Exclude term | q=Apple+-fruit |
"..." | Exact phrase (URL-encode the quotes) | q=%22climate+change%22 |
when:7d | Time filter — last N days/hours | q=Bitcoin+when:7d |
when:1h | Time filter — last 1 hour | q=breaking+news+when:1h |
after:YYYY-MM-DD | Articles after a date | q=Olympics+after:2024-07-01 |
before:YYYY-MM-DD | Articles before a date | q=Olympics+before:2024-08-15 |
site: | Restrict to a domain | q=AI+site:reuters.com |
Example — search for "artificial intelligence" in the last 7 days:
https://news.google.com/rss/search?q=artificial+intelligence+when:7d&hl=en-US&gl=US&ceid=US:enRSS Response Format
All feeds return RSS 2.0 XML. Here is the general structure:
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
<channel>
<generator>NFE/5.0</generator>
<title>Top stories - Google News</title>
<link>https://news.google.com/?hl=en-US&gl=US&ceid=US:en</link>
<language>en-US</language>
<webMaster>news-webmaster@google.com</webMaster>
<copyright>...</copyright>
<lastBuildDate>Wed, 18 Feb 2026 20:50:00 GMT</lastBuildDate>
<item>
<title>Article headline - Publisher Name</title>
<link>https://news.google.com/rss/articles/...</link>
<guid isPermaLink="true">https://news.google.com/rss/articles/...</guid>
<pubDate>Wed, 18 Feb 2026 19:05:07 GMT</pubDate>
<description>
<!-- HTML ordered list of related articles -->
<ol>
<li><a href="...">Article Title</a> <font color="#6f6f6f">Publisher</font></li>
...
</ol>
</description>
<source url="https://publisher-domain.com">Publisher Name</source>
</item>
<!-- more <item> elements -->
</channel>
</rss>Key Fields per <item>
| Field | Description |
<title> | Headline text followed by - Publisher Name |
<link> | Google News redirect URL. Visiting it in a browser redirects to the actual article. |
<guid> | Unique identifier (same as <link>) |
<pubDate> | Publication date in RFC 2822 format |
<description> | HTML snippet containing an ordered list (<ol>) of related/clustered articles with links and publisher names |
<source url="..."> | Publisher name and homepage URL |
Common Patterns
Fetch Top Headlines (curl + grep)
curl -s "https://news.google.com/rss?hl=en-US&gl=US&ceid=US:en" \
| grep -oP '<title>\K[^<]+'Fetch Top Headlines (Python)
import feedparser
feed = feedparser.parse(
"https://news.google.com/rss?hl=en-US&gl=US&ceid=US:en"
)
for entry in feed.entries:
print(f"{entry.published} — {entry.title}")
print(f" Link: {entry.link}")
print()Fetch Topic Feed (curl + xmllint)
TOPIC="CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB"
curl -s "https://news.google.com/rss/topics/${TOPIC}?hl=en-US&gl=US&ceid=US:en" \
| xmllint --xpath '//item/title/text()' -Search for Articles (Python)
import feedparser
import urllib.parse
query = urllib.parse.quote("artificial intelligence when:7d")
url = f"https://news.google.com/rss/search?q={query}&hl=en-US&gl=US&ceid=US:en"
feed = feedparser.parse(url)
for entry in feed.entries[:10]:
print(f"• {entry.title}")Fetch News for a Specific Location (Node.js)
const https = require("https");
const { parseStringPromise } = require("xml2js");
const url =
"https://news.google.com/rss?hl=en-GB&gl=GB&ceid=GB:en";
https.get(url, (res) => {
let data = "";
res.on("data", (chunk) => (data += chunk));
res.on("end", async () => {
const result = await parseStringPromise(data);
const items = result.rss.channel[0].item || [];
items.slice(0, 10).forEach((item) => {
console.log(item.title[0]);
});
});
});Extract Related Articles from Description (Python)
import feedparser
from html.parser import HTMLParser
class RelatedParser(HTMLParser):
def __init__(self):
super().__init__()
self.articles = []
self._in_a = False
self._href = ""
self._text = ""
def handle_starttag(self, tag, attrs):
if tag == "a":
self._in_a = True
self._href = dict(attrs).get("href", "")
self._text = ""
def handle_endtag(self, tag):
if tag == "a" and self._in_a:
self.articles.append({"title": self._text, "link": self._href})
self._in_a = False
def handle_data(self, data):
if self._in_a:
self._text += data
feed = feedparser.parse(
"https://news.google.com/rss?hl=en-US&gl=US&ceid=US:en"
)
for entry in feed.entries[:3]:
print(f"\n=== {entry.title} ===")
parser = RelatedParser()
parser.feed(entry.description)
for art in parser.articles:
print(f" • {art['title']}")
print(f" {art['link']}")Build a Multi-Region News Aggregator (Python)
import feedparser
REGIONS = {
"US": "hl=en-US&gl=US&ceid=US:en",
"UK": "hl=en-GB&gl=GB&ceid=GB:en",
"DE": "hl=de&gl=DE&ceid=DE:de",
"JP": "hl=ja&gl=JP&ceid=JP:ja",
"BR": "hl=pt-BR&gl=BR&ceid=BR:pt-419",
}
for region, params in REGIONS.items():
feed = feedparser.parse(f"https://news.google.com/rss?{params}")
print(f"\n--- {region} Top 3 ---")
for entry in feed.entries[:3]:
print(f" • {entry.title}")Monitor a Topic with Polling (bash)
#!/usr/bin/env bash
FEED="https://news.google.com/rss/search?q=breaking+news+when:1h&hl=en-US&gl=US&ceid=US:en"
SEEN_FILE="/tmp/gnews_seen.txt"
touch "$SEEN_FILE"
while true; do
curl -s "$FEED" | grep -oP '<guid[^>]*>\K[^<]+' | while read -r guid; do
if ! grep -qF "$guid" "$SEEN_FILE"; then
echo "$guid" >> "$SEEN_FILE"
TITLE=$(curl -s "$FEED" | grep -oP "<item>.*?<guid[^>]*>${guid}.*?</item>" \
| grep -oP '<title>\K[^<]+' | head -1)
echo "[NEW] $TITLE"
fi
done
sleep 120
doneResolving Google News Redirect URLs
Article links in the RSS feed point to https://news.google.com/rss/articles/... which redirect (HTTP 302/303) to the actual publisher URL. To resolve the final URL:
curl
curl -Ls -o /dev/null -w '%{url_effective}' \
"https://news.google.com/rss/articles/CBMiWkFV..."Python
import requests
response = requests.head(
"https://news.google.com/rss/articles/CBMiWkFV...",
allow_redirects=True,
timeout=10,
)
print(response.url) # final publisher URLRate Limits
Google does not publish official rate limits for the RSS feeds. Based on community observations:
| Guideline | Recommendation |
| Polling interval | ≥ 60 seconds between requests for the same feed |
| Concurrent requests | Keep below ~10 concurrent connections |
| Burst behavior | Rapid bursts may trigger HTTP 429 or CAPTCHA challenges |
| User-Agent | Use a descriptive User-Agent; empty or bot-like strings may be blocked |
If you receive an HTTP 429 response, back off exponentially (e.g., 1 min → 2 min → 4 min).
Error Handling
| HTTP Status | Meaning | Action |
| 200 | Success | Parse the RSS XML |
| 301/302 | Redirect | Follow the redirect (most HTTP clients do this automatically) |
| 404 | Feed not found | Check the URL, topic ID, or locale parameters |
| 429 | Rate limited | Back off and retry after a delay |
| 5xx | Server error | Retry with exponential backoff |
Tips
- No auth needed — all feeds are fully public. Start fetching immediately.
- Use
feedparserin Python — it handles RSS parsing, date normalization, and encoding edge cases. - Combine search modifiers —
q=Tesla+site:reuters.com+when:30dfor precise results. - Topic IDs are locale-specific — an English topic ID may not work with
hl=de. Inspect the Google News page in that locale to find the correct ID. - The
<description>field is HTML — it contains clustered/related articles as an<ol>list. Parse the HTML to extract multiple sources per story. - The
<title>includes the publisher — the format isHeadline text - Publisher Name. Split on-(space-dash-space) from the right to separate them. - Feed results are limited — Google typically returns ~100 items per feed. Use search with date filters to paginate through older results.
- Respect the copyright notice — Google's RSS feeds are intended for personal, non-commercial use in feed readers. Review Google's terms for other uses.
- Resolve redirects lazily — only resolve the Google redirect URL to the publisher URL when you actually need the final link. This saves requests.
- Set a proper User-Agent — e.g.,
User-Agent: MyNewsBot/1.0 (contact@example.com). Some environments may get blocked without one.
Changelog
- 0.1.0 — Initial release with top stories, topic feeds, search feeds, multi-region support, and common usage patterns.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

