Prerequisites
- Gemini CLI installed:
- An Adspirer account (free to start)
- At least one ad platform account: Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads
Setup
Install the Adspirer Extension
Authenticate with Adspirer
Run Gemini CLI and ask it anything about your ad accounts:Your browser opens automatically for OAuth sign-in. Sign in with your Adspirer account and authorize access. Return to Gemini CLI — you’re connected.
Verify Your Setup
Run a test prompt:You’re connected. Gemini CLI now has access to 100+ advertising tools from your terminal.
Slash Commands
The extension includes 5 slash commands that trigger proven workflows:| Command | What it Does |
|---|---|
/adspirer:setup | Bootstrap a brand workspace — connect accounts, scan docs, pull data |
/adspirer:performance-review | Cross-platform performance scorecard with KPI comparison |
/adspirer:write-ad-copy | Brand-voice ad copy from real keyword and performance data |
/adspirer:wasted-spend | Find and fix wasted spend across all platforms |
/adspirer:refresh | Re-scan docs and update context with latest data |
What You Can Do
100+ tools across 4 ad platforms. Here’s what matters:| Platform | Tools | Key Capabilities |
|---|---|---|
| Google Ads | 39 | Keyword research with real CPC data, Search & PMax campaigns, wasted spend analysis, budget optimization, ad extensions, asset management |
| LinkedIn Ads | 28 | Sponsored content, lead gen forms, B2B targeting (job titles, industries, seniority), creative performance analysis |
| Meta Ads | 20 | Image/video/carousel campaigns, audience targeting, creative fatigue detection, placement optimization |
| TikTok Ads | 4 | In-feed campaigns, asset validation, performance analysis |
Example Prompts
What to actually say once you’re set up:Google Search Campaign
Google Search campaign with keyword research grouped by intent.
Google PMax Campaign
Performance Max campaign across all Google channels.
Cross-Platform Audit
Multi-platform audit with prioritized action list and savings estimate.
Safety Features
Adspirer enforces safety rules to prevent accidental spend:- All campaigns created PAUSED: You review before they go live
- User confirmation required: Gemini asks before any action that affects spend
- Read-before-write: Research and validation before campaign creation
- Connection status checks: Always verifies you’re managing the right account first
- No automatic retries: If a campaign creation fails, Gemini won’t retry without asking
Troubleshooting
Extension not installing
Make sure you have the latest Gemini CLI:Authentication not working
The OAuth flow opens your default browser automatically. If it doesn’t:- Check your default browser settings
- Try clearing browser cache or using a different browser
- Disable ad blockers temporarily — some interfere with OAuth redirects
Tools not working after connecting
Check your Adspirer account status at adspirer.ai. Free accounts get 15 tool calls/month. If you’ve hit the limit, upgrade to Plus (99/mo for 600 calls).Slash commands not recognized
Make sure the extension installed successfully:ads-mcp in the list. If not, reinstall the extension.
FAQ
What is Gemini CLI?
What is Gemini CLI?
Gemini CLI is Google’s official command-line AI tool, powered by the Gemini model. It lets you query codebases, generate apps, and automate workflows from your terminal. Install it with
npm install -g @google/gemini-cli.How is this different from Claude Code?
How is this different from Claude Code?
Both are terminal-based AI tools that connect to Adspirer via MCP. Gemini CLI is powered by Google’s Gemini model. Claude Code is powered by Anthropic’s Claude model. Both have full access to the same 100+ advertising tools. Choose whichever AI model you prefer.
Do I need a Google Cloud account?
Do I need a Google Cloud account?
No. Gemini CLI is free to use. You only need an Adspirer account to connect to your ad platforms.
Can I use both Gemini CLI and Claude Code?
Can I use both Gemini CLI and Claude Code?
Yes. Your Adspirer account works with every supported AI client. All clients share the same tool call quota. See Multi-Client for details.
How much does this cost?
How much does this cost?
Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: 99/mo for 600 calls. Max: $199/mo for 3,000 calls. See the full pricing breakdown.
Is my data safe?
Is my data safe?
Yes. Adspirer uses OAuth 2.1 with PKCE — we never see your passwords. Your ad account credentials live with Google/Meta/LinkedIn/TikTok. We only get read/write permissions you explicitly authorize. You can revoke access anytime from your ad platform’s security settings.