mirror of
https://github.com/jackwener/OpenCLI.git
synced 2026-09-14 18:25:42 +08:00
jakevin
a78ceb1602
* feat: 11 read adapters across 8 sites (dblp / steam / bbc / devto / lobsters / medium / coingecko / hf) Round 2 of the adapter expansion sweep. All 11 commands hit public APIs (no browser, no auth), follow the post-#1332 typed-error / no-silent-failure discipline, and were live-verified against real endpoints. New adapters: - dblp/author : recent publications for one author (resolve PID by name, or pass --pid) - steam/search : storefront name search (storesearch API) - steam/app : single app detail (appdetails API; HTML entities decoded) - bbc/topic : per-topic RSS (8 canonical BBC News feeds) - devto/latest : /api/articles/latest with --page pagination - lobsters/domain : stories from a specific source domain (/domains/<d>.json) - medium/tag : tag RSS (description full-length, no silent truncation) - coingecko/exchanges : trust score + 24h BTC volume leaderboard - coingecko/categories : sector buckets with 6 sort options - coingecko/global : aggregate market totals + BTC/ETH dominance - hf/paper : single-paper detail by arXiv id (summary, ai_summary, ai_keywords, upvotes) Also adds clis/steam/utils.js + clis/bbc/utils.js as shared helpers (HTML entity decode, RSS parsing). All listings carry a round-trippable id where a detail sibling exists; advise:listing-id-pairing reports zero new violations. typed- error-lint and silent-column-drop gates both unchanged from baseline. Manifest: 698 → 709 (+11 entries). * fix: tighten adapter round2 contracts
58 lines
2.0 KiB
JavaScript
58 lines
2.0 KiB
JavaScript
// bbc topic — BBC News headlines for a specific category, via public RSS.
|
|
//
|
|
// BBC publishes per-section RSS feeds at
|
|
// `https://feeds.bbci.co.uk/news/<topic>/rss.xml`. We expose the eight
|
|
// canonical sections and reject anything else with a typed argument error
|
|
// so the user knows the supported set.
|
|
import { cli, Strategy } from '@jackwener/opencli/registry';
|
|
import { ArgumentError, EmptyResultError } from '@jackwener/opencli/errors';
|
|
import { bbcFetchRss, parseRssItems, pubDateToIso, requireBoundedInt } from './utils.js';
|
|
|
|
const TOPICS = [
|
|
'world',
|
|
'business',
|
|
'politics',
|
|
'health',
|
|
'education',
|
|
'science_and_environment',
|
|
'technology',
|
|
'entertainment_and_arts',
|
|
];
|
|
|
|
cli({
|
|
site: 'bbc',
|
|
name: 'topic',
|
|
access: 'read',
|
|
description: 'BBC News headlines for a specific section (RSS feed)',
|
|
domain: 'www.bbc.com',
|
|
strategy: Strategy.PUBLIC,
|
|
browser: false,
|
|
args: [
|
|
{ name: 'topic', positional: true, required: true, help: `Section name (${TOPICS.join(' / ')})` },
|
|
{ name: 'limit', type: 'int', default: 20, help: 'Max headlines (1-50)' },
|
|
],
|
|
columns: ['rank', 'title', 'description', 'pubDate', 'url'],
|
|
func: async (args) => {
|
|
const raw = String(args.topic ?? '').trim().toLowerCase().replace(/[\s-]+/g, '_');
|
|
if (!TOPICS.includes(raw)) {
|
|
throw new ArgumentError(
|
|
`bbc topic "${args.topic}" is not supported`,
|
|
`Supported topics: ${TOPICS.join(', ')}`,
|
|
);
|
|
}
|
|
const limit = requireBoundedInt(args.limit, 20, 50);
|
|
const xml = await bbcFetchRss(`${raw}/rss.xml`, `bbc topic ${raw}`);
|
|
const items = parseRssItems(xml);
|
|
if (!items.length) {
|
|
throw new EmptyResultError('bbc topic', `BBC ${raw} feed returned no items.`);
|
|
}
|
|
return items.slice(0, limit).map((it, i) => ({
|
|
rank: i + 1,
|
|
title: it.title,
|
|
description: it.description,
|
|
pubDate: pubDateToIso(it.pubDate),
|
|
url: it.link,
|
|
}));
|
|
},
|
|
});
|