# Mangadex CLI

> MangaDex CLI skill for search, manga/chapter lookup, follow-feed checks, and recommendations.

- Skill: `dvcrn/mangadex-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/mangadex-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/mangadex-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/mangadex-cli

---


# MangaDex CLI Skill

Use this skill for direct MangaDex CLI workflows. This guide is for LLM/agent execution only.

## Installation Check

1. Check availability:
   - `command -v mangadexcli`
2. If missing, install:
   - `npm install -g @mtsku/mangadex-cli`
3. Verify:
   - `mangadexcli --help`

## Command Map

- Discovery/search:
  - `mangadexcli search manga "<query>"`
  - `mangadexcli search author "<query>"`
  - `mangadexcli search group "<query>"`
  - `mangadexcli works author "<author_uuid_or_name>"`
  - `mangadexcli works group "<group_uuid_or_name>"`
- Manga/chapter info:
  - `mangadexcli manga details <manga_uuid>`
  - `mangadexcli manga chapters <manga_uuid> --lang en -n 30`
  - `mangadexcli manga latest <manga_uuid> --lang en -n 10`
  - `mangadexcli chapter meta <chapter_uuid>`
- Follow feed:
  - `mangadexcli feed updates --window 24h --lang en`
  - `mangadexcli feed updates --window 7d`
- Recommendations:
  - `mangadexcli recommend suggest --tags "action,mystery" -n 10`
  - `mangadexcli recommend suggest --from-followed --exclude-library --window 7d -n 10`

## Auth Setup

- Personal client login:
  - `mangadexcli auth set-client <client_id> <client_secret>`
  - `mangadexcli auth login <username> <password>`
- Token-only:
  - `mangadexcli auth set-token <access_token>`
- Authorization code exchange:
  - `mangadexcli auth exchange --code <code> --redirect-uri <uri> [--code-verifier <verifier>]`
  - `mangadexcli auth refresh`
- Verify auth:
  - `mangadexcli whoami`
  - `mangadexcli auth where`

## Output Mode

- Use `--json` for machine-readable output.
- Public read endpoints work without auth.
- Feed updates and library-aware recommendation exclusions require auth.