# RSS Reader

## Links

- Product page URL: https://www.agentpmt.com/marketplace/rss-reader
- Product markdown URL: https://www.agentpmt.com/marketplace/rss-reader?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/rss-reader?format=agent-json

## Overview

- Product ID: 695c37e7767df5adfd9bc874
- Vendor: Apoth3osis
- Type: core utility
- Unit type: request
- Price: 500 credits
- Categories: Developer Tools, Network Protocols, Web Scraping & Data Collection, Automation, Data Processing, Network & URL Utilities, Marketing
- Generated at: 2026-05-30T20:15:42.137Z

### Page Description

Lightweight feed parsing utility that fetches and extracts structured content from RSS and Atom feeds for content aggregation and monitoring workflows. This function retrieves feed data from any publicly accessible URL using configurable HTTP timeouts up to 120 seconds, then parses the XML content using the feedparser library to extract both feed-level metadata and individual entry details. The response includes comprehensive feed information such as title, link, last updated timestamp, and description, alongside an array of entries containing each item's title, link, publication date, summary, and full content when available. Users can limit results with the max_items parameter, retrieving anywhere from 1 to 200 entries per request to balance completeness with response size. The optional include_raw flag exposes parsing diagnostics including the bozo flag and any exception details, useful for debugging malformed or non-standard feeds. With its straightforward interface and consistent JSON output structure, the RSS Reader provides an efficient bridge between syndicated web content and downstream processing pipelines that need to consume, filter, or aggregate published articles, blog posts, podcasts, or news updates.

### Agent Description

Parse RSS/Atom feeds. Returns feed metadata and entries with titles, links, dates, summaries. Configurable max items (1-200).

## Details

### Details

Lightweight feed parsing utility that fetches and extracts structured content from RSS and Atom feeds for content aggregation and monitoring workflows. This function retrieves feed data from any publicly accessible URL using configurable HTTP timeouts up to 120 seconds, then parses the XML content using the feedparser library to extract both feed-level metadata and individual entry details. The response includes comprehensive feed information such as title, link, last updated timestamp, and description, alongside an array of entries containing each item's title, link, publication date, summary, and full content when available. Users can limit results with the max_items parameter, retrieving anywhere from 1 to 200 entries per request to balance completeness with response size. The optional include_raw flag exposes parsing diagnostics including the bozo flag and any exception details, useful for debugging malformed or non-standard feeds. With its straightforward interface and consistent JSON output structure, the RSS Reader provides an efficient bridge between syndicated web content and downstream processing pipelines that need to consume, filter, or aggregate published articles, blog posts, podcasts, or news updates.

### Actions

- `read` (5 credits): Fetch and parse an RSS or Atom feed from a public URL. Returns feed metadata and entries with titles, links, dates, and summaries.

### Use Cases

Aggregating blog posts from multiple sources into a unified content dashboard, monitoring news feeds for keyword mentions or topic alerts in media tracking workflows, pulling podcast episode listings for automated show note generation, tracking competitor blog updates or product announcements for market intelligence, populating content queues for social media scheduling automation, building personalized news digests by combining entries from curated feed lists, monitoring release notes or changelog feeds for software dependency updates, extracting publication metadata for citation management or research aggregation, feeding content pipelines that summarize or categorize incoming articles, triggering notification workflows when specific publishers release new content

### Workflows Using This Tool

No public workflows currently reference this product.

### Related Content

No related content is currently linked to this product.

## Integration Details

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "695c37e7767df5adfd9bc874",
    "parameters": {
      "action": "read",
      "feed_url": "example_feed_url",
      "max_items": 20,
      "include_raw": false,
      "timeout_seconds": 20
    }
  }'
