A powerful Node.js scraper for Artvee.com - download and organize high-quality public domain artwork with advanced filtering, progress tracking, and compression.
- 🎨 Smart Filtering - Search by category, century, orientation
- 💾 Multi-Quality Downloads - Thumbnail, standard (1800px), high (up to 7000px+)
- 📊 Progress Tracking - Beautiful visual progress bars with file sizes
- 🗜️ Image Compression - Reduce file sizes by 80%+ with format conversion
- 🔄 Auto Retry & Resume - Robust downloads with exponential backoff
- ⚡ Batch Processing - Concurrent downloads with rate limiting
- 📦 Metadata Export - Save artwork details as JSON
- 🔐 Premium Support - Full premium account integration
npm installconst ArtveeScraper = require('./scraper');
// Initialize scraper
const scraper = new ArtveeScraper({
maxRetries: 3, // Auto-retry failed downloads
enableResume: true // Resume interrupted downloads
});
// Scrape artworks
const results = await scraper.scrapeArtworks({
category: 'landscape',
century: '17th-century',
perPage: 20
});
// Download with progress bars
await scraper.downloadMultipleArtworks(
results.artworks,
'./downloads',
{
quality: 'standard',
compress: true,
showProgress: true
}
);📖 Visit the Wiki for complete documentation:
| Guide | Description |
|---|---|
| Installation | Setup and dependencies |
| Usage Guide | Scraping and filtering |
| Download Guide | Progress bars, retry, resume |
| Compression Guide | Image optimization |
| API Reference | Complete API docs |
| Examples | 14+ code examples |
| Premium Account | Premium features |
| FAQ | Common questions |
| Troubleshooting | Debug issues |
See examples/ directory or run:
npm run test-scrape # Scraping demo
npm run test-download # Download demo
npm run test-compression # Compression demo
npm run demo-retry-resume # Retry/resume demo
npm run fuzz # Property-based fuzz tests📥 17th_Century_Landscape │█████████████████│ 100% │ 2.30 MB
↻ Dutch_Harbor_Scene │█████████░░░░░░░░│ 60% │ 1.25/2.10 MB (resuming)
Reduce file sizes by 80%+ with quality/format control. See Compression Guide.
Auto-retry with exponential backoff. Resume interrupted downloads. See Download Guide.
License: Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
This means you can use, modify, and distribute this code as long as you:
- ✅ Give appropriate credit
- ✅ Share derivatives under the same license
Educational Use Only - Please respect Artvee's Terms of Service. Use responsibly with appropriate delays and rate limiting.