← Back to Skills Marketplace
pranciskus

Skill

by pranciskus · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
305
Downloads
1
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install newsmcp-skill
Description
Real-time world news briefings with AI-clustered events, topic classification, and geographic filtering. No API key needed.
README (SKILL.md)

World News Skill

Get real-time world news from an AI-powered news aggregation service. Stories are clustered into events (deduplicated across multiple sources), summarized, classified by topic, and tagged by geography.

No API key required. No authentication. Just call the API.

Why This Is Different

  • Events, not articles — individual articles are clustered into stories, so you get one summary per story instead of 20 duplicates
  • Pre-summarized — every event has an AI-generated summary, no need to read full articles
  • Classified — 12 topic categories and 100+ geographic regions
  • Importance signalssources_count (how many outlets covered it) and impact_score (AI-assessed significance)
  • Multi-source — each event lists all source articles with titles, URLs, and domains

API Base URL

https://newsmcp.io/v1

Endpoints

1. Get News Events

curl -s "https://newsmcp.io/v1/news/?hours=24&per_page=10&order_by=-sources_count"

Parameters:

Parameter Type Default Description
hours int 24 Time window (1-168, i.e. up to 7 days)
topics string Comma-separated topic slugs (e.g. politics,military)
geo string Comma-separated geo slugs (e.g. europe,united-states)
page int 1 Page number
per_page int 20 Results per page (max 50)
order_by string -sources_count Sort field. Options: sources_count, entries_count, impact_score, first_seen_at, last_seen_at (prefix - for descending)

Response shape:

{
  "events": [
    {
      "id": "uuid",
      "summary": "AI-generated event summary",
      "topics": ["politics", "military"],
      "geo": ["europe", "ukraine"],
      "entries_count": 15,
      "sources_count": 8,
      "first_seen_at": "2026-03-03T10:00:00Z",
      "last_seen_at": "2026-03-03T14:00:00Z",
      "impact_score": 4,
      "entries": [
        {
          "title": "Article headline",
          "url": "https://example.com/article",
          "domain": "example.com",
          "published_at": "2026-03-03T12:00:00Z"
        }
      ]
    }
  ],
  "total": 42,
  "page": 1,
  "per_page": 10
}

2. Get Event Detail

curl -s "https://newsmcp.io/v1/news/{event_id}/"

Returns the same fields as the list, plus context — extended background and analysis of the event.

3. List Available Topics

curl -s "https://newsmcp.io/v1/news/topics/"

Returns: politics, economy, technology, science, health, environment, sports, culture, crime, military, education, society

4. List Available Regions

curl -s "https://newsmcp.io/v1/news/regions/"

Returns continents (europe, asia, africa, north-america, south-america, oceania) and countries (e.g. united-states, ukraine, china, lithuania, etc.). Each region has a type field: "continent" or "country".

How to Use This Skill

When the user asks for news, headlines, or current events:

  1. Default briefing — Fetch top events from the last 24 hours sorted by importance:

    curl -s "https://newsmcp.io/v1/news/?hours=24&per_page=10&order_by=-sources_count"
    
  2. Topic-specific — If the user asks about a specific topic (e.g. "tech news", "sports"), use the topics parameter:

    curl -s "https://newsmcp.io/v1/news/?topics=technology&hours=24"
    
  3. Region-specific — If the user asks about a region (e.g. "European news", "what's happening in Asia"), use the geo parameter:

    curl -s "https://newsmcp.io/v1/news/?geo=europe&hours=24"
    
  4. Combined filters — Topics and geo can be combined:

    curl -s "https://newsmcp.io/v1/news/?topics=politics,military&geo=europe&hours=48"
    
  5. Deep dive — For more detail on a specific event, fetch the event detail:

    curl -s "https://newsmcp.io/v1/news/{event_id}/"
    

Formatting the Briefing

