RSS and news feeds for agents

Read a feed as clean JSON items (id, title, url, published, authors, categories, a ≤200-char lead, bounded plain text), newest first, deduplicated, optionally since a date. url may be a feed URL or just a site: the discovery ladder runs and the result says how it resolved. Use for "what is new on X".

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "Feed URL, or a site/page URL to discover the feed for."
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "since": {
      "description": "ISO date/time; only items published or updated after it.",
      "type": "string",
      "maxLength": 40
    },
    "max_chars": {
      "default": 30000,
      "description": "Total budget for content_text across the returned items.",
      "type": "integer",
      "minimum": 1000,
      "maximum": 200000
    },
    "task_context": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "One sentence on what the user is ultimately trying to do (the task this call serves). Required; it tunes the result and is how this free service learns what agents need."
    }
  },
  "required": [
    "url",
    "task_context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Find the RSS/Atom/JSON feed(s) of a site: <link rel="alternate"> tags and the Link header, feed-shaped links in the page, the common paths on the deepest path prefix first, then a short table of well-known legacy feeds; every rung tried is returned. Use when you need a feed URL, want all of a site's feeds, or feed_items missed and you want to see why.

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "Site or page URL, e.g. \"arstechnica.com\" or \"https://vercel.com/blog\"."
    },
    "all": {
      "default": false,
      "description": "Keep going after the first feed to list every feed found (costs more fetches).",
      "type": "boolean"
    },
    "task_context": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "One sentence on what the user is ultimately trying to do (the task this call serves). Required; it tunes the result and is how this free service learns what agents need."
    }
  },
  "required": [
    "site",
    "task_context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Keyless news search: Google News RSS and Bing News RSS in parallel, fused by reciprocal rank, deduplicated by normalized URL, same-story variants grouped under also_on, each item with its publisher and which engines carried it (via: both is the strongest signal). Use for "what is the news about X"; use feed_items for one site's own posts.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "News query; at least 2 characters (a 1-char query returns unrelated noise from the engines)"
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "when": {
      "description": "Recency window (Google News honours it; Bing News has no such knob and is queried as-is).",
      "type": "string",
      "enum": [
        "1h",
        "1d",
        "7d",
        "30d"
      ]
    },
    "lang": {
      "default": "en",
      "description": "Google News hl language, e.g. en, de.",
      "type": "string",
      "minLength": 2,
      "maxLength": 5
    },
    "region": {
      "default": "US",
      "description": "Google News gl region, e.g. US, GB.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "task_context": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "One sentence on what the user is ultimately trying to do (the task this call serves). Required; it tunes the result and is how this free service learns what agents need."
    }
  },
  "required": [
    "query",
    "task_context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}