RSS/Atom feed parser
POST /api/feed-parseFetch an RSS 2.0, Atom, or RSS 1.0 feed URL and parse it into normalized JSON: feed title/description/link plus items (title, link, id, published, author, plain-text summary, categories). Deterministic pure-XML parse with a lenient recovery pass for common malformations (reported in a warnings array). Item count is bounded (default 20, max 50). SSRF-guarded.
Input
| Field | Type | Description |
|---|---|---|
url * | string | Feed URL (RSS 2.0, Atom, or RSS 1.0/RDF) |
limit | number | Max items to return, 1-50 (default 20) |
Example output
{
"url": "https://hnrss.org/frontpage",
"format": "rss2",
"title": "Hacker News: Front Page",
"description": "Hacker News RSS",
"link": "https://news.ycombinator.com/",
"updated": null,
"itemCount": 30,
"items": [
{
"title": "Show HN: …",
"link": "https://example.com/post",
"id": "https://news.ycombinator.com/item?id=1",
"published": "Mon, 13 Jul 2026 12:00:00 +0000",
"author": "someone",
"summary": "Article summary…",
"categories": []
}
],
"warnings": []
}
Try it — see the 402 challenge (free)
curl -i -X POST https://agent402.tools/api/feed-parse \
-H "Content-Type: application/json" \
-d '{"url":"https://hnrss.org/frontpage","limit":5}'
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/feed-parse", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"url": "https://hnrss.org/frontpage",
"limit": 5
}),
});
Part of these workflows
This tool is one step in a curated multi-tool workflow — agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.
- Feed watch — Monitor an RSS/Atom feed in one call: parse the feed, read the top story in full, extract the keywords driving the cycle, and diff the item list against your last run to isolate what's new.
Related tools
Extract article
POST /api/extractExtract the main article content from any public URL as clean markdown. Returns title, byline, excerpt, word count, and …
Page metadata
GET /api/metaFetch page metadata for a URL: title, description, OpenGraph, Twitter cards, canonical URL, favicon.
Browser render
POST /api/renderRender a page in a real headless Chromium browser (JavaScript executed), then extract the main content as clean markdown…