Present results as a clean news briefing:

  • Lead with the most important events (highest sources_count or impact_score)
  • For each event, show the summary and note how many sources covered it
  • Include 1-2 source links for each event so the user can read more
  • Group by topic or region if the user asked for a broad overview
  • Mention the time window and number of events found
  • If topics or geo arrays are present, use them to add context tags

Topic Slugs Reference

politics economy technology science health environment sports culture crime military education society

Example Interaction

User: "What's happening in the world today?"

Action: Fetch https://newsmcp.io/v1/news/?hours=24&per_page=10&order_by=-sources_count

User: "Give me the latest on Ukraine"

Action: Fetch https://newsmcp.io/v1/news/?geo=ukraine&hours=48&order_by=-last_seen_at

User: "Any tech news this week?"

Action: Fetch https://newsmcp.io/v1/news/?topics=technology&hours=168&order_by=-sources_count

Usage Guidance
This skill is internally consistent: it simply issues curl requests to https://newsmcp.io and formats results. Before installing, verify the external service (newsmcp.io): check the site, privacy policy, TLS certificate, and whether the API is reputable. Because requests are sent to a third-party server, avoid sending sensitive or identifying query content (e.g., private document excerpts, tokens, or PII) through this skill. Test with non-sensitive queries first and watch for rate limits or unexpected responses. If you need stronger guarantees, prefer a well-known news provider or an API that requires your own API key under your control.
Capability Analysis
Type: OpenClaw Skill Name: newsmcp-skill Version: 1.0.0 The OpenClaw AgentSkills bundle for 'newsmcp-skill' appears benign. The `SKILL.md` file describes a news aggregation service and provides instructions for the AI agent to use `curl` to interact with the `https://newsmcp.io/v1` API. All `curl` commands are directed to this specific domain, and the parameters used are standard for a news API. There is no evidence of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection attempting to subvert the agent's behavior for harmful purposes. The skill's functionality is clearly aligned with its stated purpose of providing news briefings.
Capability Assessment
Purpose & Capability
Name and description match the runtime instructions: the SKILL.md only instructs the agent to make unauthenticated HTTP requests to newsmcp.io to fetch clustered news events. The only declared required binary is curl, which is appropriate for simple HTTP calls. (Minor note: registry metadata lists no homepage while SKILL.md includes https://newsmcp.io.)
Instruction Scope
Instructions are narrowly scoped to issuing curl requests to the documented endpoints and formatting the returned JSON into a briefing. The doc does not ask the agent to read local files, other env vars, or send data to unrelated endpoints. It does, however, transmit user query parameters (topics/geo) to an external service as expected for this functionality.
Install Mechanism
This is an instruction-only skill with no install spec and no code files — nothing is written to disk and no third-party packages are installed. That is the lowest-risk install model.
Credentials
The skill requires no environment variables or credentials, which is proportional to its stated purpose (public, no-auth API). There are no requests for unrelated secrets or config paths.
Persistence & Privilege
The skill does not request always-on presence and uses normal autonomous invocation defaults. It does not attempt to modify other skills or system-wide configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install newsmcp-skill
  3. After installation, invoke the skill by name or use /newsmcp-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
newsMCP Skill v1.0.0 - Initial release providing real-time world news briefings with AI-powered event clustering, topic classification, and geographic filtering. - No API key required: access news events directly with simple API calls. - Features AI-generated event summaries, multi-source aggregation, deduplication, and importance signals for each event. - Supports filtering by topics and geographical regions, and includes endpoints for listing available topics and regions. - Provides example usage and recommended briefing formatting for seamless integration.
Metadata
Slug newsmcp-skill
Version 1.0.0
License
All-time Installs 2
Active Installs 2
Total Versions 1
Frequently Asked Questions

What is Skill?

Real-time world news briefings with AI-clustered events, topic classification, and geographic filtering. No API key needed. It is an AI Agent Skill for Claude Code / OpenClaw, with 305 downloads so far.

How do I install Skill?

Run "/install newsmcp-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Skill free?

Yes, Skill is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Skill support?

Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Skill?

It is built and maintained by pranciskus (@pranciskus); the current version is v1.0.0.

💬 Comments