@adsuploader/cli
v0.1.4
Published
Create Facebook ads from the command line — bulk upload media, preview configurations, and launch ads at scale
Downloads
624
Maintainers
Readme
Ads Uploader CLI
Create and manage Meta ads from the command line. Same pipeline as the web app.
Install
npm install -g @adsuploader/cliRequires Node.js 18 or later.
Quick Start
ads login # authenticate via browser
ads accounts # list ad accounts
ads account act_123456 # set default account
ads upload hero.jpg banner.mp4 # upload media
ads create:preview spec.json # preview what would be created
ads create spec.json # create adsDocumentation
Full documentation including the spec file reference, campaign structure, text configuration, and all available options is at adsuploader.com/docs/ad-configuration/cli.
Using with AI
This package includes a SKILL.md file that describes every command and option for AI agents (Claude Code, Cursor, etc.). Point your AI tool at node_modules/@adsuploader/cli/SKILL.md to get started.
Commands
| Command | Description |
|---------|-------------|
| ads login | Authenticate via browser |
| ads accounts | List ad accounts |
| ads account <id> | Set default account |
| ads campaigns | List campaigns |
| ads campaign <id> | Show ad sets in a campaign |
| ads adset <id> | Show ads in an ad set |
| ads ad <id> | Ad details and creative |
| ads presets | List saved presets |
| ads upload <files...> | Upload images and videos |
| ads uploads | List recent upload batches |
| ads create spec.json | Create ads from spec |
| ads create:preview spec.json | Dry run |
| ads create:interactive | Guided wizard |
| ads jobs <id> | Check job status |
