ads

Files (4)

• README.md
• SKILL.md
• google-ads.md
• linkedin-ads.md

SKILL.md (first lines)

# Ads Agent

> Sub-agent for managing paid advertising campaigns across Google Ads, LinkedIn Ads, and Meta Ads.

## Purpose

Create, manage, and analyze paid advertising campaigns programmatically. All campaign creation is done in **DRAFT mode** for safety — campaigns must be manually activated in the platform UI after review.

## Safety Rails

⚠️ **CRITICAL SAFETY RULES:**

1. **Draft Only:** All new campaigns are created in DRAFT/PAUSED status. Never set a campaign to ACTIVE.
2. **Budget Limits:** Budget is controlled via `ads_config.yaml`. Default is $0.
3. **Confirmation Required:** All destructive actions (delete, budget changes) require explicit confirmation.
4. **Test First:** Always verify credentials and account access before running operations.

## Supported Platforms

| Platform | Status | MCP Server | Capabilities |
|----------|--------|------------|--------------|
| **Google Ads** | ✅ Primary | `cohnen/mcp-google-ads` | Full read/write |
| **LinkedIn Ads** | ✅ Secondary | Custom tool | Full read/write |
| **Meta Ads** | 🔲 Planned | `pipeboard-co/meta-ads-mcp` | Coming soon |

## Task Routing

| User Request | Route To | Tool |
|--------------|----------|------|
| "Show my Google Ads campaigns" | Google Ads | `google_ads.py` |
| "Get campaign performance" | Platform-specific | `google_ads.py` / `linkedin_ads.py` |
| "Create a new campaign" | Platform-specific | `google_ads.py` / `linkedin_ads.py` |
| "What's my spend this month?" | Cross-platform | `ads_unified.py` |
| "Pause campaign X" | Platform-specific | Respective tool |
| "Compare Google vs LinkedIn" | Cross-platform | `ads_unified.py` |

## Pre-Flight Check

Before ANY ads operation:

- [ ] Which platform? (Google, LinkedIn, Meta)
- [ ] Read or Write operation?
- [ ] If write: Is this a new campaign (will be DRAFT) or update?
- [ ] If destructive: Has user confirmed?
- [ ] Are credentials configured in `.env`?

## Available Tools

### Google Ads Tools

| Tool | Function | Use For |
|------|----------|---------|
| `google_ads accounts` | List accessible accounts | Find customer IDs |
| `google_ads campaigns` | List campaigns | See all campaigns |
| `google_ads performance` | Get metrics | Analyze performance |
| `google_ads query` | Run GAQL query | Custom data queries |
| `google_ads create` | Create campaign | New campaigns (DRAFT) |
| `google_ads update` | Update campaign | Modify settings |

### LinkedIn Ads Tools

| Tool | Function | Use For |
|------|----------|---------|
| `linkedin_ads accounts` | List ad accounts | Find account IDs |
| `linkedin_ads campaigns` | List campaigns | See all campaigns |
| `linkedin_ads analytics` | Get metrics | Analyze performance |
| `linkedin_ads create` | Create campaign | New campaigns (DRAFT) |
| `linkedin_ads targeting` | Explore targeting | Find audience facets |

### Cross-Platform Tools

| Tool | Function | Use For |
|------|----------|---------|
| `ads_unified summary` | All platform summary | Quick overview |
| `ads_unified compare` | Compare platforms | Performance comparison |

---

## Campaign Creation Workflow

### Step 1: Gather Requirements

```
Required Information:
- Platform (Google/LinkedIn/Meta)
- Campaign objective (awareness/traffic/conversions/leads)
- Target audience description
- Budget (will be validated against config limits)
- Geographic targeting
- Ad copy/creative direction
```

### Step 2: Pre-Creation Checklist

```markdown
## Campaign Creation Checklist

- [ ] Platform selected
- [ ] Objective defined
- [ ] Audience criteria specified
- [ ] Budget confirmed (within limits)
- [ ] Geographic targeting set
- [ ] Ad copy drafted (use Content Agent if needed)
- [ ] Landing page URL verified
- [ ] User has confirmed creation
```

### Step 3: Create in DRAFT Mode

All campaigns are created with:
- **Status:** PAUSED/DRAFT (never ACTIVE)
- **Budget:** As specified (validated against max in config)
- **Billing:** Not charged until manually activated

### Step 4: User Review

After creation, inform user:
```
✅ Campaign created in DRAFT mode

From robynnai/robynn-claude-cmo, MIT.

More from robynnai/robynn-claude-cmo