# RSS News Aggregator (`louvre/rss-news-aggregator`) Actor Aggregate dozens of RSS and Atom feeds into one chronologically sorted JSON stream in seconds. Returns title, link, publish date, author, categories, and media per article, grouped by source domain. Use for news monitoring, content curation, and LLM/AI feed pipelines. - **URL**: https://apify.com/louvre/rss-news-aggregator.md - **Developed by:** [Louvre LLC](https://apify.com/louvre) (community) - **Categories:** News, Automation, Social media - **Features:** Limited permissions - **Stats:** 45 total users, 5 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing $10.00 / 1,000 requests 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 ## RSS News Aggregator ### 📌 Introduction #### 🎯 What is this actor? The **RSS News Aggregator** is a powerful Apify actor designed to fetch, combine, and process multiple RSS and Atom feeds. It takes a list of feed URLs, sorts all articles by publication date, and groups them by their source, making it easy to create customized news streams. #### 🚀 Key Features - **Aggregate Multiple Feeds**: Combine articles from various RSS/Atom sources. - **Group by Source**: Automatically groups articles by their root domain (e.g., `marketwatch.com`). - **Global Sorting**: Sorts all articles chronologically across all feeds. - **Flexible Output**: Choose between a clean, normalized format or the raw, unprocessed data from the feeds. - **Deploy as API**: Runs on the Apify platform and can be used as a serverless API. #### 🔍 Use Cases - **News Dashboards**: Build a personal or professional dashboard that pulls in news from all your favorite sources. - **Content Curation**: Curate content for newsletters, websites, or social media by monitoring specific topics across different blogs and news sites. - **Market Research**: Keep track of industry news, competitor announcements, and market trends in one place. - **Data Analysis**: Use the raw data output to perform text analysis, sentiment analysis, or other research on a large corpus of articles. *** ### 📥 Inputs The actor requires the following inputs. | Field | Type | Required | Description | | ------------ | --------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `rss_feeds` | `Array` | **Yes** | An array of objects, where each object contains a `url` key pointing to a valid RSS or Atom feed URL. | | `raw_data` | `Boolean` | No | If set to `true`, the actor will return the raw, unprocessed JSON for each feed, grouped by source domain, without applying normalization or pagination. Defaults to `false`. | #### ✅ Example Input ```json { "rss_feeds": [ { "url": "https://www.federalreserve.gov/feeds/press_monetary.xml" }, { "url": "https://www.marketwatch.com/rss/topstories" }, { "url": "http://feeds.bbci.co.uk/news/rss.xml" } ], "raw_data": false } ``` *** ### 📤 Outputs The actor's output format depends on the `raw_data` input parameter. #### Standard Output (`raw_data`: false) By default, the actor performs a global sort on all articles from all feeds and then groups the results by their source. The output is an array of objects, where each object represents a source and contains its articles. ##### ✅ Example Standard Output ```json [ { "source": "federalreserve.gov", "feeds": [ { "title": "Fed Announces Monetary Policy Update", "link": "https://www.federalreserve.gov/newsevents/pressreleases/monetary20231026a.htm", "pub_date": "2023-10-26T18:00:00.000Z", "source": "federalreserve.gov", "guid": "https://www.federalreserve.gov/newsevents/pressreleases/monetary20231026a.htm", "author": "", "category": "Monetary Policy", "enclosure": null } ] }, { "source": "marketwatch.com", "feeds": [ { "title": "Market Hits Record Highs After Tech Rally", "link": "https://www.marketwatch.com/story/market-hits-record-highs-11635280000", "pub_date": "2023-10-26T16:30:00.000Z", "source": "marketwatch.com", "guid": "https://www.marketwatch.com/story/market-hits-record-highs-11635280000", "author": "John Doe", "category": "Top Stories", "enclosure": { "url": "https://example.com/image.jpg", "type": "image/jpeg", "length": "12345" } } ] } ] ``` #### Raw Data Output (`raw_data`: true) When `raw_data` is `true`, the actor fetches the raw XML from each feed, converts it to JSON, and groups the full JSON objects into an array of source-specific objects. This mode does **not** apply any sorting. It is designed to give you the complete, original data structure for each feed. ##### ✅ Example Raw Data Output ```json [ { "source": "federalreserve.gov", "feeds": [ { "title": "Federal Reserve Board - Press Release", "link": { "$": { "href": "https://www.federalreserve.gov/feeds/press_monetary.xml", "rel": "self" } }, "description": "Recent press releases on monetary policy.", "lastBuildDate": "Thu, 26 Oct 2023 18:00:00 GMT", "item": [ { "title": "Fed Announces Monetary Policy Update", "link": "https://www.federalreserve.gov/newsevents/pressreleases/monetary20231026a.htm", "description": "The Federal Reserve issued a statement on its latest monetary policy decisions...", "pubDate": "Thu, 26 Oct 2023 18:00:00 GMT", "guid": { "_": "https://www.federalreserve.gov/newsevents/pressreleases/monetary20231026a.htm", "isPermaLink": "true" } } ] } ] } ] ``` *** ### ⚙️ How to Use #### 🏁 Running on Apify Platform 1. **Log in** or **Sign up** on the [Apify platform](https://apify.com/). 2. **Find the "RSS News Aggregator" Actor** in the [Apify Store](https://apify.com/store). 3. **Click "Try actor"** and then **create a new task**. 4. **Enter your desired RSS feed URLs** and any other optional parameters in the **Input** tab. 5. **Start the task** by clicking the **"Start"** button. The results will be available in the task's **Dataset** tab once the run is finished. *** ### 🛠️ Troubleshooting | Issue | Possible Cause | Solution | | ------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | `Invalid URL error` | One or more URLs in `rss_feeds` are malformed or not valid RSS/Atom feeds. | Check all provided URLs to ensure they are correct and point to a valid feed. | | `Parsing Error` | The feed's XML structure is broken or does not conform to RSS/Atom standards. | Try a different feed from that source or contact the source's administrator. | | `Empty Output` | The provided feeds are empty, or there was a network issue preventing them from being fetched. | Ensure the source feeds contain articles and that your network connection is stable. | # Actor input Schema ## `rss_feeds` (type: `array`): List of RSS/Atom feed URLs to aggregate ## `raw_data` (type: `boolean`): If true, returns the full, unprocessed JSON from the XML feed, without the root element. Skips normalization and pagination. ## Actor input object example ```json { "rss_feeds": [ { "url": "https://www.federalreserve.gov/feeds/press_monetary.xml" }, { "url": "https://www.marketwatch.com/rss/topstories" } ], "raw_data": false } ``` # Actor output Schema ## `results` (type: `string`): All aggregated articles grouped by source, stored in the default dataset # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "rss_feeds": [ { "url": "https://www.federalreserve.gov/feeds/press_monetary.xml" }, { "url": "https://www.marketwatch.com/rss/topstories" } ], "raw_data": false }; // Run the Actor and wait for it to finish const run = await client.actor("louvre/rss-news-aggregator").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "rss_feeds": [ { "url": "https://www.federalreserve.gov/feeds/press_monetary.xml" }, { "url": "https://www.marketwatch.com/rss/topstories" }, ], "raw_data": False, } # Run the Actor and wait for it to finish run = client.actor("louvre/rss-news-aggregator").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 '{ "rss_feeds": [ { "url": "https://www.federalreserve.gov/feeds/press_monetary.xml" }, { "url": "https://www.marketwatch.com/rss/topstories" } ], "raw_data": false }' | apify call louvre/rss-news-aggregator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,louvre/rss-news-aggregator" } } } ``` 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 ` 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/G5rr5jsltamrHwC1N/builds/OxXlKVFyRx9XGEaGd/openapi.json