How do I export my AniList anime list to CSV or Excel?

Run 'npx @l1e/anifetch --all --csv' in your terminal. It generates 3 sanitized CSV spreadsheet files ready for Microsoft Excel, Google Sheets, and Numbers without needing prior installation.

How can I backup my complete AniList profile data to JSON?

Run 'npx @l1e/anifetch --json'. This exports raw anime metadata, ratings, progress, episode counts, genres, and advanced taste analytics into clean JSON files.

What is the best CLI tool to parse AniList collections without dependencies?

anifetch (@l1e/anifetch) is a lightweight zero-dependency Node.js CLI tool that queries AniList's public GraphQL API and exports data into JSON, CSV, TXT, and Markdown.

Does anifetch require an AniList API key or account login?

No. anifetch queries AniList's public GraphQL API directly. You only need a public AniList username. No login credentials or API keys are required.

anifetch — Export AniList Anime List to CSV, JSON, TXT & Markdown

Q: How does anifetch calculate anime rating statistics and community divergence?

anifetch calculates mean, median, standard deviation, community divergence, score tiers, and studio/genre engagement metrics to show your hidden gems and taste profile.

Fast AniList data extractor and multi-format exporter into JSON, CSV (Excel/Sheets), TXT, and Markdown.

npm @l1e/anifetch

dependencies 0

node >= 18.0.0

license GPL-3.0

$ npx @l1e/anifetch <username>

anifetch ~ bash

Interactive Mode

Full Export (-f all)

Spreadsheet (--csv)

Score Filter (--min-score 85)

Why anifetch?

Engineered with zero external runtime dependencies, blazing performance, and complete data accuracy.

Instant Zero-Install Execution

Run immediately on any terminal with npx @l1e/anifetch <username> without needing prior installation.

Multi-Format Exporters

Export seamlessly to JSON, CSV spreadsheets (ready for Microsoft Excel & Google Sheets), TXT reports, and GitHub Markdown.

Deep Statistical Analytics

Calculates mean, median, standard deviation, community divergence, score tiers, and studio/genre engagement metrics.

Spreadsheet Injection Security

Built-in formula sanitization prevents CSV formula injection attacks from rogue anime titles or user notes.

Interactive Navigation

Interactive prompt mode with seamless ESC step-back navigation and intelligent command detection.

100% Private & Safe

Zero telemetry, zero bloat, and zero hardcoded secrets. All processing happens 100% locally on your machine.

Supported Output Formats

Choose your desired output or export all 7 files simultaneously.

Format	CLI Switch	Generated Files	Description
JSON	`--json`	`<user>_anime_list.json` `<user>_deep_analysis.json`	Complete structured dataset with all raw ratings, metadata, studios, and analytics metrics.
CSV	`--csv`	`<user>_anime_list.csv` `<user>_genre_breakdown.csv` `<user>_studio_breakdown.csv`	Clean spreadsheet format for Microsoft Excel, Numbers, and Google Sheets.
TXT	`--txt`	`<user>_summary.txt`	Human-readable ASCII overview with consumption stats, rating tiers, and formatted list table.
Markdown	`--md`	`<user>_analysis_report.md`	GitHub-flavored Markdown report complete with links, tables, and hidden gem divergences.
ALL	`-f all`	All 7 files	Exports all formats simultaneously in a single command.

CLI Commands Cheat Sheet

Quick copy-paste reference for all CLI switches, filters, formats, and advanced flags.

> Quick Start & Execution

npx @l1e/anifetch <username> Run immediately via npx without local installation

npm install -g @l1e/anifetch Install globally to run 'anifetch <username>' from anywhere

anifetch Launch interactive prompt wizard with ESC back-navigation

anifetch <username> Default full fetch and structured JSON export

anifetch fetch <username> Explicit fetch subcommand

anifetch --demo Test extraction with sample offline profile (no internet required)

> Multi-Format Exports

anifetch <username> -f all Export to all 4 formats (JSON, CSV, TXT, MD) simultaneously

anifetch <username> --all --csv Export entire collection to CSV spreadsheet (Excel / Sheets)

anifetch <username> --json Export profile list and deep analytics to JSON files

anifetch <username> --dropped --txt Export dropped anime to a formatted plain-text summary

anifetch <username> --completed --md Export completed anime to a rich GitHub Markdown report

anifetch <username> -f "json csv md" Select custom combination of formats

anifetch <username> -o ./my-anime-data Specify custom output destination folder

anifetch <username> --no-export Fetch and analyze profile without saving files to disk

> Filtering & List Selection

anifetch <username> --completed Filter by completed status only

anifetch <username> --watching Filter by currently watching status

anifetch <username> --dropped Filter by dropped status

anifetch <username> --paused Filter by paused status

anifetch <username> --planning Filter by planning / watchlist status

anifetch <username> -s "completed,watching" Filter by multiple comma-separated statuses

anifetch <username> --min-score 85 Filter by rating on 100-point scale (85+)

anifetch <username> --min-score 8.5 Filter by rating on 10-point scale (8.5+)

anifetch <username> --genre "Sci-Fi" Filter anime by specific genre name

> Sorting & Pipeline Utilities

anifetch <username> --sort score --order desc Sort collection by highest personal score

anifetch <username> --sort title --order asc Sort alphabetically from A to Z

anifetch <username> --sort episodes Sort by total episode count

anifetch <username> --json-stdout | jq . Stream pure JSON to stdout (disables banner and logs)

anifetch <username> -q Quiet mode (suppress terminal banner and status messages)

anifetch --help Display complete CLI guide, options, and flag aliases

anifetch --version Display installed version number

Frequently Asked Questions

Everything you need to know about exporting, backing up, and analyzing your AniList collection.

01 How do I export my AniList anime list to CSV / Excel?

Run npx @l1e/anifetch <username> --all --csv in your terminal. It instantly downloads your profile and generates 3 sanitized CSV spreadsheet files (Anime List, Genre Breakdown, Studio Breakdown) formatted for Microsoft Excel, Google Sheets, and Numbers without needing any prior software installation.

02 How can I backup my full AniList profile to JSON?

Run npx @l1e/anifetch <username> --json. This exports raw anime metadata, personal ratings, watch status, episode counts, genres, studios, and advanced mathematical taste analytics into formatted JSON files.

03 Do I need an AniList API token or account password?

No! anifetch queries AniList's public GraphQL API directly. You only need the public AniList username. No login credentials, OAuth tokens, or API keys are required.

04 Can I export to all formats simultaneously?

Yes, pass the -f all flag (npx @l1e/anifetch <username> -f all) to generate all 7 output files (JSON, CSV spreadsheets, TXT summary, and GitHub Markdown report) in a single command.

05 How does anifetch calculate score divergences?

anifetch analyzes your personal scores against the global AniList community average, identifying your unique "Hidden Gems" (shows you loved far more than the community) and "Overrated" outliers.

06 Are CSV files protected against formula injection?

Yes. anifetch automatically sanitizes anime titles and notes starting with sensitive characters (=, +, -, @) to prevent CSV formula injection attacks in Excel and Google Sheets.