Music-Promo Gated-Download Automation
Overview
A browser-automation toolkit for a music-promotion gated-download workflow. It drives the social actions required to unlock downloads across platforms, schedules runs to mimic organic activity over time, and includes utilities for lead collection and reporting.
Why It Exists
Music-promo “gate” pages require listeners to follow/like on Instagram and SoundCloud before a download unlocks. Validating and operating such campaigns, and measuring their effect, benefits from automation that behaves like spread-out, organic traffic rather than an obvious bot burst.
What We Built
A Node.js scheduler (scheduler.js) that paces runs across configurable campaign days with peak-day weighting, randomized run timing, and cooldowns, routed through residential proxies (Proxy-Cheap) for distribution. Platform integrations (integrations/instagram.js, integrations/soundcloud.js) automate the gated social actions via Puppeteer. Supporting utilities scrape DJ/artist contact emails, find organic-engagement targets from CSV inputs, and generate downloads reports; state is kept in PocketBase. Configuration is environment-driven (target URL, days-to-run, peak days/runs, average run time, proxy credentials).
Technologies & Approach
Puppeteer for headless browser control of the social flows; PocketBase as a lightweight datastore; residential proxy rotation plus randomized scheduling to spread activity realistically; CSV-driven lead lists and report generation. The scheduler’s organic-simulation logic is the core of the design.
Outcome / Impact
An end-to-end automation for running and measuring gated-download music-promo campaigns, demonstrating practical browser automation, anti-pattern-avoiding scheduling, and lead/reporting tooling. Internal studio tool.
Capabilities Demonstrated
- Multi-platform browser automation with Puppeteer
- Organic-activity simulation: paced scheduling, peaks, cooldowns
- Proxy rotation for distributed automation
- Lead scraping and automated reporting over a lightweight backend