kuramanime-api 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mmoaa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,263 @@
+# Kuramanime API
+
+REST API untuk scraping data anime dari Kuramanime — portal streaming anime sub Indo.
+
+```bash
+# Coba langsung via curl — no install!
+curl https://musician-optics-mental-carey.trycloudflare.com/api/anime?page=1
+```
+
+## 🎬 Demo
+
+https://github.com/user-attachments/assets/files/kuramanime-api/docs/demo.mp4
+
+[▶️ **Tonton demo**](docs/demo.mp4) — 26 detik showcase semua endpoint live via curl.
+
+## ⚡ Quick Start
+
+### Opsi 1: NPM Global Install
+
+```bash
+npm install -g kuramanime-api
+kuramanime-api
+# → http://localhost:3000
+```
+
+### Opsi 2: Self-host (clone repo)
+
+```bash
+git clone https://github.com/mocasus/kuramanime-api.git
+cd kuramanime-api
+npm install
+npm start
+# → http://localhost:3000
+```
+
+### Opsi 3: Vercel Deploy 🚀
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/mocasus/kuramanime-api)
+
+1-click deploy — gratis, auto-scale, langsung dapat endpoint publik. Set env `BROWSER_FARM_URL` + `BROWSER_FARM_KEY`.
+
+### Opsi 4: Pakai cURL (no install, langsung coba)
+
+```bash
+# List anime terbaru
+curl "https://musician-optics-mental-carey.trycloudflare.com/api/anime?page=1"
+
+# Search anime
+curl "https://musician-optics-mental-carey.trycloudflare.com/api/search?q=naruto"
+
+# Detail anime
+curl "https://musician-optics-mental-carey.trycloudflare.com/api/anime/fuguushoku-kanteishi-ga-jitsu-wa-saikyou-datta"
+
+# Episode + server streaming
+curl "https://musician-optics-mental-carey.trycloudflare.com/api/anime/fuguushoku-kanteishi-ga-jitsu-wa-saikyou-datta/1"
+
+# Cek status source
+curl "https://musician-optics-mental-carey.trycloudflare.com/api/status"
+```
+
+> **Demo URL:** `musician-optics-mental-carey.trycloudflare.com` _(Cloudflare Tunnel — uptime tidak dijamin. Untuk production, self-host!)_
+
+
+### Opsi 5: Docker
+
+```bash
+docker compose up -d
+```
+
+## Endpoints API
+
+| Method | Endpoint | Deskripsi |
+|--------|----------|-----------|
+| `GET` | `/api/anime?page=1` | List anime terbaru (5/page) |
+| `GET` | `/api/anime/:slug` | Detail anime + daftar episode |
+| `GET` | `/api/anime/:slug/:episode` | Server streaming + video URL |
+| `GET` | `/api/search?q=judul` | Search anime (min 2 karakter) |
+| `GET` | `/api/status` | Cek status source (alive/down) |
+| `GET` | `/api/sources` | List semua URL source aktif |
+| `GET` | `/api/health` | Server health check |
+| `POST` | `/api/sources/check` | Trigger manual source update |
+| `POST` | `/api/cache/clear` | Clear semua cache |
+
+### Contoh Response
+
+<details>
+<summary><b>GET /api/anime?page=1</b></summary>
+
+```json
+{
+  "success": true,
+  "page": 1,
+  "count": 5,
+  "data": [{
+    "id": 5000,
+    "slug": "super-no-ura-de-yani-suu-futari",
+    "title": "Super no Ura de Yani Suu Futari",
+    "image": "https://r2.nyomo.my.id/images/...",
+    "quality": "Loading...",
+    "score": "8.06"
+  }]
+}
+```
+</details>
+
+<details>
+<summary><b>GET /api/search?q=one</b></summary>
+
+```json
+{
+  "success": true,
+  "query": "one",
+  "count": 18,
+  "data": [{
+    "id": 4508,
+    "slug": "omae-gotoki-ga-maou-ni-kateru-to-omouna...",
+    "title": "Omae Gotoki ga Maou ni Kateru to Omouna...",
+    "altTitles": "Winter 2026 • TV • HD"
+  }]
+}
+```
+</details>
+
+<details>
+<summary><b>GET /api/anime/:slug (detail)</b></summary>
+
+```json
+{
+  "success": true,
+  "data": {
+    "id": 3380,
+    "title": "Fuguushoku \"Kanteishi\" ga Jitsu wa Saikyou Datta",
+    "synopsis": "Di dunia fantasi...",
+    "genres": ["Action", "Adventure", "Fantasy"],
+    "score": "6.34",
+    "metadata": {
+      "tipe": "TV",
+      "episode": "12",
+      "studio": "Okuruto Noboru"
+    },
+    "episodes": [
+      { "number": 1, "url": "..." }
+    ]
+  }
+}
+```
+</details>
+
+<details>
+<summary><b>GET /api/anime/:slug/:episode</b></summary>
+
+```json
+{
+  "success": true,
+  "data": {
+    "episode": 1,
+    "servers": [
+      { "id": "kuramadrive", "label": "Kuramadrive s1" },
+      { "id": "mega", "label": "MEGA" }
+    ],
+    "selectedServer": "kuramadrive"
+  }
+}
+```
+</details>
+
+## Fitur
+
+- **9 REST Endpoints** — list, detail, episode, search, status, sources, health, source check, cache clear
+- **Auto-fallback** — source utama timeout/403 → auto coba alternatif (v17, v18, v19...)
+- **Auto-update Source** — tiap 6 jam cek + rotate URL source secara otomatis
+- **Quicksearch** — pakai AJAX endpoint untuk hasil search instan & akurat
+- **SQLite Cache** — cache response per endpoint (30m–2h TTL)
+- **Rate Limiting** — 60 req/menit general, 20 search, 30 episode
+- **Browser Farm** — ekstrak streaming URL via headless Playwright
+- **Docker Ready** — Dockerfile + docker-compose.yml
+
+## Konfigurasi
+
+Copy `.env.example` → `.env`:
+
+| Variable | Default | Deskripsi |
+|----------|---------|-----------|
+| `PORT` | `3000` | Port server |
+| `CACHE_TTL_ANIME_LIST` | `1800` | Cache TTL list (detik) |
+| `CACHE_TTL_ANIME_DETAIL` | `3600` | Cache TTL detail |
+| `CACHE_TTL_EPISODE` | `7200` | Cache TTL episode |
+| `BROWSER_FARM_URL` | - | URL Browser Farm service |
+| `BROWSER_FARM_KEY` | - | API key Browser Farm |
+| `SOURCE_AUTO_UPDATE_INTERVAL` | `6` | Interval cek source (jam) |
+
+## Auto-Fallback & Auto-Update
+
+Sistem otomatis:
+1. Coba URL utama → alternatif → derived URLs (v17, v18, v19...)
+2. Tiap 6 jam: cek health semua URL
+3. Primary down → rotate ke alternatif yang hidup
+4. Update `data/sources.json` otomatis
+5. Semua log ke SQLite
+
+Manual trigger: `POST /api/sources/check`
+
+## Cache Strategy
+
+| Endpoint | TTL |
+|----------|-----|
+| Anime list | 30 menit |
+| Anime detail | 1 jam |
+| Episode stream | 2 jam |
+| Source status | 5 menit |
+| Search | 30 menit |
+
+Clear: `POST /api/cache/clear`
+
+## Struktur Project
+
+```
+kuramanime-api/
+├── src/
+│   ├── index.js              # Express app + middleware
+│   ├── config/
+│   │   ├── index.js          # Env config
+│   │   └── sources.js        # URL source manager
+│   ├── routes/
+│   │   ├── anime.js          # Anime endpoints
+│   │   └── status.js         # Status, sources, cache
+│   ├── scrapers/
+│   │   ├── cheerio.js        # Static scraper (list, detail, search)
+│   │   └── browser.js        # Browser scraper (streaming URL)
+│   ├── services/
+│   │   ├── browserFarm.js    # Browser Farm REST client
+│   │   └── sourceUpdater.js  # Auto source rotate
+│   └── db/
+│       └── index.js          # SQLite (cache + source log)
+├── data/
+│   └── sources.json          # URL source (runtime)
+├── Dockerfile
+├── docker-compose.yml
+└── README.md
+```
+
+## Streaming Servers
+
+| Server ID | Deskripsi |
+|-----------|-----------|
+| `kuramadrive` | Default (normal, iklan banner) |
+| `filelions` | FileLions (kencang, iklan popup) |
+| `filemoon` | FileMoon (kencang, iklan popup) |
+| `mega` | MEGA (kencang, iklan banner) |
+| `streamwish` | StreamWish (kencang, iklan popup) |
+| `vidguard` | VidGuard (kencang, iklan popup) |
+
+## Tech Stack
+
+- **Node.js 20+** + **Express** — REST framework
+- **Cheerio** — HTML parsing (list, detail, search)
+- **Browser Farm** (Playwright) — dynamic JS scraping
+- **better-sqlite3** — SQLite database
+- **express-rate-limit** — rate limiting
+
+## License
+
+MIT © 2026 mmoaa

