newsapi-search

What This Skill Does

The newsapi-search skill provides a powerful interface for the OpenClaw AI agent to interface with NewsAPI, a massive index of over 5,000 global news sources. It allows users to perform both broad, historical searches across the web and targeted queries for breaking headlines. Whether you are conducting competitive intelligence, aggregating specific industry news, or monitoring global events, this skill enables programmatic access to reliable data sources without manual browsing. It supports advanced filtering by language, time windows, specific domains, and source-level authority.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/dexiaong/newsapi-searchezz

After installation, you must configure your API key to authenticate with NewsAPI. Create or edit the ~/.openclaw/.env file and append the following line with your key obtained from https://newsapi.org:

NEWSAPI_KEY=your_api_key

Use Cases

• Market Research: Automatically track daily shifts in stock market news or industry trends by pulling headlines from major financial publications.
• Content Curation: Filter out low-quality noise by excluding specific domains and limiting results to verified news sources for daily briefing generation.
• Automated Monitoring: Use the time window filters to set up recurring cron-based tasks that summarize news from the last 24 hours regarding a specific subject or company.
• Sentiment Analysis: Gather large datasets of recent news articles for natural language processing tasks to determine public sentiment on current events.

Example Prompts

1. "Find me the most relevant news articles about the progress of fusion energy from the last 7 days, but exclude results from tech blogs."
2. "Show me the top business headlines for the United States today and summarize the main economic themes."
3. "Search for all news mentions of 'OpenAI' from verified tech domains like bbc.co.uk and nytimes.com within the last 48 hours."

Tips & Limitations

• Rate Limits: The free tier of NewsAPI is limited to 100 requests per day. Ensure your scripts or agent prompts are optimized to avoid hitting this cap during automated tasks.
• Endpoint Restrictions: Be mindful that in 'Top Headlines' mode, you cannot combine --country or --category with --sources due to API constraints.
• Query Complexity: Use the advanced query syntax (AND/OR, grouping) to refine your results efficiently and reduce the need for multiple API calls. Always prefer using specific domains if you are looking for high-quality, trustworthy information.