adspirer-setup

Run the full brand workspace setup. Follow these steps in order:

Step 1: Connect to Adspirer

Call get_connections_status directly.

• If it works: continue to step 2.
• If the MCP server is not found: tell the user: "The Adspirer MCP server isn't connected. Run: codex mcp add adspirer --url https://mcp.adspirer.com/mcp Then restart Codex, authenticate via /mcp, and run $adspirer-setup again."
• If OAuth is triggered: tell the user a browser window is opening for authentication. Wait for them to confirm, then retry.
• If no platforms are connected: tell the user to connect ad accounts at https://adspirer.ai/connections, then run setup again.

Step 2: Scan local folder

Search for brand documentation files: **/*.md, **/*.txt, **/*.csv, **/*.yaml, **/*.json, **/*.pdf

Read all discovered files. Extract:

• Brand name and industry
• Products/services
• Target audience descriptions
• Brand voice and tone indicators
• Competitor mentions
• Budget information
• KPI targets or performance goals
• Previous campaign strategies or results

If the folder is empty, that's fine — we'll build context from Adspirer data alone.

Step 3: Pull live campaign data

Call these Adspirer MCP tools (in parallel where possible):

1. get_connections_status — which platforms are connected
2. get_business_profile — saved brand profile
3. list_campaigns — existing campaigns across all platforms
4. get_campaign_performance (lookback_days: 30) — Google Ads performance
5. get_linkedin_campaign_performance (lookback_days: 30) — LinkedIn performance
6. get_meta_campaign_performance (lookback_days: 30) — Meta performance
7. get_benchmark_context — industry benchmarks

If any tool errors (platform not connected), skip it and note the gap.

Step 4: Create AGENTS.md

Generate AGENTS.md at the project root. Combine local files + Adspirer data:

# [Brand Name] — Paid Media Workspace

## Brand Overview
[From docs + Adspirer: what they sell, who they sell to, industry, company size]

## Brand Voice
[From docs: tone, language style, prohibited words, preferred phrases]
[If not found: "No brand voice docs found — add guidelines to this folder to improve ad copy quality"]

## Target Audiences
[From docs + Adspirer campaign targeting data]
[List each audience with platform-specific targeting parameters if available]

## Active Platforms
[From get_connections_status]
- Google Ads: [connected/not connected] — [X active campaigns]
- Meta Ads: [connected/not connected] — [X active campaigns]
- LinkedIn Ads: [connected/not connected] — [X active campaigns]
- TikTok Ads: [connected/not connected] — [X active campaigns]

## Budget & Guardrails
[From docs if available, otherwise from Adspirer campaign data]
- Monthly total: [amount or "Not specified — ask user"]
- Platform allocation: [percentages or "Based on current spend: ..."]
- Max CPC: [if specified]
- Target CPA: [if specified]
- Min ROAS: [if specified]

## KPI Targets
[From docs if available]
- Primary goal: [leads/sales/awareness/traffic]
- Target metrics: [CTR, CPA, ROAS targets]

## Current Performance Snapshot
[From get_campaign_performance — most recent data]
| Platform | Campaigns | Monthly Spend | CTR | CPA | ROAS |
|----------|-----------|---------------|-----|-----|------|
| ...      | ...       | ...           | ... | ... | ...  |

## Key Findings from Existing Campaigns
[From analyze_search_terms + performance data]
- Top performing keywords: ...
- Top performing campaigns: ...
- Wasted spend areas: ...
- Recommendations: ...

## Competitors
[From docs if available]

## Seasonality
[From docs if available]

## Notes
[Anything else relevant found in docs]
[Gaps: "No brand voice guide found", "No budget specified", etc.]
[Known constraints:
- Conversion action primary/secondary setup is configured manually in Google Ads UI (not via Adspirer MCP)
- Campaign creation should be considered complete only after post-create verification of ads, keywords, and extensions]

## Strategy
Active strategy directives are maintained in `STRATEGY.md`. All skills and agents read
that file before campaign creation, keyword research, and ad copy generation.