package/api/index.js

@@ -0,0 +1,19 @@
+/**
+ * Vercel Serverless Entry Point
+ * 
+ * Adaptasi Express app untuk Vercel serverless:
+ * - SQLite disabled (filesystem ephemeral)
+ * - node-cron disabled (no long-running process)
+ * - Rate limiting stays (per-instance, acceptable for low-traffic)
+ * - Source URLs loaded from data/sources.json (static)
+ */
+
+// Override before requiring modules
+process.env.VERCEL = '1';
+process.env.NODE_ENV = 'production';
+process.env.DISABLE_SQLITE = '1'; // Signal to db module
+
+const app = require('../src/index');
+
+// Vercel serverless export
+module.exports = app;

package/bin/cli.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+/**
+ * Kuramanime API CLI — one command to start the server.
+ * Usage:
+ *   kuramanime-api               → start server (port from PORT env or 3000)
+ *   kuramanime-api --port 8080   → start on custom port
+ *   kuramanime-api --help        → show help
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const args = process.argv.slice(2);
+const help = args.includes('--help') || args.includes('-h');
+
+if (help) {
+  console.log(`
+📦 Kuramanime API v${require('../package.json').version}
+
+  kuramanime-api              Start server on PORT env or 3000
+  kuramanime-api --port 8080  Start on custom port
+  kuramanime-api --help       Show this help
+
+  Environment:
+    PORT=3000                 Server port
+    BROWSER_FARM_URL          Browser Farm endpoint
+    BROWSER_FARM_KEY          Browser Farm API key
+
+  Deploy to Vercel:
+    Just push to GitHub and connect to Vercel — vercel.json is included.
+`);
+  process.exit(0);
+}
+
+// Parse --port
+let port = process.env.PORT || 3000;
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--port' && args[i + 1]) {
+    port = args[i + 1];
+    i++;
+  }
+}
+
+// Ensure data directory
+const dataDir = path.join(__dirname, '..', 'data');
+if (!fs.existsSync(dataDir)) {
+  fs.mkdirSync(dataDir, { recursive: true });
+}
+
+// Start the server (inherit stdio so logs show)
+console.log(`🎬 Starting Kuramanime API on port ${port}...`);
+const child = spawn('node', [path.join(__dirname, '..', 'src', 'index.js')], {
+  env: { ...process.env, PORT: port },
+  stdio: 'inherit',
+});
+
+child.on('close', (code) => {
+  process.exit(code);
+});
+
+process.on('SIGINT', () => child.kill());
+process.on('SIGTERM', () => child.kill());

package/data/sources.json

@@ -0,0 +1,10 @@
+{
+  "primary": "https://v18.kuramanime.ing",
+  "alternatives": [
+    "https://v17.kuramanime.ing",
+    "https://v19.kuramanime.ing",
+    "https://kuramanime.ing"
+  ],
+  "lastUpdated": "2026-07-05T17:20:00.000Z",
+  "updatedBy": "init"
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "kuramanime-api",
+  "version": "1.0.0",
+  "description": "REST API for scraping anime data from Kuramanime \u2014 portal streaming anime sub Indo",
+  "keywords": [
+    "anime",
+    "kuramanime",
+    "sub-indo",
+    "scraper",
+    "rest-api",
+    "express"
+  ],
+  "homepage": "https://github.com/mocasus/kuramanime-api#readme",
+  "bugs": "https://github.com/mocasus/kuramanime-api/issues",
+  "license": "MIT",
+  "author": "mmoaa",
+  "main": "src/index.js",
+  "bin": {
+    "kuramanime-api": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "api/",
+    "data/sources.json",
+    "vercel.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mocasus/kuramanime-api.git"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js",
+    "vercel:dev": "vercel dev",
+    "docker:build": "docker build -t kuramanime-api .",
+    "docker:run": "docker run -p 3000:3000 -v $(pwd)/data:/app/data kuramanime-api"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.0.0",
+    "cheerio": "^1.0.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5",
+    "express": "^4.21.0",
+    "express-rate-limit": "^7.4.0",
+    "node-cron": "^3.0.3",
+    "uuid": "^10.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/config/index.js

@@ -0,0 +1,19 @@
+require('dotenv').config({ path: require('path').join(__dirname, '..', '..', '.env') });
+
+module.exports = {
+  port: parseInt(process.env.PORT || '3000', 10),
+  nodeEnv: process.env.NODE_ENV || 'development',
+
+  cache: {
+    animeList: parseInt(process.env.CACHE_TTL_ANIME_LIST || '1800', 10),
+    animeDetail: parseInt(process.env.CACHE_TTL_ANIME_DETAIL || '3600', 10),
+    episodeStream: parseInt(process.env.CACHE_TTL_EPISODE || '7200', 10),
+  },
+
+  browserFarm: {
+    baseUrl: process.env.BROWSER_FARM_URL || 'https://cool-flying-lifetime-dream.trycloudflare.com',
+    apiKey: process.env.BROWSER_FARM_KEY || 'fox-browser-farm-2026',
+  },
+
+  autoUpdateIntervalHours: parseInt(process.env.SOURCE_AUTO_UPDATE_INTERVAL || '6', 10),
+};

package/src/config/sources.js

@@ -0,0 +1,83 @@
+const fs = require('fs');
+const path = require('path');
+
+const SOURCES_FILE = path.join(__dirname, '..', '..', 'data', 'sources.json');
+
+const DEFAULT_SOURCES = {
+  primary: 'https://v18.kuramanime.ing',
+  alternatives: [
+    'https://v17.kuramanime.ing',
+    'https://v19.kuramanime.ing',
+    'https://kuramanime.ing',
+  ],
+  lastUpdated: null,
+  updatedBy: null,
+};
+
+function loadSources() {
+  try {
+    const raw = fs.readFileSync(SOURCES_FILE, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (parsed.primary) return parsed;
+  } catch (_) { /* ignore, use defaults */ }
+  return { ...DEFAULT_SOURCES };
+}
+
+function saveSources(sources) {
+  fs.mkdirSync(path.dirname(SOURCES_FILE), { recursive: true });
+  fs.writeFileSync(SOURCES_FILE, JSON.stringify(sources, null, 2));
+  return sources;
+}
+
+function getAllUrls() {
+  const s = loadSources();
+  return [s.primary, ...s.alternatives].filter(Boolean);
+}
+
+function getPrimary() {
+  return loadSources().primary;
+}
+
+function getAll() {
+  return loadSources();
+}
+
+function setPrimary(url) {
+  const s = loadSources();
+  s.primary = url;
+  s.lastUpdated = new Date().toISOString();
+  s.updatedBy = 'auto-check';
+  return saveSources(s);
+}
+
+function addAlternative(url) {
+  const s = loadSources();
+  if (!s.alternatives.includes(url) && url !== s.primary) {
+    s.alternatives.push(url);
+    s.lastUpdated = new Date().toISOString();
+    s.updatedBy = 'auto-check';
+    return saveSources(s);
+  }
+  return s;
+}
+
+function validateUrl(url) {
+  try {
+    const u = new URL(url);
+    return u.protocol === 'https:' || u.protocol === 'http:';
+  } catch {
+    return false;
+  }
+}
+
+module.exports = {
+  getAllUrls,
+  getPrimary,
+  getAll,
+  setPrimary,
+  addAlternative,
+  validateUrl,
+  loadSources,
+  saveSources,
+  DEFAULT_SOURCES,
+};