```

### Autonomous Agents

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

- Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents
- Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md
- Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress
- AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls.
- Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state.
- Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche.

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "read": {
      "description": "Fetch and parse an RSS or Atom feed from a public URL. Returns feed metadata and entries with titles, links, dates, and summaries.",
      "properties": {
        "feed_url": {
          "type": "string",
          "description": "The full URL of the RSS or Atom feed to read.",
          "required": true
        },
        "max_items": {
          "type": "integer",
          "description": "Maximum number of feed entries to return.",
          "required": false,
          "default": 20,
          "minimum": 1,
          "maximum": 200
        },
        "include_raw": {
          "type": "boolean",
          "description": "Include raw feed parsing metadata (bozo flag and exception details for debugging malformed feeds).",
          "required": false,
          "default": false
        },
        "timeout_seconds": {
          "type": "integer",
          "description": "HTTP request timeout in seconds.",
          "required": false,
          "default": 20,
          "minimum": 1,
          "maximum": 120
        }
      }
    }
  },
  "properties": {}
}
```

### Usage Instructions

# RSS Reader

Fetch and parse RSS and Atom feeds from any public URL. Returns structured feed metadata and entries including titles, links, publication dates, and summaries.

---

## Actions

### read

Fetch and parse an RSS or Atom feed.

**Required fields:**
- `action` (string): `"read"`
- `feed_url` (string): The full URL of the RSS or Atom feed to read

**Optional fields:**
- `max_items` (integer): Maximum number of feed entries to return. Range: 1-200. Default: 20
- `include_raw` (boolean): Include raw feed parsing metadata (e.g., whether the feed had parsing errors). Default: false
- `timeout_seconds` (integer): HTTP request timeout in seconds. Range: 1-120. Default: 20

**Example — Read a news feed:**
```json
{
  "action": "read",
  "feed_url": "https://feeds.bbci.co.uk/news/rss.xml",
  "max_items": 10
}
```

**Example — Read a blog feed with raw metadata:**
```json
{
  "action": "read",
  "feed_url": "https://blog.example.com/feed",
  "max_items": 5,
  "include_raw": true
}
```

**Response structure:**
```json
{
  "feed": {
    "title": "Feed Title",
    "link": "https://example.com",
    "updated": "2026-03-10T12:00:00Z",
    "description": "Feed description"
  },
  "entries": [
    {
      "title": "Article Title",
      "link": "https://example.com/article",
      "published": "2026-03-10T10:00:00Z",
      "summary": "Brief summary of the article...",
      "content": null
    }
  ],
  "count": 1
}
```

When `include_raw` is true, the response also includes:
```json
{
  "raw": {
    "bozo": false,
    "bozo_exception": null
  }
}
```
A `bozo` value of `true` indicates the feed had XML parsing issues but was still partially parsed.

---

## Common Workflows

1. **Monitor news sources** — Read feeds from news outlets to get the latest headlines, then filter or summarize entries by title or summary.
2. **Aggregate multiple feeds** — Call `read` multiple times with different feed URLs, then combine and sort entries by publication date.
3. **Validate feed health** — Use `include_raw: true` to check whether a feed has parsing errors before relying on it for automation.
4. **Limit bandwidth usage** — Set a lower `max_items` value (e.g., 5) when you only need the most recent entries, or increase `timeout_seconds` for slow feeds.

---

## Important Notes

- Only publicly accessible RSS and Atom feed URLs are supported. Feeds behind authentication will fail.
- The `feed_url` must be a direct link to the XML feed, not a webpage that contains a feed link.
- Feeds with malformed XML may still return partial results. Use `include_raw` to detect parsing issues.
- The `content` field in entries may be `null` if the feed only provides summaries.
- Maximum of 200 items can be returned per request.

### Frequently Asked Questions

#### How do I connect this tool to an external agent?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

You can install the local MCP server by opening a terminal and running:

```
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

```
{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}
```

[View MCP Connection Instructions](/docs/mcp-reference/connection) for more details.

#### How does an external agent use this tool?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

> Call the AgentPMT-Tool-Search-and-Execution tool with action 'get\_schema' and tool\_id 695c37e7767df5adfd9bc874 ("RSS Reader"). Then call the same tool with action 'call\_tool', tool\_id 695c37e7767df5adfd9bc874, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

### Dependencies

This product has no public dependency products.