> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# RSS Feed

> Connect to any RSS or Atom feed to ingest news, blogs, and updates into your workflows.

## How to set up RSS Feed

### Authentication

Most RSS feeds are public and don't require authentication. However, if you need to access protected feeds:

1. Add the RSS Feed integration in Cargo
2. Configure optional headers if authentication is required:
   * **Public headers**: Visible values
   * **Secret headers**: Encrypted values (API keys, tokens)

## RSS Feed data models

### Fetch RSS Feed

Pull items from any RSS 2.0, RSS 1.0, or Atom feed.

**Required fields:**

* **Feed URL**: The URL of the RSS or Atom feed

**Features:**

* Supports standard RSS 2.0, RSS 1.0, and Atom formats
* Minimum 30-minute sync interval
* Automatically parses feed structure

**Example feed URLs:**

```
https://techcrunch.com/feed/
https://feeds.bbci.co.uk/news/rss.xml
https://www.lesechos.fr/rss/finance.xml
```

## Feed item data

RSS feed items typically include:

| Field       | Description                 |
| ----------- | --------------------------- |
| title       | Item title                  |
| link        | URL to full article         |
| description | Summary or excerpt          |
| pubDate     | Publication date            |
| author      | Author name                 |
| category    | Content categories          |
| guid        | Unique identifier           |
| content     | Full content (if available) |

## Protected feeds

For feeds requiring authentication, configure headers:

**API Key authentication:**

```
Key: Authorization
Value: Bearer your-api-key
Type: Secret
```

**Basic authentication:**

```
Key: Authorization
Value: Basic base64(username:password)
Type: Secret
```

## Best practices

* Use reliable, stable feed URLs
* Set appropriate sync intervals based on feed update frequency
* Filter items by date to process only new content
* Combine with entity extraction for company/topic matching
* Store feed GUIDs to avoid reprocessing
* Handle feed errors gracefully (feeds can be unreliable)

## Use cases

* **Sales triggers**: Company announcements, funding news
* **Competitive intel**: Competitor blog and press monitoring
* **Industry research**: Track trends and developments
* **Content curation**: Aggregate relevant content
* **Account monitoring**: Follow target account news

## Supported formats

| Format  | Description                  |
| ------- | ---------------------------- |
| RSS 2.0 | Most common RSS format       |
| RSS 1.0 | Older RDF-based RSS format   |
| Atom    | Modern XML-based feed format |