diff --git a/skills/the-news/CONTRIBUTORS b/skills/the-news/CONTRIBUTORS new file mode 100644 index 0000000..d8649da --- /dev/null +++ b/skills/the-news/CONTRIBUTORS @@ -0,0 +1 @@ +root diff --git a/skills/the-news/SKILL.md b/skills/the-news/SKILL.md new file mode 100644 index 0000000..3165e51 --- /dev/null +++ b/skills/the-news/SKILL.md @@ -0,0 +1,28 @@ +--- +name: the-news +description: Gives agents real-time and archival access to front-page headlines across 20 countries for breaking news, current events, and comparative media analysis. +--- + +This skill gives agents access to the main headlines of many newspapers and news sites, across 20 countries, via a public API. +The API has two modes: a live mode, updated in near real-time, and an archive mode that lets you fetch the headlines from a given moment in time. + +## Endpoint +`GET https://www.thehear.org/api/country-view/[country]` + +Supported countries: us, uk, germany, france, italy, spain, portugal, netherlands, belgium, switzerland, austria, turkey, israel, india, japan, south-korea, china, brazil, mexico, argentina + +## Calls +Snapshot of current headlines: +`https://www.thehear.org/api/country-view/[country]` + +Historical snapshot at a UTC timestamp: +`https://www.thehear.org/api/country-view/[country]?at=2026-05-01T20:00:00Z` + +Daily overview range: +`https://www.thehear.org/api/country-view/[country]?call=daily-overviews&from=YYYY-MM-DD&to=YYYY-MM-DD` + +## Reading Guidance +- Be mindful of different biases and orientations of various sources +- The API gives headlines, subtitles, and links to full articles +- Treat this as a multi-source snapshot, not as final verification +- AI overviews help contextualize but headlines are the source of truth