RSS

Add RSS and Atom feeds, import OPML subscriptions, and understand how feed entries appear in the graph.

AgentGraph can index RSS and Atom feeds without API credentials. Each feed becomes a Folder entity, and each article or entry in the feed becomes a Document entity linked back to that feed.

RSS feed URLs are stored as connector configuration in ~/.agentgraph/config.toml by default, or ~/.agentgraph/config.yaml if that file exists. They are not stored in credentials.json.

#Install

Install every first-party connector:

uv sync --extra all

Or install only RSS support:

uv sync --extra rss

#Add feeds

Add one or more feed URLs:

agentgraph connector rss add https://example.com/feed.xml

You can also pass an HTML page or local HTML file. AgentGraph validates the page, looks for standard RSS or Atom <link rel="alternate"> tags, validates the discovered feed, and saves the feed URL:

agentgraph connector rss add https://example.com/

For an interactive setup prompt, use:

agentgraph auth rss

#Import OPML

Import an OPML export from a feed reader:

agentgraph connector rss import-opml feeds.opml --all

To choose specific feeds:

agentgraph connector rss import-opml feeds.opml --select 1,3-5

In an interactive terminal, omit --all and --select to choose feeds with a checkbox prompt.

#Sync feeds

Run a one-shot ingest for every configured RSS feed:

agentgraph ingest rss

Run RSS polling immediately:

agentgraph poll rss

The RSS connector also polls configured feeds in the background when agentgraph serve is running.

#Query articles

RSS entries are indexed as Document entities with platform=rss.

agentgraph query --type Document --filter platform=rss --limit 20
agentgraph search "release notes" --platform rss --limit 10

Each article document includes the entry title, summary or content, source link, author metadata when available, and published or updated timestamps when the feed provides them.