package/src/db/index.js

@@ -0,0 +1,93 @@
+const path = require('path');
+const fs = require('fs');
+
+const DB_PATH = path.join(__dirname, '..', '..', 'data', 'kuramanime.db');
+const isDisabled = !!process.env.DISABLE_SQLITE;
+
+let db;
+
+function getDb() {
+  if (isDisabled) return null;
+  if (!db) {
+    const Database = require('better-sqlite3');
+    fs.mkdirSync(path.dirname(DB_PATH), { recursive: true });
+    db = new Database(DB_PATH);
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    migrate(db);
+  }
+  return db;
+}
+
+function migrate(database) {
+  if (!database) return;
+  database.exec(`
+    CREATE TABLE IF NOT EXISTS cache (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      ttl INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_cache_created ON cache(created_at);
+    CREATE TABLE IF NOT EXISTS source_log (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      url TEXT NOT NULL,
+      status TEXT NOT NULL,
+      checked_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_source_log_url ON source_log(url);
+  `);
+}
+
+function cacheGet(key) {
+  const d = getDb();
+  if (!d) return null;
+  const row = d.prepare('SELECT value, created_at, ttl FROM cache WHERE key = ?').get(key);
+  if (!row) return null;
+  if (Date.now() - row.created_at > row.ttl * 1000) {
+    d.prepare('DELETE FROM cache WHERE key = ?').run(key);
+    return null;
+  }
+  return JSON.parse(row.value);
+}
+
+function cacheSet(key, value, ttlSeconds = 1800) {
+  const d = getDb();
+  if (!d) return;
+  d.prepare(
+    'INSERT OR REPLACE INTO cache (key, value, created_at, ttl) VALUES (?, ?, ?, ?)'
+  ).run(key, JSON.stringify(value), Date.now(), ttlSeconds);
+}
+
+function cacheClear(pattern) {
+  const d = getDb();
+  if (!d) return;
+  if (pattern) {
+    d.prepare('DELETE FROM cache WHERE key LIKE ?').run(`%${pattern}%`);
+  } else {
+    d.prepare('DELETE FROM cache').run();
+  }
+}
+
+function logSource(url, status) {
+  const d = getDb();
+  if (!d) return;
+  d.prepare('INSERT INTO source_log (url, status, checked_at) VALUES (?, ?, ?)').run(
+    url, status, Date.now()
+  );
+}
+
+function getSourceLogs(limit = 20) {
+  const d = getDb();
+  if (!d) return [];
+  return d.prepare('SELECT * FROM source_log ORDER BY checked_at DESC LIMIT ?').all(limit);
+}
+
+module.exports = {
+  getDb,
+  cacheGet,
+  cacheSet,
+  cacheClear,
+  logSource,
+  getSourceLogs,
+};