Admaxxer is a self-hosted ads manager for Meta Ads and Google Ads with a built-in Claude AI agent. This guide gets you from sign-up to your first AI-driven optimization in under 10 minutes.
Connect Meta Ads. Go to Settings › Integrations › Meta and paste your long-lived Meta access token. Admaxxer encrypts it with AES-256-GCM at rest. No Meta App Review is required because tokens are user-supplied.
Connect Google Ads. Go to Settings › Integrations › Google and paste your OAuth refresh token plus your Google Ads Customer ID. Tokens are encrypted at rest and never written to logs.
Open the dashboard or chat. View campaign performance in the dashboard, or open the AI chat agent and ask questions like "which campaigns wasted the most budget yesterday?" or "pause all ad sets with CPA above $80".
Core Features
Unified Ads Dashboard. Spend, ROAS, CPA, CTR, and impressions across Meta and Google in one view.
Claude AI Agent. Natural-language analysis and optimization actions on your ad accounts.
Audit Logs. Every sync, mutation, and AI action is recorded in adSyncLogs for full traceability.
Workspace Isolation. Multi-tenant data separation enforced at the database layer.
Token Setup Guides
Meta Long-Lived Token
Generate a System User token in Business Manager with ads_management and ads_read permissions. Long-lived tokens expire after 60 days; Admaxxer warns you 7 days before expiry and provides a one-click rotation flow.
Google Ads Refresh Token
Use the Google OAuth Playground or your own OAuth client with the https://www.googleapis.com/auth/adwords scope. Paste the refresh token plus your 10-digit Customer ID (no dashes). Manager (MCC) accounts are supported via the login-customer-id header, configurable per workspace.
Using the AI Agent
The chat agent has read access to your campaign metrics and write access to pause, enable, and adjust budgets on ad sets and campaigns. Every write is confirmed before execution and logged. Examples:
"Summarize this week's Meta performance vs last week."
"Find the top 5 Google search terms with high spend and zero conversions."
"Pause every ad set with spend > $100 and 0 purchases in the last 7 days."
Internal Reference
Engineering details: /docs/ADMAXXER-PRD.md (internal). Public developer docs are in progress.