google-news

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.

outsharp/shipp-skillsUpdated May 11, 2026

Works with

Claude CodeCursorClineWindsurfCodexGooseGitHub CopilotZed

1

total installs

1

this week

4

GitHub stars

0

upvotes

Install Skill

Run in your terminal

$npx skills add https://github.com/outsharp/shipp-skills --skill google-news

1

installs

1

this week

4

stars

Installation Guide

How to use google-news on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your machine
  • Node.js 16+ with npm — verify with node --version
  • Active project directory where you want to add google-news
2

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/outsharp/shipp-skills --skill google-news

Fetches google-news from outsharp/shipp-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ────────────────
│ · Cline · Codex · Goose · Windsurf
│ ●Cursor(selected)
│ · Cursor · Aider · Continue
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/google-news

Restart Cursor to activate google-news. Access via /google-news in your agent's command palette.

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

Documentation

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/rss

All 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:en

2. 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:en

Note: 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:en

RSS 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&amp;gl=US&amp;ceid=US:en</link>
    <language>en-US</language>
    <webMaster>[email protected]</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>&nbsp;&nbsp;<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)

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Steps

  1. 1Install skill using provided installation command
  2. 2Test with simple use case relevant to your work
  3. 3Evaluate output quality and relevance
  4. 4Iterate on prompts to improve results
  5. 5Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use when

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid when

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Related Skills

Reviews

4.633 reviews
  • P
    Pratham WareDec 24, 2024

    Solid pick for teams standardizing on skills: google-news is focused, and the summary matches what you get after install.

  • W
    William GillDec 4, 2024

    Solid pick for teams standardizing on skills: google-news is focused, and the summary matches what you get after install.

  • S
    Sophia DixitNov 23, 2024

    We added google-news from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Y
    Yash ThakkerNov 15, 2024

    We added google-news from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • D
    Daniel KapoorNov 11, 2024

    Solid pick for teams standardizing on skills: google-news is focused, and the summary matches what you get after install.

  • S
    Sophia KapoorOct 14, 2024

    google-news fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • D
    Dhruvi JainOct 6, 2024

    google-news fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • W
    William GuptaOct 2, 2024

    google-news has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • O
    OshnikdeepSep 25, 2024

    Registry listing for google-news matched our evaluation — installs cleanly and behaves as described in the markdown.

  • P
    Piyush GSep 21, 2024

    google-news is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

showing 1-10 of 33

1 / 4

Discussion

Comments — not star reviews
  • No comments yet — start the thread.