AdKit — the Ads CLI for AI agents

The Ads CLI for AI agents and humans. Manage Meta & Google ad campaigns, browse the ad library, and generate creatives — all from your terminal. Part of AdKit.

Installation

npm install -g @adkit/cli

The installed command is adkit.

Authentication

adkit setup

Opens a browser to connect your AdKit account. Your API key is stored locally.

Commands

adkit status                  Show current project and connected accounts
adkit setup                   Authenticate (opens browser)
adkit projects                Manage projects
adkit library                 Browse the ad library
adkit studio                  Create and manage Studio ads
adkit manage                  Manage live campaigns on Meta and Google
adkit logout                  Remove stored credentials

Projects

adkit projects list
adkit projects create --name "Example" --website example.com
adkit projects use <id>
adkit projects current

Ad Library

Browse the shared ad library or your project’s My Watchlist. add finds or creates an advertiser and saves it to that project; track and untrack change membership for an existing ID. Repeating either is safe. Untracking keeps the shared advertiser and other projects intact.

adkit library advertisers list --scope watchlist --project <project-id>
adkit library advertisers search "notion" --scope watchlist --project <project-id>
adkit library advertisers add --website notion.so --project <project-id>
adkit library advertisers track <id> --project <project-id>
adkit library advertisers untrack <id> --project <project-id>
adkit library advertisers search "notion" --platform meta
adkit library advertisers <id>
adkit library advertisers similar --industry saas
adkit library ads list --advertiser <id>
adkit library ads <id>

Omit --scope (or use --scope library) for the whole library. List/search default to newest first; use --sort name for alphabetical order. Use --json for automation.

Studio

Create and manage AI-generated ads.

adkit studio ads list
adkit studio ads generate --ref media:<id> --mode clone
adkit studio ads <id>
adkit studio media upload ./banner.png
adkit studio media list <ad-id>

Meta (Facebook / Instagram)

Accounts

adkit manage meta accounts list
adkit manage meta accounts connect
adkit manage meta accounts disconnect <id>

Campaigns

adkit manage meta campaigns list
adkit manage meta campaigns create --name "Spring Sale" --objective sales --budget-daily 50 --publish
adkit manage meta campaigns update <id> --status paused
adkit manage meta campaigns delete <id>
adkit manage meta campaigns <id>

Ad Sets

adkit manage meta adsets list
adkit manage meta adsets create --campaign <id> --name "US Broad" \
  --optimization conversions --conversion-goals purchase --countries US --budget-daily 20 --publish
adkit manage meta adsets update <id> --budget-daily 50
adkit manage meta adsets delete <id>

Ads

adkit manage meta ads list
adkit manage meta ads create --adset <id> --media ./image.jpg \
  --primary-text "Try it free" --headline "AdKit" --cta sign_up --url https://example.com --publish
adkit manage meta ads create --adset <id> \
  --media ./feed.jpg --media ./story.mp4 --media-format default --media-format vertical \
  --primary-text "Try it free" --headline "AdKit" --url https://example.com --publish
adkit manage meta ads update <id> --status paused
adkit manage meta ads delete <id>
adkit manage meta ads <id>

Results & Research

adkit manage meta results                        # Spend, clicks, conversions
adkit manage meta research interests "saas tools"
adkit manage meta pages list
adkit manage meta pixels list

Drafts

adkit manage drafts list
adkit manage drafts <id>
adkit manage drafts publish <id>
adkit manage drafts delete <id>

Google Ads

Accounts

adkit manage google accounts list
adkit manage google accounts connect
adkit manage google accounts disconnect <id>

Campaigns

adkit manage google campaigns list --account <id>
adkit manage google campaigns create --name "Search Test" --campaign-type search --budget-daily 5 --account <id> --publish
adkit manage google campaigns update <id> --status paused --account <id>
adkit manage google campaigns delete <id> --account <id>

Ad Groups, Ads, Keywords

adkit manage google ad-groups list --campaign <id> --account <id>
adkit manage google ads list --ad-group <id> --account <id>
adkit manage google keywords list --ad-group <id> --account <id>
adkit manage google keywords add --ad-group <id> --text "project management software" --match-type broad --account <id>
adkit manage google negative-keywords add --campaign <id> --text "free" --account <id>

Assets (callouts, sitelinks, snippets, call extensions)

adkit manage google assets list --type callout --account <id>
adkit manage google assets create --type callout --text "Free 14-day trial" --account <id>
adkit manage google assets create --type sitelink --sitelink "Pricing|https://example.com/pricing" \
  --description-1 "See all plans" --description-2 "Starts free" --account <id>
adkit manage google assets create --type call --country-code US --phone-number "+14155551234" --account <id>
adkit manage google assets attach asset:<id> --type callout --scope campaign --scope-id <id> --account <id>

Results & Research

adkit manage google results --account <id>
adkit manage google search-terms --account <id>
adkit manage google research keywords "project management" --account <id>

Global Flags

--json        Force JSON output (default when stdout is not a TTY)
--project     Override the active project for this command
--help        Show help  (--help full for complete field reference)

Agent / Programmatic Use

All commands output JSON automatically when stdout is not a TTY, making adkit easy to use from AI agents or scripts:

adkit manage meta campaigns list --json | jq '.[].name'

Create items as drafts (default) and publish in a separate step, or pass --publish to go live immediately.

More

• Docs: adkit.so/docs