better-ani-scraped 1.4.0 → 1.5.1

package/DOCUMENTATION.md

@@ -1,4 +1,4 @@
-# Ani-Scraped Documentation
+# Better-Ani-Scraped Documentation
 
 A set of utility functions for scraping anime data from multiple sources (only [anime-sama](https://anime-sama.fr) and [animepahe](https://animepahe.ru) available at the moment). This tool allows you to search for anime, retrieve information, get episodes, and more.
 
@@ -6,38 +6,45 @@ A set of utility functions for scraping anime data from multiple sources (only [
 
 ## Summary
 - [Main class](#main-class)
-- [`AnimeScrapper("animesama")` methods](#animescrapperanimesama-methods)
-- [`AnimeScrapper("animepahe")` methods](#animescrapperanimepahe-methods)
-- [`AnimeScrapper("crunchyroll")` methods](#animescrappercrunchyroll-methods)
-- [Functions](#functions)
+- [`AnimeScraper("animesama")` methods](#animescraperanimesama-methods)
+- [`AnimeScraper("animepahe")` methods](#animescraperanimepahe-methods)
+- [`AnimeScraper("crunchyroll")` methods](#animescrapercrunchyroll-methods)
+- [Utility functions](#utility-functions)
 
 ---
 
 ## Main class
 
 ### `AnimeScraper(source)`
-Creates a scrapper for the given source (only "animesama", "animepahe" and "crunchyroll" available at the moment).
+Creates a scraper for the given source (only "animesama", "animepahe" and "crunchyroll" available at the moment).
+```js 
+const animesama = new AnimeScraper('animesama') //for Anime Sama
+const animepahe = new AnimeScraper('animepahe') //for Anime Pahe
+const crunchyroll = new AnimeScraper('crunchyroll') //for Crunchyroll
+```
 
 ---
 
-## `AnimeScrapper("animesama")` methods
+## `AnimeScraper("animesama")` methods
 
-- [searchAnime](#animesamasearchanimequery-limit--10)
+- [searchAnime](#animesamasearchanimequery-limit--10-wantedlanguages--vostfr-vf-vastfr-wantedtypes--anime-film)
 - [getSeasons](#animesamagetseasonsanimeurl-language--vostfr)
-- [getEmbed](#animesamagetembedanimeurl-hostpriority--sibnet-vidmoly)
+- [getEpisodeTitles](#animesamagetepisodetitlesseasonurl-customchromiumpath)
+- [getEmbed](#animesamagetembedseasonurl-hostpriority--sibnet-vidmoly)
 - [getAnimeInfo](#animesamagetanimeinfoanimeurl)
-- [getAvailableLanguages](#animesamagetavailablelanguagesseasonurl-wantedlanguages--vostfr-vf-va-vkr-vcn-vqc)
-- [getAllAnime](#animesamagetallanimeoutput--anime_listjson-get_seasons--false)
+- [getAvailableLanguages](#animesamagetavailablelanguagesseasonurl-wantedlanguages--vostfr-vf-va-vkr-vcn-vqc-vf1-vf2-numberepisodes--false)
+- [getAllAnime](#animesamagetallanimewantedlanguages--vostfr-vf-vastfr-wantedtypes--anime-film-page--null-output--anime_listjson-get_seasons--false)
 - [getLatestEpisodes](#animesamagetlatestepisodeslanguagefilter--null)
-- [getRandomAnime](#animesamagetrandomanime)
-- [getEpisodeTitles](#animesamagetepisodetitlesanimeurl-customChromiumPath)
+- [getRandomAnime](#animesamagetrandomanimewantedlanguages--vostfr-vf-vastfr-wantedtypes--anime-film-maxattempts--null-attempt--0)
 
-### `animesama.searchAnime(query, limit = 10)`
+### `animesama.searchAnime(query, limit = 10, wantedLanguages = ["vostfr", "vf", "vastfr"], wantedTypes = ["Anime", "Film"])`
 Searches for anime titles that match the given query.
 
 - **Parameters:**
   - `query` *(string)*: The search keyword.
   - `limit` *(number)*: Maximum number of results to return (default: 10).
+  - `wantedLanguages` *(string[])*: Array of wanted languages.
+  - `wantedTypes` *(string[])*: Array of wanted types.
 - **Returns:**  
   An array of anime objects:
   ```js
@@ -76,19 +83,34 @@ Fetches all available seasons of an anime in the specified language.
 
 ---
 
-### `animesama.getEmbed(animeUrl, hostPriority = ["sibnet", "vidmoly"])`
+### `animesama.getEpisodeTitles(seasonUrl, customChromiumPath)`
+Fetches the names of all episodes in a season
+
+- **Parameters:**
+  - `seasonUrl` *(string)*: URL of the anime’s season page.
+  - `customChromiumPath` *(string)*: Path of the Chromium folder
+- **Returns:**  
+  An array of episode titles.
+
+---
+
+### `animesama.getEmbed(seasonUrl, hostPriority = ["sibnet", "vidmoly"])`
 Retrieves embed URLs for episodes, prioritizing by host.
 
 - **Parameters:**
-  - `animeUrl` *(string)*: URL of the anime’s season/episode page.
+  - `seasonUrl` *(string)*: URL of the anime’s season page.
   - `hostPriority` *(string[])*: Array of preferred hostnames.
 - **Returns:**  
   An array of embed video:
   ```js
-  {
-    title: string,
-    url: string,
-  }
+  [
+    {
+      title: string,
+      url: string,
+    }
+    ...
+  ]
+
   ```
 ---
 
@@ -111,19 +133,20 @@ Extracts basic information from an anime page.
 
 ---
 
-### `animesama.getAvailableLanguages(seasonUrl, wantedLanguages = ["vostfr", "vf", "va", "vkr", "vcn", "vqc"])`
-Checks which languages are available for a given anime season (not recommended to use the default value of wantedLanguages, the more languages there is the more the function is long to run, only checks for languages you want).
+### `animesama.getAvailableLanguages(seasonUrl, wantedLanguages = ["vostfr", "vf", "va", "vkr", "vcn", "vqc", "vf1", "vf2"], numberEpisodes = false)`
+Checks which languages are available for a given anime season (Avoid using `numberEpisodes = true`, as checking many languages significantly increases execution time).
 
 - **Parameters:**
   - `seasonUrl` *(string)*: The season anime URL.
   - `wantedLanguages` *(string[])*: Language codes to check (e.g., ["vostfr", "vf", "va", ...]).
+  - `numberEpisodes` *(boolean)*: If `true`, also fetches the number of episodes in each language.
 - **Returns:**  
   Array of objects containing available languages and their episode count:
   ```js
   [
     {
       language: string,
-      episodeCount: int
+      episodeCount: number //if numberEpisodes = true
     }
     ...
   ]
@@ -131,14 +154,32 @@ Checks which languages are available for a given anime season (not recommended t
 
 ---
 
-### `animesama.getAllAnime(output = "anime_list.json", get_seasons = false)`
+### `animesama.getAllAnime(wantedLanguages = ["vostfr", "vf", "vastfr"], wantedTypes = ["Anime", "Film"], page = null, output = "anime_list.json", get_seasons = false)`
 Fetches the full anime catalog, optionally including season information.
 
 - **Parameters:**
+  - `wantedLanguages` *(string[])*: Language videos to get.
+  - `wantedTypes` *(string[])*: Types videos to get.
+  - `page` *(number)*: The catalog page number.
   - `output` *(string)*: File name to save the result as JSON.
   - `get_seasons` *(boolean)*: If `true`, also fetches seasons for each anime (very slow, ETA is still unknown).
 - **Returns:**  
-  `true` if successful, `false` otherwise.
+  if `page = null`, `true` if successful, `false` otherwise.
+  else, an array of anime objects :
+  ```js
+  [
+    {
+      url: string,
+      title: string,
+      altTitles: string[],
+      cover: string,
+      genres: string[],
+      types: string[],
+      languages: string[],
+    }
+    ...
+  ]
+  ```
 
 ---
 
@@ -150,20 +191,28 @@ Scrapes the latest released episodes, optionally filtered by language.
 - **Returns:**  
   Array of episode objects:
   ```js
-  {
-    title: string,
-    url: string,
-    cover: string,
-    language: string,
-    episode: string
-  }
+  [
+    {
+      title: string,
+      url: string,
+      cover: string,
+      language: string,
+      episode: string
+    }
+  ...
+  ]
   ```
 
 ---
 
-### `animesama.getRandomAnime()`
+### `animesama.getRandomAnime(wantedLanguages = ["vostfr", "vf", "vastfr"], wantedTypes = ["Anime", "Film"], maxAttempts = null, attempt = 0)`
 Fetches a random anime from the catalogue.
 
+- **Parameters:**
+  - `wantedLanguages` *(string[])*: Language videos to get.
+  - `wantedTypes` *(string[])*: Types videos to get.
+  - `maxAttempts` *(number|null)* The number of attempts of the function. If null, retry until a result is obtained.
+  - `attempt` *(number)* Current number of attempts (leave empty).
 - **Returns:**  
   An anime object:
   ```js
@@ -178,18 +227,8 @@ Fetches a random anime from the catalogue.
 
 ---
 
-### `animesama.getEpisodeTitles(AnimeUrl, customChromiumPath)`
-Fetches the names of all episodes in a season
-
-- **Parameters:**
-  - `animeUrl` *(string)*: URL of the anime’s season/episode page.
-  - `animeUrl` *(string)*: Path of the Chromium folder
-- **Returns:**  
-  An array of episode titles.
-
----
 
-## `AnimeScrapper("animepahe")` methods
+## `AnimeScraper("animepahe")` methods
 
 - [searchAnime](#animepahesearchanimequery)
 
@@ -204,13 +243,13 @@ Searches for anime titles that match the given query.
   ```js
   [
     {
-      id: int,
+      id: number,
       title: string,
       type: string,
-      episodes: int,
+      episodes: number,
       status: string,
       season: string,
-      year: int,
+      year: number,
       score: float,
       session: string,
       cover: string,
@@ -222,7 +261,7 @@ Searches for anime titles that match the given query.
 
 ---
 
-## `AnimeScrapper("crunchyroll")` methods
+## `AnimeScraper("crunchyroll")` methods
 
 - [searchAnime](#crunchyrollsearchanimequery-limit--10)
 - [getEpisodeInfo](#crunchyrollgetepisodeinfoanimeurl-seasontitle)
@@ -268,7 +307,7 @@ Extracts information from all episodes of a season of an anime.
   ```
 ---
 
-## Functions
+## Utility functions 
 
 - [getVideoUrlFromEmbed](#getvideourlfromembedsource-embedurl)
 

package/examples/animepahe/example_usage_searchAnime.js

@@ -0,0 +1,10 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animepahe = new AnimeScraper('animepahe');
+
+  const search = await animepahe.searchAnime("86");
+  console.log("Search Results:", search);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getAllAnime.js

@@ -0,0 +1,10 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+
+  const catalogue = await animesama.getAllAnime(["vostfr", "vf", "vastfr"], ["Anime", "Film"], 2);
+  console.log(catalogue)
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getAnimeInfo.js

@@ -0,0 +1,11 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+  const animeUrl = "https://anime-sama.fr/catalogue/86-eighty-six/";
+
+  const animeInfo = await animesama.getAnimeInfo(animeUrl);
+  console.log(animeInfo);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getAvailableLanguages.js

@@ -0,0 +1,11 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+  const seasonUrl = "https://anime-sama.fr/catalogue/86-eighty-six/saison1/vostfr/";
+
+  const animeLanguages = await animesama.getAvailableLanguages(seasonUrl, ["vostfr", "vf", "va", "vkr","vcn", "vqc", "vf1", "vf2"], false);
+  console.log(animeLanguages);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getEmbed.js

@@ -0,0 +1,11 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+  const seasonUrl = "https://anime-sama.fr/catalogue/86-eighty-six/saison1/vostfr/";
+  
+  const embeds = await animesama.getEmbed(seasonUrl, ["sibnet", "vidmoly"]);
+  console.log("Embed Links:", embeds);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getEpisodeTitles.js

@@ -0,0 +1,11 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+  const seasonUrl = "https://anime-sama.fr/catalogue/86-eighty-six/saison1/vostfr/";
+  
+  const episodeTitles = await animesama.getEpisodeTitles(seasonUrl);
+  console.log("Episode Titles:", episodeTitles);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getLatestEpisodes.js

@@ -0,0 +1,10 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+
+  const new_episodes = await animesama.getLatestEpisodes(["vostfr", "vf"]);
+  console.log(new_episodes);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getRandomAnime.js

@@ -0,0 +1,10 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+
+  const random_episode = await animesama.getRandomAnime(["vostfr", "vf", "vastfr"], ["Anime", "Film"], 10);
+  console.log(random_episode);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_getSeasons.js

@@ -0,0 +1,11 @@
+import { AnimeScraper, getVideoUrlFromEmbed } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+  const animeUrl = "https://anime-sama.fr/catalogue/86-eighty-six/";
+  
+  const seasons = await animesama.getSeasons(animeUrl, "vostfr");
+  console.log("Seasons:", seasons);
+};
+
+main().catch(console.error);

package/examples/animesama/example_usage_searchAnime.js

@@ -0,0 +1,10 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const animesama = new AnimeScraper('animesama');
+
+  const search = await animesama.searchAnime("86", 3, ["vostfr", "vf", "vastfr"], ["Anime", "Film"]);
+  console.log("Search Results:", search);
+};
+
+main().catch(console.error);

package/examples/crunchyroll/example_usage_getEpisodeInfo.js

@@ -0,0 +1,12 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+    const crunchyroll = new AnimeScraper('crunchyroll');
+    const animeUrl = "https://www.crunchyroll.com/fr/series/GVDHX8DM5/86-eighty-six/";
+
+    const episodeInfo = await crunchyroll.getEpisodeInfo(animeUrl, "S2")
+    console.log("Episode Info:", episodeInfo)
+  };
+  
+  main().catch(console.error);
+  

package/examples/crunchyroll/example_usage_searchAnime.js

@@ -0,0 +1,11 @@
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+    const crunchyroll = new AnimeScraper('crunchyroll');
+    
+    const search = await crunchyroll.searchAnime("86", 3);
+    console.log("Search Results:", search);
+  };
+  
+  main().catch(console.error);
+  

package/examples/utility-functions/example_usage_getVideoUrlFromEmbed.js

@@ -0,0 +1,11 @@
+import { getVideoUrlFromEmbed } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+
+const main = async () => {
+  const embedUrl = "https://video.sibnet.ru/shell.php?videoid=4291083";
+  
+  const videoUrl = await getVideoUrlFromEmbed("sibnet", embedUrl)
+  console.log("Video URL:", videoUrl);
+
+};
+
+main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-ani-scraped",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Scrape anime data from different sources (only anime-sama.fr for the moment)",
   "main": "index.js",
   "scripts": {

package/scrapers/animesama.js

@@ -1,10 +1,40 @@
 import axios from "axios";
 import * as cheerio from "cheerio";
 import fs from "fs";
+import path from 'path';
+import { exec as execCallback } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(execCallback);
+ 
 
 const BASE_URL = "https://anime-sama.fr";
 const CATALOGUE_URL = `${BASE_URL}/catalogue`; 
 
+async function ensureChromiumInstalled(customPath) {
+  if (customPath) {
+    if (fs.existsSync(customPath)) {
+      console.log("customPath:", customPath);
+      return customPath;
+    } else {
+      console.log(`The custom path to Chromium is invalid : ${customPath}`);
+    }
+  }
+  const basePath = path.join(
+    process.env.HOME || process.env.USERPROFILE,
+    '.cache',
+    'puppeteer',
+    'chrome'
+  );
+  const chromiumPath = path.join(basePath, 'win64-135.0.7049.95', 'chrome-win64', 'chrome.exe');
+
+  if (!fs.existsSync(chromiumPath)) {
+    console.log("📦 Downloading Chromium 135.0.7049.95...");
+    await execAsync('npx puppeteer browsers install chrome@135.0.7049.95');
+  }
+
+  return chromiumPath;
+}
+
 function getHeaders(referer = BASE_URL) {
   return {
     "User-Agent": "Mozilla/5.0",
@@ -13,10 +43,17 @@ function getHeaders(referer = BASE_URL) {
   };
 }
 
-export async function searchAnime(query, limit = 10) {
-  const url = `${CATALOGUE_URL}/?type%5B%5D=Anime&search=${encodeURIComponent(
+export async function searchAnime(
+  query,
+  limit = 10,
+  wantedLanguages = ["vostfr", "vf", "vastfr"],
+  wantedTypes = ["Anime", "Film"]
+) {
+  const url = `${CATALOGUE_URL}/?search=${encodeURIComponent(
     query
   )}`;
+  const isWanted = (text, list) =>
+    list.some(item => text.toLowerCase().includes(item.toLowerCase()));
   const res = await axios.get(url, { headers: getHeaders(CATALOGUE_URL) });
   const $ = cheerio.load(res.data);
   const results = [];
@@ -34,6 +71,14 @@ export async function searchAnime(query, limit = 10) {
       .trim();
     const cover = anchor.find("img").first().attr("src");
 
+    const tagText = anchor.find("p").filter((_, p) =>
+      isWanted($(p).text(), wantedTypes)
+    ).first().text();
+
+    const languageText = anchor.find("p").filter((_, p) =>
+      isWanted($(p).text(), wantedLanguages)
+    ).first().text();
+
     const altTitles = altRaw
       ? altRaw
           .split(",")
@@ -53,7 +98,7 @@ export async function searchAnime(query, limit = 10) {
           .filter(Boolean)
       : [];
 
-    if (title && link) {
+    if (title && link && tagText && languageText) {
       results.push({
         title,
         altTitles,
@@ -123,37 +168,7 @@ export async function getSeasons(animeUrl, language = "vostfr") {
   return seasons;
 }
 
-
-import path from 'path';
-import { exec as execCallback } from 'child_process';
-import { promisify } from 'util';
-const execAsync = promisify(execCallback);
-
-async function ensureChromiumInstalled(customPath) {
-  if (customPath) {
-    if (fs.existsSync(customPath)) {
-      console.log("customPath:", customPath);
-      return customPath;
-    } else {
-      console.log(`The custom path to Chromium is invalid : ${customPath}`);
-    }
-  }
-  const basePath = path.join(
-    process.env.HOME || process.env.USERPROFILE,
-    '.cache',
-    'puppeteer',
-    'chrome'
-  );
-  const chromiumPath = path.join(basePath, 'win64-135.0.7049.95', 'chrome-win64', 'chrome.exe');
-
-  if (!fs.existsSync(chromiumPath)) {
-    console.log("📦 Downloading Chromium 135.0.7049.95...");
-    await execAsync('npx puppeteer browsers install chrome@135.0.7049.95');
-  }
-
-  return chromiumPath;
-}
-export async function getEpisodeTitles(animeUrl, customChromiumPath) {
+export async function getEpisodeTitles(seasonUrl, customChromiumPath) {
   let browser;
   try {
     const puppeteer = await import('puppeteer');
@@ -177,7 +192,7 @@ export async function getEpisodeTitles(animeUrl, customChromiumPath) {
       }
     });
 
-    await page.goto(animeUrl, { waitUntil: 'domcontentloaded' });
+    await page.goto(seasonUrl, { waitUntil: 'domcontentloaded' });
     await page.waitForSelector('#selectEpisodes');
 
     const titres = await page.$$eval('#selectEpisodes option', options =>
@@ -194,22 +209,21 @@ export async function getEpisodeTitles(animeUrl, customChromiumPath) {
   }
 }
 
-
-export async function getEmbed(animeUrl, hostPriority = ["vidmoly"], customChromiumPath) {
-  const res = await axios.get(animeUrl, {
-    headers: getHeaders(animeUrl.split("/").slice(0, 5).join("/")),
+export async function getEmbed(seasonUrl, hostPriority = ["sibnet", "vidmoly"], customChromiumPath) {
+  const res = await axios.get(seasonUrl, {
+    headers: getHeaders(seasonUrl.split("/").slice(0, 5).join("/")),
   });
 
   const $ = cheerio.load(res.data);
   const scriptTag = $('script[src*="episodes.js"]').attr("src");
   if (!scriptTag) throw new Error("No episodes script found");
 
-  const scriptUrl = animeUrl.endsWith("/")
-    ? animeUrl + scriptTag
-    : animeUrl + "/" + scriptTag;
+  const scriptUrl = seasonUrl.endsWith("/")
+    ? seasonUrl + scriptTag
+    : seasonUrl + "/" + scriptTag;
 
   const episodesJs = await axios
-    .get(scriptUrl, { headers: getHeaders(animeUrl) })
+    .get(scriptUrl, { headers: getHeaders(seasonUrl) })
     .then((r) => r.data);
 
   const matches = [
@@ -243,14 +257,13 @@ export async function getEmbed(animeUrl, hostPriority = ["vidmoly"], customChrom
     finalEmbeds.push(selectedUrl || null);
   }
 
-  const titles = await getEpisodeTitles(animeUrl, customChromiumPath);
+  const titles = await getEpisodeTitles(seasonUrl, customChromiumPath);
   return finalEmbeds.map((url, i) => ({
     title: titles[i] || "Untitled",
     url,
   }));
 }
 
-
 export async function getAnimeInfo(animeUrl) {
   const res = await axios.get(animeUrl, { headers: getHeaders(CATALOGUE_URL) });
   const $ = cheerio.load(res.data);
@@ -285,7 +298,8 @@ export async function getAnimeInfo(animeUrl) {
 
 export async function getAvailableLanguages(
   seasonUrl,
-  wantedLanguages = ["vostfr", "vf", "va", "vkr", "vcn", "vqc"]
+  wantedLanguages = ["vostfr", "vf", "va", "vkr", "vcn", "vqc", "vf1", "vf2"],
+  numberEpisodes = false
 ) {
   const languageLinks = [];
 
@@ -297,87 +311,109 @@ export async function getAvailableLanguages(
         headers: getHeaders(CATALOGUE_URL),
       });
       if (res.status === 200) {
-        const episodeCount = (await getEmbed(languageUrl)).length;
-        languageLinks.push({ language: language.toUpperCase(), episodeCount: episodeCount });
+        if (numberEpisodes){
+          const episodeCount = (await getEmbed(languageUrl)).length;
+          languageLinks.push({ language: language.toUpperCase(), episodeCount: episodeCount });
+        } else {
+          languageLinks.push({ language: language.toUpperCase()});
+        }
+        
       }
     } catch (error) {
       // If an error occurs (like a 404), we skip that language
       continue;
     }
   }
-
   return languageLinks;
 }
 
 export async function getAllAnime(
+  wantedLanguages = ["vostfr", "vf", "vastfr"],
+  wantedTypes = ["Anime", "Film"],
+  page = null,
   output = "anime_list.json",
   get_seasons = false
 ) {
-  // BE CAREFUL, GET_SEASONS TAKES A VERY VERY LONG TIME TO FINISH
   let animeLinks = [];
-  let page = 1;
 
-  try {
-    while (true) {
-      const url = page === 1 ? CATALOGUE_URL : `${CATALOGUE_URL}?page=${page}`;
-      const res = await axios.get(url, { headers: getHeaders(CATALOGUE_URL) });
-      const $ = cheerio.load(res.data);
-
-      const containers = $("div.shrink-0.m-3.rounded.border-2");
+  const isWanted = (text, list) =>
+    list.some(item => text.toLowerCase().includes(item.toLowerCase()));
 
-      if (containers.length === 0) {
-        // console.log("No more anime found, stopping.");
-        break;
+  const fetchPage = async (pageNum) => {
+    const url = pageNum === 1 ? CATALOGUE_URL : `${CATALOGUE_URL}?page=${pageNum}`;
+    const res = await axios.get(url, { headers: getHeaders(CATALOGUE_URL) });
+    const $ = cheerio.load(res.data);
+  
+    const containers = $("div.shrink-0.m-3.rounded.border-2");
+  
+    containers.each((_, el) => {
+      const anchor = $(el).find("a");
+      const title = anchor.find("h1").text().trim();
+      const link = anchor.attr("href");
+      const img = anchor.find("img").attr("src");
+  
+      const paragraphs = anchor.find("p").toArray().map(p => $(p).text().trim());
+  
+      const altTitles = paragraphs[0] ? paragraphs[0].split(',').map(name => name.trim()) : [];
+      const genres = paragraphs[1] ? paragraphs[1].split(',').map(genre => genre.trim()) : [];
+      const type = paragraphs[2] ? paragraphs[2].split(',').map(t => t.trim()) : [];
+      const language = paragraphs[3] ? paragraphs[3].split(',').map(lang => lang.trim()) : [];
+      const filteredTypes = type.filter(t => isWanted(t, wantedTypes));
+      const filteredLanguages = language.filter(lang => isWanted(lang, wantedLanguages));
+      if (
+        title &&
+        link &&
+        filteredTypes.length > 0 &&
+        filteredLanguages.length > 0
+      ) {
+        const fullUrl = link.startsWith("http") ? link : `${BASE_URL}${link}`;
+        animeLinks.push({
+          url: fullUrl,
+          title,
+          altTitles,
+          cover: img,
+          genres,
+          types: filteredTypes,
+          languages: filteredLanguages,
+        });
       }
-
-      containers.each((_, el) => {
-        const anchor = $(el).find("a");
-        const title = anchor.find("h1").text().trim();
-        const link = anchor.attr("href");
-
-        const tagText = anchor
-          .find("p")
-          .filter((_, p) => $(p).text().includes("Anime"))
-          .first()
-          .text();
-
-        if (title && link && tagText.includes("Anime")) {
-          const fullUrl = link.startsWith("http") ? link : `${BASE_URL}${link}`;
-          animeLinks.push({ title: title, url: fullUrl });
-        }
-      });
-
-      page++;
-      await new Promise((r) => setTimeout(r, 300));
+    });
+  
+    return containers.length > 0;
+  };
+  
+  const enrichWithSeasons = async (list) => {
+    for (const anime of list) {
+      try {
+        const seasons = await getSeasons(anime.url);
+        anime.seasons = Array.isArray(seasons) ? seasons : [];
+      } catch (err) {
+        console.warn(`⚠️ Failed to fetch seasons for ${anime.title}: ${err.message}`);
+        anime.seasons = [];
+      }
+      await new Promise(r => setTimeout(r, 300));
     }
+  };
 
-    // Deduplicate
-    const uniqueLinks = animeLinks.filter(
-      (item, index, self) => index === self.findIndex((i) => i.url === item.url)
-    );
+  try {
+    if (page) {
+      await fetchPage(page);
+      if (get_seasons) await enrichWithSeasons(animeLinks);
+      return animeLinks;
+    } else {
+      let currentPage = 1;
+      while (await fetchPage(currentPage++)) {
+        await new Promise(r => setTimeout(r, 300));
+      }
 
-    if (get_seasons) {
-      // console.log("Fetching seasons for each anime...");
-      for (let anime of uniqueLinks) {
-        try {
-          const seasons = await getSeasons(anime.url);
-          anime.seasons = Array.isArray(seasons) ? seasons : [];
-        } catch (err) {
-          console.warn(
-            `⚠️ Failed to fetch seasons for ${anime.name}: ${err.message}`
-          );
-          anime.seasons = [];
-        }
+      const uniqueLinks = [...new Map(animeLinks.map(item => [item.url, item])).values()];
+      if (get_seasons) await enrichWithSeasons(uniqueLinks);
 
-        // Optional delay to avoid rate-limiting
-        await new Promise((r) => setTimeout(r, 300));
-      }
+      fs.writeFileSync(output, JSON.stringify(uniqueLinks, null, 2), "utf-8");
+      return true;
     }
-
-    fs.writeFileSync(output, JSON.stringify(uniqueLinks, null, 2), "utf-8");
-    return true;
   } catch (err) {
-    console.error("Error occurred:", err.message);
+    console.error("error :", err.message);
     return false;
   }
 }
@@ -424,13 +460,21 @@ export async function getLatestEpisodes(languageFilter = null) {
   }
 }
 
-export async function getRandomAnime() {
+export async function getRandomAnime(
+  wantedLanguages = ["vostfr", "vf", "vastfr"],
+  wantedTypes = ["Anime", "Film"],
+  maxAttempts = null,
+  attempt = 0
+) {
   try {
     const res = await axios.get(
-      `${CATALOGUE_URL}/?type[]=Anime&search=&random=1`,
+      `${CATALOGUE_URL}/?search=&random=1`,
       { headers: getHeaders(CATALOGUE_URL) }
     );
+
     const $ = cheerio.load(res.data);
+    const isWanted = (text, list) =>
+      list.some(item => text.toLowerCase().includes(item.toLowerCase()));
 
     const container = $("div.shrink-0.m-3.rounded.border-2").first();
     const anchor = container.find("a");
@@ -463,7 +507,15 @@ export async function getRandomAnime() {
           .filter(Boolean)
       : [];
 
-    if (title && link) {
+    const tagText = anchor.find("p").filter((_, p) =>
+      isWanted($(p).text(), wantedTypes)
+    ).first().text();
+
+    const languageText = anchor.find("p").filter((_, p) =>
+      isWanted($(p).text(), wantedLanguages)
+    ).first().text();
+
+    if (title && link && tagText && languageText) {
       return {
         title,
         altTitles,
@@ -472,10 +524,15 @@ export async function getRandomAnime() {
         cover,
       };
     } else {
-      throw new Error("No anime found in random response.");
+      if (maxAttempts === null || attempt < maxAttempts) {
+        return await getRandomAnime(wantedLanguages, wantedTypes, maxAttempts, attempt + 1);
+      } else {
+        throw new Error("Max attempts reached without finding a valid anime.");
+      }
     }
   } catch (err) {
     console.error("Failed to fetch random anime:", err.message);
     return null;
   }
 }
+

package/scrapers/scrapers.js

@@ -33,9 +33,18 @@ export class AnimeScraper {
     }
   }
 
-  async getEmbed(animeUrl, ...rest) {
+  async getEpisodeTitles(seasonUrl, ...rest) {
     try {
-      return await this.source.getEmbed(animeUrl, ...rest);
+      return await this.source.getEpisodeTitles(seasonUrl, ...rest);
+    } catch (error) {
+      console.error(`This scraper does not have the getEpisodeTitles function implemented or an error happened -> ${error}`);
+      return null;
+    }
+  }
+  
+  async getEmbed(seasonUrl, ...rest) {
+    try {
+      return await this.source.getEmbed(seasonUrl, ...rest);
     } catch (error) {
       console.error(`This scraper does not have the getEmbed function implemented or an error happened -> ${error}`);
       return null;
@@ -78,23 +87,15 @@ export class AnimeScraper {
     }
   }
 
-  async getRandomAnime() {
+  async getRandomAnime(...rest) {
     try {
-      return await this.source.getRandomAnime();
+      return await this.source.getRandomAnime(...rest);
     } catch (error) {
       console.error(`This scraper does not have the getRandomAnime function implemented or an error happened -> ${error}`);
       return null;
     }
   }
 
-  async getEpisodeTitles(animeUrl, ...rest) {
-    try {
-      return await this.source.getEpisodeTitles(animeUrl, ...rest);
-    } catch (error) {
-      console.error(`This scraper does not have the getEpisodeTitles function implemented or an error happened -> ${error}`);
-      return null;
-    }
-  }
   async getEpisodeInfo(animeUrl, ...rest) {
     try {
       return await this.source.getEpisodeInfo(animeUrl, ...rest);

package/examples/example_usage_01.js

@@ -1,23 +0,0 @@
-import { AnimeScraper, getVideoUrlFromEmbed } from "../index.js"; // REPLACE BY "from 'better-ani-scraped';"
-
-const main = async () => {
-  const scraper = new AnimeScraper('animesama');
-
-  const search = await scraper.searchAnime("86");
-  console.log("Search Results:", search);
-
-  const animeUrl = Object.values(search)[0].url;
-  const seasons = await scraper.getSeasons(animeUrl, "vostfr");
-  console.log("Seasons:", seasons);
-
-  const embeds = await scraper.getEmbed(seasons[0].url, [
-    "sibnet",
-    "vidmoly",
-  ]);
-  console.log("Embed Links:", embeds);
-
-  const videoUrl = await getVideoUrlFromEmbed("sibnet", embeds[0].url)
-  console.log("Video URL:", videoUrl);
-};
-
-main().catch(console.error);

package/examples/example_usage_02.js

@@ -1,14 +0,0 @@
-import { AnimeScraper } from "../index.js"; // REPLACE BY "from 'better-ani-scraped';"
-
-const main = async () => {
-  const scraper = new AnimeScraper('animesama');
-
-  const animeUrl = "https://anime-sama.fr/catalogue/sword-art-online";
-  const animeInfo = await scraper.getAnimeInfo(animeUrl);
-  console.log(animeInfo);
-
-  const animeLanguages = await scraper.getAvailableLanguages(`${animeUrl}/saison1/vostfr`, ["vostfr", "vf"]);
-  console.log(animeLanguages);
-};
-
-main().catch(console.error);

package/examples/example_usage_03.js

@@ -1,9 +0,0 @@
-import { AnimeScraper } from "../index.js"; // REPLACE BY "from 'better-ani-scraped';"
-
-const main = async () => {
-  const scraper = new AnimeScraper('animesama');
-
-  await scraper.getAllAnime("output_anime_list.json", false);
-};
-
-main().catch(console.error);

package/examples/example_usage_04.js

@@ -1,13 +0,0 @@
-import { AnimeScraper } from "../index.js"; // REPLACE BY "from 'better-ani-scraped';"
-
-const main = async () => {
-  const scraper = new AnimeScraper('animesama');
-
-  const new_episodes = await scraper.getLatestEpisodes(["vostfr", "vf"]);
-  console.log(new_episodes);
-
-  const random_episode = await scraper.getRandomAnime();
-  console.log(random_episode);
-};
-
-main().catch(console.error);

package/examples/example_usage_05.js

@@ -1,13 +0,0 @@
-import { AnimeScraper } from "../index.js"; // REPLACE BY "from 'better-ani-scraped';"
-
-const main = async () => {
-    const scraper = new AnimeScraper('crunchyroll');
-    const search = await scraper.searchAnime("86");
-    console.log("Search Results:", search);
-    
-    const episodeInfo = await scraper.getEpisodeInfo(search[0].url, "S2")
-    console.log("Episode Info:", episodeInfo)
-  };
-  
-  main().catch(console.error);
-