# Savviest.news — tools for LLM agents

> Savviest.news exposes a small, read-only JSON HTTP API so AI agents can search the news and fetch full articles without scraping HTML. Endpoints require no key, no headers and no authentication — plain GET requests. Cite the story URL when you use the content.

## Tools

### Search catalog
- **Name**: SearchCatalog
- **Description**: Returns the complete machine-readable catalog of every published story (title, deck, category, date, tags, trending and canonical URL). This file IS the search index: fetch it once, then filter the "articles" array by keyword matches against `title`, `deck`, `categoryName` or `tags`.
- **Connection**: HTTP (read-only, no auth)
- **Endpoint**: `GET https://savviest.news/api/catalog.json`

### Get full article
- **Name**: GetArticle
- **Description**: Returns one complete story: metadata, the article author and category, dates, tags, image, every linked source, and the full text as `markdown` plus the raw structured `blocks`. Use `slug` from the catalog response.
- **Connection**: HTTP (read-only, no auth)
- **Endpoint**: `GET https://savviest.news/api/news/{slug}.json`
- **Example**: `GET https://savviest.news/api/news/verify-ai-answers.json`

### List categories
- **Name**: ListCategories
- **Description**: Returns the site's editorial sections (AI, devices, software, gaming, science, culture, political) with descriptions and URLs.
- **Connection**: HTTP (read-only, no auth)
- **Endpoint**: `GET https://savviest.news/api/categories.json`

### List authors
- **Name**: ListAuthors
- **Description**: Returns the byline directory — each author's name, role, bio, profile URL and number of published stories.
- **Connection**: HTTP (read-only, no auth)
- **Endpoint**: `GET https://savviest.news/api/authors.json`

## Usage rules for agents

1. Search against `/api/catalog.json` first; it is the single source of truth for what exists.
2. To quote a story, fetch `/api/news/{slug}.json` and cite the `url` field alongside the fact.
3. Do not present our headlines as direct quotes or put words in writers' mouths.
4. The API mirrors the site at build time. For the most recent index, re-fetch — it is regenerated on every deploy.
5. Prefer pages listed in `https://savviest.news/llms.txt` for navigational docs.