Sports News

# Sports News — API Reference

## Commands

### fetch_feed
Fetch an RSS/Atom feed by URL and return feed metadata plus recent entries.
- `url` (str, required): Full RSS/Atom feed URL

Returns feed title, last updated timestamp, and `entries[]` with title, link, published date, summary, and source.

### fetch_items
Fetch news items from Google News or an RSS feed.
- `google_news` (bool, optional): Set to `True` to use Google News search
- `query` (str, optional, **required when `google_news=True`**): Search query string
- `url` (str, optional): RSS/Atom feed URL (mutually exclusive with `google_news`)
- `limit` (int, optional): Max items to return
- `after` (str, optional): Filter items after this date (YYYY-MM-DD)
- `before` (str, optional): Filter items before this date (YYYY-MM-DD)
- `sort_by_date` (bool, optional): Sort results by date descending (newest first)

Returns `items[]` with title, link, published date, summary, and source.

**Important constraints:**
- `google_news=True` requires a `query` — without it, Google News has nothing to search.
- `url` and `google_news` are mutually exclusive — use one or the other, not both.
- Always use `sort_by_date=True` for recency queries to show newest articles first.

## Curated RSS Feed URLs

See `references/rss-feeds.md` for the full list of curated RSS feed URLs (BBC Sport, ESPN, The Athletic, Sky Sports, etc.).

## Date Handling

Derive dates from the system prompt's `currentDate`:
- **"this week"**: `after = today - 7 days`
- **"recent" or "latest"**: `after = today - 3 days`
- **Specific date range**: use as-is

Never hardcode dates — always derive from `currentDate`.


# Useful RSS Feeds

| Source | URL |
|--------|-----|
| BBC Sport Football | `https://feeds.bbci.co.uk/sport/football/rss.xml` |
| ESPN FC | `https://www.espn.com/espn/rss/soccer/news` |
| The Athletic | `https://theathletic.com/rss/` |
| Sky Sports Football | `https://www.skysports.com/rss/12040` |

## Google News Queries

Use `google_news=True` with `query` to search Google News:
- `"Arsenal transfer news"` -- Arsenal transfer news
- `"Premier League results"` -- latest PL results
- `"Champions League draw"` -- CL draw coverage
- `"World Cup 2026"` -- World Cup news


#!/bin/bash
# Validates sports-news parameters
if [[ "$*" == *"--google_news"* && "$*" != *"--query="* ]]; then
  echo "ERROR: google_news=True requires a --query parameter."
  exit 1
fi
if [[ "$*" == *"--url="* && "$*" == *"--google_news"* ]]; then
  echo "ERROR: --url and --google_news are mutually exclusive."
  exit 1
fi
echo "OK"


---
name: sports-news
description: |
  Sports news via RSS/Atom feeds and Google News. Fetch headlines, search by query, filter by date. Covers football news, transfer rumors, match reports, and any sport via Google News.

  Use when: user asks for recent news, headlines, transfer rumors, or articles about any sport. Good for "what's the latest on [team/player]" questions. Supports any Google News query and curated RSS feeds (BBC Sport, ESPN, The Athletic, Sky Sports).
  Don't use when: user asks for structured data like standings, scores, statistics, or xG — use the sport-specific skill instead: football-data (soccer), nfl-data (NFL), nba-data (NBA), wnba-data (WNBA), nhl-data (NHL), mlb-data (MLB), tennis-data (tennis), golf-data (golf), cricket-data (cricket), cfb-data (college football), cbb-data (college basketball), or fastf1 (F1). Don't use for prediction market odds — use polymarket or kalshi. News results are text articles, not structured data.
license: MIT
metadata:
  author: machina-sports
  version: "0.1.0"
---

# Sports News

Before writing queries, consult `references/api-reference.md` for command parameters and `references/rss-feeds.md` for curated feed URLs.

## Quick Start

Prefer the CLI — it avoids Python import path issues:
```bash
sports-skills news fetch_items --google_news --query="Arsenal transfer" --limit=5
sports-skills news fetch_feed --url="https://feeds.bbci.co.uk/sport/football/rs