newsapi-search

What This Skill Does

The newsapi-search skill provides a powerful interface for OpenClaw agents to query, filter, and retrieve news data from over 5,000 global sources. By integrating with the NewsAPI infrastructure, this skill allows users to perform both broad, deep-archival searches for articles across specific domains and timeframes, as well as rapid lookups for breaking headlines. Whether you need to track trending technology topics, gather market intelligence from specific financial outlets, or monitor breaking global events by category and country, this tool offers a programmatic, high-precision solution for information retrieval.

Installation

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

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

After installation, you must configure your API credentials to enable data access. Navigate to your configuration directory and add your key to the ~/.openclaw/.env file:

NEWSAPI_KEY=your_api_key_here

You can acquire a free tier API key (providing 100 requests per day) at https://newsapi.org.

Use Cases

This skill is indispensable for professionals and researchers who need automated news curation. Use it to:

• Market Research: Monitor specific industries by querying niche domains or tracking relevant keywords over custom date ranges.
• Content Curation: Aggregate high-quality news content for newsletters or briefing reports by filtering out low-quality domains.
• Situational Awareness: Set up automated agent tasks that pull daily top-headlines for specific regions or categories to keep stakeholders informed.
• Sentiment Analysis: Fetch large datasets of articles regarding a specific company or policy to perform subsequent data analysis with other agent skills.

Example Prompts

1. "Find the top 5 trending headlines in technology for the United States today and summarize the main focus."
2. "Search for articles about sustainable energy published in the last 7 days from bbc-news and reuters only, excluding any editorial opinion pieces."
3. "List all available news sources that cover business in Canada and then pull the latest headlines from those sources."

Tips & Limitations

• Rate Limiting: The free NewsAPI tier is limited to 100 requests per day. Monitor your agent frequency to avoid service interruptions.
• Filtering: Use the exclude flag to strip out unreliable domains; this significantly increases the signal-to-noise ratio of your search results.
• Query Complexity: Leverage advanced syntax like parentheses and boolean operators (AND/OR) to refine large result sets.
• Headline Restrictions: Remember that you cannot combine specific sources with country or category filters when using the --headlines mode; the API requires these to be separate requests.