# News & RSS Monitor: Keyword Alerts, Only New Articles (`scraper_guru/news-rss-monitor`) Actor

Monitor news and RSS feeds for your keywords and get only new articles on every run. Built-in MENA and AI-lab source packs, Arabic-aware matching.

- **URL**: https://apify.com/scraper_guru/news-rss-monitor.md
- **Developed by:** [LIAICHI MUSTAPHA](https://apify.com/scraper_guru) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 new article returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## News & RSS Monitor: Keyword Alerts, Only New Articles

**News & RSS Monitor** watches news feeds for your keywords and returns **only the articles it has not returned before**, run after run. Put it on a schedule (hourly, daily) and connect it to Slack, email or a webhook: every row is a real, new article.

Pick a built-in source pack (MENA news, AI labs, AI research), add your own RSS or Atom feeds or plain website URLs, type your keywords, and you're done. Arabic spellings are handled for you: **أرامكو** also finds **الأرامكو** and **ارامكو**.

### Features

- ✅ **Only new articles:** each named monitor remembers what it returned, so a schedule never sends the same article twice. The first run returns only the last 7 days (adjustable).
- ✅ **Built-in source packs:** checked feeds from Morocco, Algeria, the UAE, Jordan and pan-Arab media, plus AI lab blogs and arXiv cs.AI. No feed URL to find.
- ✅ **Your own sources:** paste feed URLs or website URLs. For a website, the actor finds its RSS or Atom feed and tells you which one it used.
- ✅ **Keyword matching that works in Arabic, French and English:** Arabic spelling variants and prefixes, whole words elsewhere ("Meta" does not match "metadata"), "quoted phrases", and exclude words.
- ✅ **Clean rows:** title, link (tracking tags removed), publish date, source, country, language, author, plain-text summary, image, categories and the keywords that matched.
- ✅ **Cheap on a schedule:** unchanged feeds are checked with conditional requests, and you pay per new article, not per run of the whole feed.
- ✅ **A run report:** every feed's status (ok, not modified, not found, blocked, no feed found), with feeds that keep failing flagged for removal.

### Use cases

- **Brand and company monitoring:** get every new article mentioning your company, competitors or executives, in Arabic, French or English.
- **MENA market intelligence:** follow Moroccan, Algerian, Emirati, Jordanian and pan-Arab news for a sector or keyword, without listing outlets yourself.
- **AI news tracking:** every announcement from Hugging Face, Google DeepMind, Google AI and Mistral AI, or every new arXiv cs.AI paper on a topic.
- **Newsroom and PR alerts:** schedule hourly and push new matches to Slack or email with an Apify integration.
- **Data for AI agents and RAG:** a steady, deduplicated stream of fresh headlines and summaries.

### Source packs

| Pack | Feeds | Countries and languages |
|---|---|---|
| **MENA news** (`mena`) | Hespress, Hespress FR, MAP Express, Yabiladi, TelQuel, TSA Algérie, Khaleej Times, Alghad, Asharq Al-Awsat, Sky News Arabia | Morocco, Algeria, UAE, Jordan, pan-Arab · Arabic, French, English |
| **AI labs** (`ai`) | Hugging Face blog, Google DeepMind blog, Google AI blog, Mistral AI news | English |
| **AI research** (`research`) | arXiv cs.AI (about 800 new papers a day) | English |

Every feed in a pack was checked before it was added: the feed is live, the site's robots.txt allows it, and the publisher's terms do not limit their feed to personal or non-commercial use. The MENA pack is a starter set and grows as more outlets pass the same check.

### Input

| Field | Type | Description |
|---|---|---|
| `packs` | array | `mena`, `ai`, `research`. Optional if you give your own sources. |
| `countries` | array | Narrow the MENA pack: `MA`, `DZ`, `AE`, `JO`, `MENA` (pan-Arab). |
| `languages` | array | Narrow pack feeds: `ar`, `fr`, `en`. |
| `sources` | array | Your own feed URLs or website URLs, one per line. |
| `keywords` | array | Return articles whose title or summary mention any of these. Empty = every new article. |
| `excludeKeywords` | array | Drop an article if it mentions any of these. |
| `monitorName` | string | One name per monitor (default `default`). Each keeps its own memory. |
| `onlyNew` | boolean | Default `true`. Turn off to get everything currently in the feeds. |
| `firstRunDays` | integer | First run of a monitor: only the last N days (default 7). |
| `resetMonitor` | boolean | Forget this monitor's memory and start again. |
| `maxFeeds` | integer | Feeds per run (default 500). |
| `maxArticles` | integer | Articles per run, to cap your spend. |

Example input:

```json
{
  "packs": ["mena"],
  "countries": ["MA"],
  "keywords": ["المغرب", "Maroc", "\"Bank Al-Maghrib\""],
  "excludeKeywords": ["football"],
  "monitorName": "morocco-economy"
}
```

### Output

One row per new article:

```json
{
  "title": "Nador West Med, “un nouveau pilier maritime stratégique du Maroc” à même de désengorger Tanger Med (RFI)",
  "url": "https://www.mapexpress.ma/actualite/economie-et-finance/nador-west-med-nouveau-pilier-maritime-strategique-du-maroc-meme-desengorger-tanger-med-rfi/",
  "originalUrl": "https://www.mapexpress.ma/actualite/economie-et-finance/nador-west-med-nouveau-pilier-maritime-strategique-du-maroc-meme-desengorger-tanger-med-rfi/",
  "publishedAt": "2026-11-03T11:09:45.000Z",
  "author": "MAP",
  "summary": "Le port Nador West Med se positionne comme \"un nouveau pilier maritime stratégique du Maroc en mesure de désengorger le complexe portuaire de Tanger Med\" qui enchaîne les records en termes de conteneurs traités, écrit Radio France internationale (RFI) sur son site.",
  "imageUrl": "https://www.mapexpress.ma/wp-content/uploads/2026/11/Radio-rfi-RFI-Logo-450x300.png",
  "categories": [],
  "source": {
    "name": "MAP Express",
    "feedUrl": "https://www.mapexpress.ma/feed/",
    "homepage": "https://www.mapexpress.ma",
    "country": "MA",
    "language": "fr",
    "pack": "mena"
  },
  "matchedKeywords": ["Maroc"],
  "monitor": "morocco-economy",
  "firstSeenAt": "2026-11-03T11:30:37.008Z"
}
```

- `url` is the link with tracking parameters removed (it is also how duplicates are detected); `originalUrl` is the link as published.
- `publishedAt` is `null` when the feed gives no date; it is never invented.
- `summary` is plain text from the feed itself, cut to about 600 characters. Some feeds publish no summary (Hugging Face's blog feed has titles and links only).

The **run report** (`RUN_REPORT` in the run's key-value store) lists every feed with its status, how many items it had and how many were new, and the totals: found, already seen, outside the first-run window, not matching, returned.

### How to use

1. Open the actor in Apify Console and pick a pack, or paste your feeds.
2. Add keywords (optional) and give the monitor a name.
3. Click **Start**. The first run returns the last 7 days.
4. Click **Schedule** to run it hourly or daily: from now on, each run returns only new articles.
5. Add an integration (Slack, email, webhook, Make, Zapier) to receive each new article, or read the dataset through the Apify API.

### Pricing

Pay per event, no subscription:

| Event | Price |
|---|---|
| New article returned | $2 per 1,000 articles |
| Feed checked (only feeds that answered) | $0.10 per 1,000 checks |
| Run start | $0.001 per run |

You pay only for new, matching articles: articles already returned, older than the first-run window or not matching your keywords cost nothing, and feeds that fail are not charged. Example: an hourly monitor of 50 feeds costs about $4.30 a month in checks and starts, plus $2 per 1,000 new articles. A daily run of the MENA pack with a few keywords typically returns a few dozen articles.

### FAQ

**How does "only new" work?**
Each monitor (`monitorName`) keeps a memory of the articles it has returned, in a key-value store in your account. A run returns only articles that are not in it. Articles that did not match your keywords are remembered too, so if you add a keyword later, it applies to articles published from then on. Use `resetMonitor` to start again.

**Can I monitor Google News?**
No. Google's terms do not allow automated collection, and this actor only reads feeds that publishers make available for machines. Use a pack, or add the outlets you follow as sources.

**What happens if I paste a website instead of a feed?**
The actor reads the page once, looks for its RSS or Atom link, then tries the usual feed addresses (`/feed`, `/rss`, `/rss.xml`, …), always within the site's robots.txt. The feed it found is shown in the run report and reused on later runs. If a site has no feed, it is reported as "no feed found"; pages are never scraped.

**Does it work for Arabic?**
Yes. Diacritics and tatweel are ignored, the different alef forms count as one letter, ة and ه, ى and ي too, and attached prefixes (ال, و, ب, ل, ف) are allowed, so one keyword finds the usual spellings. Suffixes are limited to real ones, so "مصر" finds "المصرية" but not "مصرف".

**Do you fetch the full article text?**
No, only what the publisher puts in the feed: title, link, date, author, summary, image and categories. That keeps every run fast and cheap, and respects publishers' copyright.

**Who is responsible for the feeds I add?**
You are. Pack feeds are checked by us; for your own sources, make sure your use of them complies with the publisher's terms.

# Actor input Schema

## `packs` (type: `array`):

Built-in, checked news feeds. MENA news: 10 outlets from Morocco, Algeria, the UAE, Jordan and pan-Arab media. AI labs: Hugging Face, Google DeepMind, Google AI, Mistral AI. AI research: new arXiv cs.AI papers (about 800 a day, so many articles per run).

## `countries` (type: `array`):

Only MENA pack outlets from these countries. Leave empty for all. "Pan-Arab" = Asharq Al-Awsat and Sky News Arabia.

## `languages` (type: `array`):

Only pack feeds in these languages. Leave empty for all.

## `sources` (type: `array`):

RSS or Atom feed URLs to watch, one per line. Optional when you pick a pack. You are responsible for the sources you add.

## `keywords` (type: `array`):

Return articles whose title or summary mention any of these. Arabic spellings and prefixes match (أرامكو = الأرامكو = ارامكو); other languages match whole words; put "quotes" around a phrase. Leave empty to get every new article.

## `excludeKeywords` (type: `array`):

Drop an article if it mentions any of these, even when a keyword matches.

## `monitorName` (type: `string`):

Each monitor remembers which articles it already returned, so scheduled runs give only new ones. Use one name per topic or client (letters, digits, dots, hyphens, underscores). Changing keywords or feeds keeps the memory.

## `onlyNew` (type: `boolean`):

Return only articles this monitor has not returned before. Turn off to get everything currently in the feeds (memory is not read or changed).

## `firstRunDays` (type: `integer`):

On a monitor's first run, return only articles published in the last N days. Older ones are remembered and skipped.

## `resetMonitor` (type: `boolean`):

Forget everything this monitor returned and start again (the first-run window applies).

## `maxFeeds` (type: `integer`):

Protects against huge lists.

## `maxArticles` (type: `integer`):

Caps your spend per run. Empty = no cap.

## Actor input object example

```json
{
  "packs": [
    "mena"
  ],
  "sources": [
    "https://deepmind.google/blog/rss.xml"
  ],
  "keywords": [
    "Maroc",
    "المغرب"
  ],
  "monitorName": "default",
  "onlyNew": true,
  "firstRunDays": 7,
  "resetMonitor": false,
  "maxFeeds": 500
}
```

# Actor output Schema

## `articles` (type: `string`):

No description

## `report` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "packs": [
        "mena"
    ],
    "sources": [
        "https://deepmind.google/blog/rss.xml"
    ],
    "keywords": [
        "Maroc",
        "المغرب"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper_guru/news-rss-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "packs": ["mena"],
    "sources": ["https://deepmind.google/blog/rss.xml"],
    "keywords": [
        "Maroc",
        "المغرب",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("scraper_guru/news-rss-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "packs": [
    "mena"
  ],
  "sources": [
    "https://deepmind.google/blog/rss.xml"
  ],
  "keywords": [
    "Maroc",
    "المغرب"
  ]
}' |
apify call scraper_guru/news-rss-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraper_guru/news-rss-monitor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/bngowIb75Iw0dfeIB/builds/lFgAmQot5Pf8ldAuG/openapi.json
