Credentials Setup

Credentials Setup

You need credentials from up to 5 services. Only Google Ads + Anthropic are required; the rest are optional.

Required: Google Ads API (5 values)

Credential	Where to Get It
GOOGLE_ADS_DEVELOPER_TOKEN	Google Ads → Tools & Settings → API Center
GOOGLE_ADS_CLIENT_ID	Google Cloud Console → APIs & Services → Credentials
GOOGLE_ADS_CLIENT_SECRET	Same as above
GOOGLE_ADS_REFRESH_TOKEN	Generated via OAuth flow (see below)
GOOGLE_ADS_LOGIN_CUSTOMER_ID	Your MCC account ID (XXX-XXX-XXXX)

Step-by-step

1. Developer Token: Sign into your MCC at ads.google.com → Tools & Settings → API Center
2. OAuth2 Credentials: Go to Google Cloud Console → Create project → Enable "Google Ads API" → Create OAuth2 Web Application credentials
3. Refresh Token: Use OAuth2 Playground with your Client ID/Secret, authorize https://www.googleapis.com/auth/adwords scope
4. Login Customer ID: Your Manager (MCC) account ID from ads.google.com (top right)

---

Required: Anthropic API Key

Credential	Where to Get It
ANTHROPIC_API_KEY	console.anthropic.com → Settings → API Keys

Key starts with sk-ant-api03-...

---

Optional: Cloudinary (Creative Tools)

Credential	Where to Get It
CLOUDINARY_CLOUD_NAME	Cloudinary Dashboard
CLOUDINARY_API_KEY	Same
CLOUDINARY_API_SECRET	Same (click Reveal)

Free tier: 25 credits/month (~1,000 transformations)

---

Optional: SearchAPI.io (Research)

Credential	Where to Get It
SEARCHAPI_API_KEY	searchapi.io → Dashboard → API Key

Free tier: 100 searches/month. Enables Google Search, Trends, and Ads Transparency Center.

---

Optional: Google AI / Gemini

Credential	Where to Get It
GOOGLE_AI_API_KEY	Google AI Studio → Get API Key

Free tier: 15 RPM for Gemini 2.0 Flash. Used for AI image generation and vision analysis.

---

Credential Patterns in Action Files

The 28 action files use different credential key naming conventions:

Pattern	Key Names	Used By
A (5-key)	GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, etc.	12 actions
B (4-key)	DEVELOPER_TOKEN, CLIENT_ID, etc.	13 actions
C (3-key)	CLOUDINARY_CLOUD_NAME, etc.	1 action
D (none)	—	3 actions

The values are identical between Pattern A and B — only the key names differ. Set both in your .env file.

---

.env Template

# Anthropic
ANTHROPIC_API_KEY=sk-ant-api03-...

# Google Ads API
GOOGLE_ADS_DEVELOPER_TOKEN=...
GOOGLE_ADS_CLIENT_ID=...apps.googleusercontent.com
GOOGLE_ADS_CLIENT_SECRET=GOCSPX-...
GOOGLE_ADS_REFRESH_TOKEN=1//...
GOOGLE_ADS_LOGIN_CUSTOMER_ID=123-456-7890

# Pattern B aliases (same values)
DEVELOPER_TOKEN=...
CLIENT_ID=...
CLIENT_SECRET=...
REFRESH_TOKEN=...

# Cloudinary (optional)
CLOUDINARY_CLOUD_NAME=...
CLOUDINARY_API_KEY=...
CLOUDINARY_API_SECRET=...

# SearchAPI (optional)
SEARCHAPI_API_KEY=...

# Google AI / Gemini (optional)
GOOGLE_AI_API_KEY=AIzaSy...