konachan-scraper

Lightweight ESM/TypeScript library to fetch random anime image URLs from konachan.com / konachan.net by tag.

Install

npm install
npm run build

Requiere Node ≥ 18 (fetch nativo + AbortSignal.timeout).

Usage

import { KonachanScraper } from "konachan-scraper";

const url = await KonachanScraper.getRandomUrl("hatsune_miku");
console.log(url);

const post = await KonachanScraper.getRandomPost("rem_(re:zero)");
if (post) {
    console.log(post.id, post.tags, post.sample_url, post.gender);
}

KonachanScraper.clearCache();

API

KonachanScraper.getRandomUrl(tag: string): Promise<string | null>

KonachanScraper.getRandomPost(tag: string): Promise<KonachanPost | null>

KonachanScraper.clearCache(): void

Cambios vs. la versión JS original

• Migrado a TypeScript estricto (strict, noUncheckedIndexedAccess).
• Tipos KonachanApiPost / KonachanPost / GenderTag exportados.
• Fix: #buildPool ahora deduplica por id al mezclar el pool del tag completo con el fallback del tag base (antes podía haber posts repetidos en el pool aleatorio).
• Fix: getRandomUrl ya no duplica la lógica de resolución de pool; reutiliza getRandomPost internamente.