AgentPMT/rss-reader

RSS Reader

Freshness

Last updated: 2026-06-24.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

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.

Product 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:

{
  "action": "read",
  "feed_url": "https://feeds.bbci.co.uk/news/rss.xml",
  "max_items": 10
}

Example — Read a blog feed with raw metadata:

{
  "action": "read",
  "feed_url": "https://blog.example.com/feed",
  "max_items": 5,
  "include_raw": true
}

Response structure:

{
  "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:

{
  "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.

When To Use

• Use this skill for RSS Reader on AgentPMT.
• Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
• Search and activation keywords: rss reader, 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, read, feed url, max items.
• Supported action names: read.

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

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 1. x402 availability: not enabled for this product.

• read (action slug: read): Fetch and parse an RSS or Atom feed from a public URL. Returns feed metadata and entries with titles, links, dates, and summaries. Price: 5 credits. Parameters: feed_url, include_raw, max_items, timeout_seconds.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

• Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "rss-reader".
• Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "rss-reader", or call this product with action: "get_instructions" when the product tool is already selected.
• Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "rss-reader"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

{
  "action": "get_instructions",
  "tool_id": "rss-reader"
}

Authenticated AgentPMT REST schema lookup body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "rss-reader"
  }
}

Authenticated AgentPMT REST live examples body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "rss-reader"
  }
}

Call This Tool

Product slug: rss-reader

Marketplace page: https://www.agentpmt.com/marketplace/rss-reader

• AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
• x402 route: not enabled for this product.
• AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

• What AgentPMT is: ../what-is-agentpmt
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

{
  "method": "tools/call",
  "params": {
    "name": "RSS-Reader",
    "arguments": {
      "action": "read",
      "feed_url": "https://example.com",
      "include_raw": false,
      "max_items": 20,
      "timeout_seconds": 20
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

{
  "name": "rss-reader",
  "parameters": {
    "action": "read",
    "feed_url": "https://example.com",
    "include_raw": false,
    "max_items": 20,
    "timeout_seconds": 20
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

• Treat the returned JSON as the source of truth for this tool call.
• If the response includes warnings or correction targets, apply them before retrying.
• If the response includes a passed or success-style boolean, use it as the workflow gate.
• If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
• If read fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

• Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
• Keep tool inputs scoped to the minimum content needed for the task.
• Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/rss-reader
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase