metacli

---

name: meta description: Meta Marketing CLI for authentication lifecycle, Graph API requests, campaign/ad/adset writes, insights reporting, and Instagram publishing. Use when handling Meta ads or Instagram operations from terminal commands with strict fail-closed behavior. homepage: https://github.com/bilalbayram/metacli metadata: {"clawdbot":{"emoji":"📣","requires":{"bins":["meta"]},"install":[{"id":"go","kind":"go","module":"github.com/bilalbayram/metacli/cmd/meta@latest","bins":["meta"],"label":"Install meta (go)"}]}}

---

meta

Use meta for Meta Marketing API and Instagram workflows. Fail closed: if required inputs are missing or any command fails, stop immediately and surface the error.

Install

go install github.com/bilalbayram/metacli/cmd/meta@latest

meta --help

Human-required auth bootstrap (must happen first)

Human creates a Meta app and provides APP_ID and APP_SECRET.

Human configures OAuth redirect allowlist in Meta Developer settings with the exact REDIRECT_URI.

Redirect must resolve to the AI host callback endpoint. For a local AI host:

- cloudflared tunnel --url http://127.0.0.1:53682 (or similar, it must be HTTPS) - Set REDIRECT_URI=https:///oauth/callback

AI runs setup without auto-opening a local browser:

- meta auth setup --profile --app-id --app-secret --redirect-uri --mode both --scope-pack solo_smb --listen 127.0.0.1:53682 --timeout 180s --open-browser=false

Human opens returned auth_url on their own machine, logs in, and grants consent.

OAuth redirect lands on the AI host and token exchange completes there.

Validate immediately:

- meta auth validate --profile --min-ttl 72h

Common commands

Schema sync (recommended before writes): meta schema sync --schema-dir ~/.meta/schema-packs

Accounts list: meta --profile insights accounts list --active-only --output table

Graph read: meta --profile api get act_/campaigns --fields id,name,status --limit 100 --follow-next

Campaign dry-run: meta --profile campaign create --account-id --params "name=,objective=OUTCOME_SALES,status=PAUSED" --schema-dir ~/.meta/schema-packs --dry-run

Campaign create: meta --profile campaign create --account-id --params "name=,objective=OUTCOME_SALES,status=PAUSED" --schema-dir ~/.meta/schema-packs

Campaign budget update: meta --profile campaign update --campaign-id --params "daily_budget=" --confirm-budget-change

Insights run: meta --profile insights run --account-id --date-preset last_7d --level campaign --metric-pack quality --format jsonl

IG publish feed: meta --profile ig publish feed --media-url --caption "" --idempotency-key

Rules

Never invent IDs, profile names, paths, redirect URIs, or payload fields.

Require explicit confirmation before budget-changing mutations.

Prefer machine-readable output (--output json or --format jsonl) for automation.

Redact secrets (APP_SECRET, access tokens) when echoing commands/results.