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
68 lines
3.2 KiB
JavaScript
68 lines
3.2 KiB
JavaScript
// steam app — fetch a single Steam game / DLC / app's storefront detail.
|
|
//
|
|
// Hits the public appdetails API (`/api/appdetails?appids=<id>`). Surfaces
|
|
// the columns most useful for an agent: name, type, free flag, release
|
|
// date, developers / publishers, price, metacritic, recommendations,
|
|
// genres / categories joined.
|
|
import { cli, Strategy } from '@jackwener/opencli/registry';
|
|
import { EmptyResultError } from '@jackwener/opencli/errors';
|
|
import { STEAM_STORE, decodeHtmlEntities, priceCents, requireAppId, requireCountryCode, steamFetch } from './utils.js';
|
|
|
|
function joinNames(list) {
|
|
if (!Array.isArray(list)) return '';
|
|
return list
|
|
.map((entry) => (entry && typeof entry === 'object' ? entry.description ?? entry.name ?? '' : String(entry)))
|
|
.filter(Boolean)
|
|
.join(', ');
|
|
}
|
|
|
|
cli({
|
|
site: 'steam',
|
|
name: 'app',
|
|
access: 'read',
|
|
description: 'Steam storefront detail for a single app id',
|
|
domain: 'store.steampowered.com',
|
|
strategy: Strategy.PUBLIC,
|
|
browser: false,
|
|
args: [
|
|
{ name: 'id', positional: true, required: true, help: 'Numeric Steam app id (e.g. "620" for Portal 2)' },
|
|
{ name: 'currency', default: 'us', help: 'Storefront country code (e.g. us / cn / jp / de)' },
|
|
],
|
|
columns: [
|
|
'id', 'name', 'type', 'isFree', 'releaseDate', 'developers', 'publishers',
|
|
'price', 'currency', 'metacritic', 'recommendations', 'genres', 'categories',
|
|
'shortDescription', 'website', 'url',
|
|
],
|
|
func: async (args) => {
|
|
const appId = requireAppId(args.id);
|
|
const cc = requireCountryCode(args.currency);
|
|
const url = `${STEAM_STORE}/api/appdetails?appids=${appId}&l=en&cc=${encodeURIComponent(cc)}`;
|
|
const body = await steamFetch(url, `steam app ${appId}`);
|
|
const wrapper = body?.[appId];
|
|
if (!wrapper || wrapper.success !== true || !wrapper.data) {
|
|
throw new EmptyResultError('steam app', `Steam app id ${appId} returned no data (may be region-locked or removed).`);
|
|
}
|
|
const data = wrapper.data;
|
|
const isFree = data.is_free === true;
|
|
const priceFinal = priceCents(data?.price_overview?.final ?? null);
|
|
return [{
|
|
id: String(data.steam_appid ?? appId),
|
|
name: decodeHtmlEntities(data.name ?? ''),
|
|
type: String(data.type ?? ''),
|
|
isFree,
|
|
releaseDate: String(data?.release_date?.date ?? ''),
|
|
developers: Array.isArray(data.developers) ? data.developers.join(', ') : '',
|
|
publishers: Array.isArray(data.publishers) ? data.publishers.join(', ') : '',
|
|
price: isFree ? 0 : priceFinal,
|
|
currency: String(data?.price_overview?.currency ?? '').toUpperCase(),
|
|
metacritic: data?.metacritic?.score != null ? Number(data.metacritic.score) : null,
|
|
recommendations: data?.recommendations?.total != null ? Number(data.recommendations.total) : null,
|
|
genres: joinNames(data.genres),
|
|
categories: joinNames(data.categories),
|
|
shortDescription: decodeHtmlEntities(data.short_description ?? ''),
|
|
website: String(data.website ?? ''),
|
|
url: `${STEAM_STORE}/app/${data.steam_appid ?? appId}/`,
|
|
}];
|
|
},
|
|
});
|