> ## 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.

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# 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 |