% adduck v0.9

Ad management
for the terminal.

Apple, Reddit, Meta, AppLovin, Unity, ironSource. Pull real-time spend, pause campaigns, and set hard budget caps. No dashboard required.

$ npm install -g adduck
[docs →] GitHub MIT · Node 18+

$ adduck spend --days 7

 
 
 
 
  
 
 
     
  1.  01 
     
    Full spend visibility.
     
    One command. All six platforms. Pass --json to pipe anywhere.
     
     $  adduck spend  --json  | jq '.[] | select(.cpi > 4)' 
     
     
    2.  
  2.  02 
     
    Campaign controls.
     
    Pause, resume, adjust budgets. Guardrails block accidents before they go through.
     
     $  adduck pause  reddit  --campaign  'App Awareness Q3' 
     
     
    3.  
  3.  03 
     
    Your AI can use it.
     
    One command registers adduck as an MCP server in Claude Desktop. Your guardrails stay in effect.
     
     $  adduck agents install 
     ~/docs/mcp → 
     
    4.  
  4.  04 
     
    Browse with j/k.
     
    The built-in TUI shows 7-day sparklines per campaign. Single keypresses do the work.
     
     $  adduck tui 
     
     
    5.  
 
 
  
 
 
supported platforms
 
   Apple Search Ads ~5 min   Reddit Ads ~2 min   Meta Ads ~2 min   AppLovin ~1 min   Unity Ads ~2 min   ironSource ~2 min  
 
Credentials stay local. No backend proxy. No account required.
 
 
  
 
 
 
 
It won't spend 4x
your budget.
 
Guardrails are per-project limits in adduck.json. Violations are hard errors, not warnings. Protected campaigns can't be touched by adduck or anything running through it.
 read the guardrails docs → 
 
 
allowMutations true
 
maxBudgetChangePct 25%
 
maxDailyBudget $500 # absolute cap
 
protectedCampaigns []
 
 
violations are hard errors, not warnings
 
 
 
 
  
 
  
Get your ads
in a row.
 
 $ npm install -g adduck  
 
MIT license · Node 18+ · no account