anisurge-cli

Instant anime streaming source lookup — one command, every server.

anisurge-cli is a Node.js CLI that hits your Anisurge scraper API and returns real streaming sources for any anime episode, formatted for terminal consumption. No browser, no extension install.

Install

npm install -g git+https://github.com/Anisurge/cli.git
anisurge --help

Or clone for dev:

git clone https://github.com/Anisurge/cli.git
cd cli
npm install
node src/index.js --help

Usage

# Fetch all streaming sources for AniList ID 1735, episode 1
anisurge sources -i 1735 -e 1

# Filter to subtitled or dubbed only
anisurge sources -i 1735 -e 1 --sub
anisurge sources -i 1735 -e 1 --dub

# Point at a different API endpoint
anisurge sources -i 1735 -e 1 --api https://scraper.example.com

# Raw JSON output
anisurge sources -i 1735 -e 1 --json

# List available providers
anisurge providers

Environment

| Variable | Default | Description | |---|---|---| | ANISURGE_API_URL | http://localhost:5900 | Base URL of the scraper API |

API Contract

anisurge-cli calls the following endpoint:

GET /?action=batch_scrape&anilistId=<id>&episode=<n>&source=<provider>

The API must return one of:

400 Bad Request

{"error": "Missing anilistId or episode"}

Successful response

{
  "sub": {
    "providerId": "https://...",
    "streams": [
      {
        "url": "https://...playlist.m3u8",
        "quality": "HardSub",
        "headers": { "Referer": "https://..." }
      }
    ]
  },
  "dub": { ... },
  "subtitle": "https://..."
}

Development

npm install
node src/index.js sources -i 1735 -e 1

License

MIT