A powerful search interface for NewsAPI that allows for deep article discovery and real-time headline tracking across thousands of global sources.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install newsapi-search
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install newsapi-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is NewsAPI Search?
The NewsAPI Search skill is a professional-grade tool designed for automated news gathering and media monitoring. It provides a structured interface to the NewsAPI service, allowing users to query millions of articles from over 5,000 large and small news sources. By leveraging this integration within the Openclaw Skills ecosystem, developers can programmatically access both historical archives and live breaking news.
This skill excels at precision filtering, offering users the ability to narrow down results by specific time windows, languages, domains, and even individual news outlets. Whether you are building a market intelligence bot or a simple news aggregator, this skill transforms raw news data into actionable, structured JSON.
NewsAPI Search Use Cases
- Tracking brand mentions or industry keywords across global media outlets in real-time.
- Automating the delivery of daily tech or business headlines filtered by specific countries.
- Performing competitive research by searching historical news archives within a 30-day window.
- Building custom news feeds for Openclaw Skills that exclude low-quality or gossip-oriented domains.
- Monitoring specific niche categories like science or health to feed data into AI analysis agents.
How NewsAPI Search Works
- The user initiates a search via the CLI or programmatic API, specifying search terms and optional filters like date ranges or sources.
- The skill retrieves the stored API credentials from the Openclaw Skills environment configuration.
- A request is sent to the NewsAPI /everything endpoint for broad searches or the /top-headlines endpoint for breaking news.
- The API response is parsed and filtered according to the user's exclusion criteria (e.g., blocked domains).
- The skill returns a structured JSON object containing the article metadata, total result counts, and pagination details.
NewsAPI Search Setup
To use this skill, you must first obtain an API key from NewsAPI. Note that the free tier allows for 100 requests per day.
- Add your API key to your configuration file:
echo "NEWSAPI_KEY=your_api_key" >> ~/.openclaw/.env
- Verify the installation by running a simple query:
node scripts/search.js "artificial intelligence" --days 1
NewsAPI Search Data Schema & Taxonomy
The skill returns a standardized JSON object to ensure compatibility with other Openclaw Skills.
| Key | Description |
|---|---|
query |
The search term or category used for the request. |
totalResults |
Total number of articles matching the criteria. |
results |
An array of article objects containing title, URL, source, and snippet. |
publishedAt |
The ISO 8601 timestamp of the article's publication. |
source |
The display name of the news outlet (e.g., BBC News). |
NewsAPI Search Advanced Features
- Advanced query syntax support, including Boolean operators (AND, OR, NOT) and exact phrase matching with quotes.
- Multi-faceted filtering that allows for simultaneous inclusion of specific sources and exclusion of unwanted domains.
- Flexible time-window queries using intuitive flags like
--hours,--days,--weeks, or explicit date ranges. - Programmatic API access for direct integration into Node.js applications and automated agent workflows.
- Ability to list and filter available news sources by country, category, or language to optimize search targeting.
SKILL.md
Loading
Related Openclaw Skills
Foam Notes Skill
A comprehensive personal knowledge management skill for creating, linking, and analyzing Foam-based Markdown note repositories.
News Daily
An automated RSS news aggregator that fetches global, tech, and AI news and delivers them as formatted cards to Feishu via Openclaw Skills.
YZTurboWebAndroid
A high-performance Android WebView container SDK featuring preloading, instance reuse, and seamless JS-Native bidirectional communication.
Self-Improvement Agent Skill
A sophisticated logging and feedback framework that enables AI coding agents to autonomously capture learnings and fix recurring errors.
Lunar Calendar & Almanac Tool
A deterministic calculation tool for precise Chinese Lunar calendar conversion, almanac lookup, and 24 solar terms tracking.
Feishu Chat Guide
A specialized guide for managing Feishu group chat interactions, ensuring stable message formatting and precise @ mentions.
Featured*
