AgentFeed — tiny content-extraction API for AI agents

One GET request turns any RSS/Atom feed into clean JSON, or any web page into clean text/markdown. No SDK, no signup, no tracking. A live instance runs at https://agentfeed.bigfloppy.net.

MCP (Model Context Protocol)

POST /mcp is a streamable-HTTP MCP server exposing the same pipeline as two tools: fetch_feed (RSS/Atom -> JSON) and fetch_article (page -> text/Markdown). Point any MCP client (Claude Desktop, IDEs, agent frameworks) at https://agentfeed.bigfloppy.net/mcp; pass your API key via the X-Api-Key header. Same quotas and pricing as the REST API.

Endpoints

GET /api/feed?url=<rss-or-atom-url>     # feed -> {title, link, published, summary}[]
GET /api/article?url=<page-url>         # page -> {title, author, text, markdown}
GET /api/health

curl 'https://agentfeed.bigfloppy.net/api/feed?url=https://hnrss.org/frontpage'
curl 'https://agentfeed.bigfloppy.net/api/article?url=https://blog.python.org/'

Features

• Agent-friendly JSON — flat, predictable shapes; summaries truncated to 500 chars, article text capped at 20k chars.
• Fair free tier — 30 requests/min per IP, no key needed. Paid key: $5 per 100k requests/year (card, Stripe checkout, or USDC on Base with on-chain self-verification — no email, no accounts).
• SSRF-safe outbound fetch — 2 MB / 15 s caps, gzip handled.
• Single process, stdlib server — SQLite-free, stateless; only a small JSON file for key state.

Run your own

pip install -r requirements.txt
python3 server.py          # serves on :5000

Edit paid.py to set your own wallet address and Stripe codes, or ignore that file's payment logic entirely — the API works without keys on the free tier.

License

MIT — see LICENSE.