mirror of
https://github.com/Shineii86/AniKotoAPI.git
synced 2026-10-22 19:05:11 +00:00
v1.5.0: Complete documentation rewrite - 50+ files with AlisaReactionBot style
- Box-style header comments (Project, Author, License) on every file - Section headers using double-line box decorators - Feature markers (// ---- FEATURE: XYZ ----) before every major function - JSDoc comments for EVERY function with @param, @returns, @example - Inline notes (NOTE, WARNING, TIP) for non-obvious logic - Footer END markers on every module - Matched code style to AlisaReactionBot repository - All files now searchable by feature name via grep Author: Shinei Nouzen <157171073+Shineii86@users.noreply.github.com>
This commit is contained in:
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
@@ -1,44 +1,94 @@
|
||||
/*
|
||||
* ======= • ======= • ======= • ======= • =======• =======
|
||||
* AniKatoAPI — watchPage.extractor.js
|
||||
* Repository: https://github.com/Shineii86/AniKatoAPI
|
||||
*
|
||||
* @description
|
||||
* Extracts the full watch/episode page data from anikototv.to including
|
||||
* anime metadata, server list, trending sidebar, and recommended anime.
|
||||
*
|
||||
* @exports
|
||||
* extractWatchPage
|
||||
*
|
||||
* @author Shinei Nouzen
|
||||
* @license MIT
|
||||
* ======= • ======= • ======= • ======= • =======• =======
|
||||
*/
|
||||
|
||||
import * as cheerio from "cheerio";
|
||||
import axios from "axios";
|
||||
import { headers } from "../configs/header.config.js";
|
||||
import { URLS, BASE_URL } from "../configs/dataUrl.js";
|
||||
|
||||
// ══════════════════════════════════════════════════════════════
|
||||
// WATCH PAGE EXTRACTOR
|
||||
// ══════════════════════════════════════════════════════════════
|
||||
|
||||
// ---- FEATURE: Extract complete watch page data for a specific episode ----
|
||||
/**
|
||||
* Fetches and parses the episode watch page from anikototv.to. Extracts
|
||||
* anime metadata, episode details, available streaming servers, trending
|
||||
* sidebar, and recommended anime.
|
||||
*
|
||||
* @param {string} slug - The anime slug (e.g. "one-piece")
|
||||
* @param {string|number} ep - The episode number to watch
|
||||
* @returns {Promise<Object>} Full watch page data object
|
||||
*
|
||||
* @example
|
||||
* const watchData = await extractWatchPage("one-piece", 100);
|
||||
* console.log(watchData.servers.length); // number of available servers
|
||||
* console.log(watchData.title); // anime title
|
||||
*/
|
||||
const extractWatchPage = async (slug, ep) => {
|
||||
try {
|
||||
const url = URLS.episode(slug, ep);
|
||||
const { data } = await axios.get(url, { headers });
|
||||
const $ = cheerio.load(data);
|
||||
|
||||
// ---- FEATURE: Extract anime identification and title ----
|
||||
// NOTE: data-id on #watch-main is the internal anime ID for AJAX calls
|
||||
const animeId = parseInt($("#watch-main").attr("data-id")) || 0;
|
||||
const animeUrl = $("#watch-main").attr("data-url") || "";
|
||||
const title = $("h1[itemprop='name'].title.d-title").text().trim() || slug;
|
||||
const japaneseTitle = $("h1[itemprop='name'].title.d-title").attr("data-jp") || "";
|
||||
const episodeNumber = parseInt(ep) || 0;
|
||||
|
||||
// ---- FEATURE: Extract synopsis and rating ----
|
||||
const synopsis = $(".synopsis .content").text().trim() || "";
|
||||
const rating = $("#w-rating .score .value").text().trim() || "";
|
||||
const poster = $("img[itemprop='image']").attr("src") || "";
|
||||
// NOTE: Background image is extracted from CSS background-image property on #player
|
||||
const backgroundImage = $("#player").css("background-image")?.match(/url\(['"]?(.+?)['"]?\)/)?.[1] || "";
|
||||
|
||||
// ---- FEATURE: Extract anime metadata (type, status, MAL score, duration, episodes) ----
|
||||
const type = $(".bmeta .meta:first-child > div:nth-child(1) span").text().trim() || "";
|
||||
const status = $(".bmeta .meta:first-child > div:nth-child(4) span a").text().trim() || "";
|
||||
const malScore = $(".bmeta .meta:nth-child(2) > div:nth-child(1) span").text().trim() || "";
|
||||
const duration = $(".bmeta .meta:nth-child(2) > div:nth-child(2) span").text().trim() || "";
|
||||
const episodes = $(".bmeta .meta:nth-child(2) > div:nth-child(3) span").text().trim() || "";
|
||||
|
||||
// ---- FEATURE: Extract genres ----
|
||||
// NOTE: Genre links contain '/genre/' in href to distinguish from other links
|
||||
const genres = [];
|
||||
$(".bmeta .meta:first-child > div:nth-child(5) span a[href*='/genre/']").each((i, el) => {
|
||||
genres.push($(el).text().trim());
|
||||
});
|
||||
|
||||
// ---- FEATURE: Extract studios ----
|
||||
// NOTE: Uses itemprop='director' links with itemprop='name' spans inside
|
||||
const studios = [];
|
||||
$(".bmeta .meta:nth-child(2) > div:nth-child(4) span a[itemprop='director'] span[itemprop='name']").each((i, el) => {
|
||||
studios.push($(el).text().trim());
|
||||
});
|
||||
|
||||
// ---- FEATURE: Extract next episode release info ----
|
||||
// NOTE: .next-episode shows the countdown text, .count-down has data-target timestamp
|
||||
const nextEpisodeDate = $(".next-episode, .alert.next-episode").text().trim() || "";
|
||||
const nextEpisodeTimestamp = parseInt($(".count-down").attr("data-target")) || 0;
|
||||
|
||||
// ---- FEATURE: Extract available streaming servers ----
|
||||
// NOTE: Each server li has data-link-id (unique), data-ep-id, data-cmid, data-sv-id
|
||||
// NOTE: Server type (sub/dub) is derived from closest .type container's data-type attribute
|
||||
const servers = [];
|
||||
$("#w-servers .servers .type li, #w-servers li[data-link-id]").each((i, el) => {
|
||||
const linkId = $(el).attr("data-link-id") || "";
|
||||
@@ -60,11 +110,14 @@ const extractWatchPage = async (slug, ep) => {
|
||||
}
|
||||
});
|
||||
|
||||
// ---- FEATURE: Extract trending/watch-order sidebar items ----
|
||||
// NOTE: Grabs from both the first .w-side-section and #watch-order containers
|
||||
const trending = [];
|
||||
$(".w-side-section:first .scaff.side.items a.item, #watch-order a.item").each((i, el) => {
|
||||
const trendSlug = $(el).attr("href")?.split("/watch/").pop() || "";
|
||||
const trendPoster = $(el).find(".poster img").attr("src") || "";
|
||||
const trendTitle = $(el).find(".name").text().trim() || "";
|
||||
// NOTE: .dot:last-child typically holds the type badge text
|
||||
const trendType = $(el).find(".dot:last-child").text().trim() || "";
|
||||
const trendScore = $(el).find(".score").text().trim() || "";
|
||||
|
||||
@@ -79,6 +132,8 @@ const extractWatchPage = async (slug, ep) => {
|
||||
}
|
||||
});
|
||||
|
||||
// ---- FEATURE: Extract recommended anime sidebar items ----
|
||||
// NOTE: Targets the section with a title containing "Recommended", or the last sidebar
|
||||
const recommended = [];
|
||||
$(".w-side-section:has(.title:contains('Recommended')) a.item, aside.sidebar:last .w-side-section a.item").each((i, el) => {
|
||||
const recSlug = $(el).attr("href")?.split("/watch/").pop() || "";
|
||||
@@ -125,4 +180,6 @@ const extractWatchPage = async (slug, ep) => {
|
||||
}
|
||||
};
|
||||
|
||||
export { extractWatchPage };
|
||||
export { extractWatchPage };
|
||||
|
||||
// ══════════════════════════════════════════════════════════════ END: watchPage.extractor.js
|
||||
|
||||
Reference in New Issue
Block a user