How kent-lee/pixiv-scraper works
Pixiv Scraper is a command-line downloader for user artworks, bookmarks, and ranking results. The workflow starts with CLI options and persisted configuration, then logs in, fetches artwork metadata from Pixiv, detects already-downloaded items, downloads original images into categorized directories, and summarizes the result. The graph separates orchestration, configuration, Pixiv retrieval, and local file handling. README-described capabilities are included; implementation details beyond the excerpts are omitted where their relationships cannot be verified.
Main entry points: pixiv.py Pixiv API · main.py CLI workflow · config.py Settings manager · cmd.py Command options
Components 15
CLI and orchestration
- CLI workflow
main.py - Command options
lib/cmd.py - Download summary
main.py
Configuration
- Settings manager
lib/config.py - Config JSON
data/config.json
Pixiv access
- Pixiv API
lib/pixiv.py - User artwork listing
lib/pixiv.py - Bookmark listing
lib/pixiv.py - Ranking listing
lib/pixiv.py - Artwork metadata
lib/pixiv.py - Image download
lib/pixiv.py
Local storage
- Artwork directories
- File utilities
lib/utils.py
Other components
- Operator
- Pixiv service
Connections 20
- Operator → Command options: provides options
lib/cmd.py - CLI workflow → Command options: parses via
main.py - CLI workflow → Settings manager: loads settings
main.py - Settings manager → Config JSON: reads and writes
lib/config.py - CLI workflow → Pixiv API: logs in and dispatches
main.py - Settings manager → Pixiv API: validates user IDs
lib/config.py - Pixiv API → Pixiv service: requests data
lib/pixiv.py - Pixiv API → User artwork listing: fetches user artworks
lib/pixiv.py - Pixiv API → Bookmark listing: fetches bookmarks
lib/pixiv.py - Pixiv API → Ranking listing: fetches rankings
lib/pixiv.py - User artwork listing → Artwork metadata: loads metadata
lib/pixiv.py - Bookmark listing → Artwork metadata: loads metadata
lib/pixiv.py - Ranking listing → Artwork metadata: loads metadata
lib/pixiv.py - Artwork metadata → Image download: provides image URLs
lib/pixiv.py - Image download → Pixiv service: downloads originals
lib/pixiv.py - Pixiv API → File utilities: checks and timestamps files
lib/pixiv.py - Settings manager → File utilities: manages directories
lib/config.py - Image download → Artwork directories: writes artwork files
lib/pixiv.py - CLI workflow → Download summary: prints totals
main.py - Pixiv API → Download summary: returns download totals
main.py