Skimmr News — staging.newssite.skimmr.ai
Machine-readable retrieval guide for the public site structure.

## Site Identity / Description
Skimmr News is a static news retrieval site designed for machine clients, AI crawlers, agents, and machine clients.
It organizes article resources around topic taxonomies, location taxonomies, sitemap discovery, and parallel retrieval formats.
This file describes the public retrieval paths and semantic structure of the site.

## Access
Public retrieval uses normal site URLs.
Authentication, crawler policy, and access controls are the same as for the rest of the current site.
This file describes public retrieval only. It is not API documentation, webhook documentation, or an internal integration guide.

## Formats
Each article resource is available through parallel public URLs:
/articles/{slug}/
/articles/{slug}/index.md
/articles/{slug}/index.json
/articles/{slug}/index.txt
/articles/{slug}/teaser.json

The HTML page is the canonical browseable representation of the article resource.
The Markdown file provides clean, low-clutter article text.
The JSON-LD file provides machine-readable structured metadata.
The plain-text file provides a minimal text-only retrieval format.
These formats refer to the same underlying article resource.

## Navigation
/sitemap.xml
/sitemap-structural.xml
/topics/
/locations/
/llms/topics/{slug}.txt
/llms/locations/{slug}.txt

The sitemap index at /sitemap.xml is the primary sitemap entry point for machine discovery.
Topic and location indexes provide additional semantic discovery paths.

## Taxonomy / Semantic Structure
The site is organized around multiple machine-meaningful axes.

Topics are organized under /topics/ and reflect the implemented IPTC MediaTopics taxonomy hierarchy.
Locations are organized under /locations/ and reflect the implemented geographic hierarchy.
Topic pages and location pages provide structured discovery paths to related article resources.
Topic and location term pages also expose machine-readable llms files under /llms/topics/{slug}.txt and /llms/locations/{slug}.txt.

This structure is intended to support efficient machine retrieval by:
- grouping semantically related articles under shared topic paths
- grouping geographically related articles under shared location paths
- exposing consistent public format paths for each article resource
- linking discovery layers through sitemap and llms files

The sitemap index at /sitemap.xml links to the structural sitemap and generated topic/location sitemap files.

## Teaser / Free Preview
/articles/{slug}/teaser.json

The teaser file is always free.
It provides summary and metadata for relevance assessment before retrieving the full article resource.
The teaser does not include articleBody.
Per-topic and per-location llms files list recent teaser URLs for machine discovery.