cross-platform-launcher
Skill4 starsChanged 6 months agoMITView on GitHub
Deploys campaigns to multiple ad platforms simultaneously (Google, Meta, LinkedIn, X, Reddit, TikTok, Amazon, The Trade Desk, Amazon DSP). Use for launching unified campaigns, multi-channel rollouts, or synchronized campaign deployment.
- Reads credentials
In this repository59 other files it gives its agents.
- ad-copy-generationSkill
- ad-creative-fatigue-detectorSkill
- ad-policy-complianceSkill
- amazon-ads-optimizerSkill
- anomaly-detectorSkill
- attribution-modelingSkill
- audience-expansion-strategySkill
- bid-optimizationSkill
- budget-optimizerSkill
- campaign-ide-handoffSkill
- campaign-preflightSkill
- campaign-structure-auditorSkill
- chatgpt-ads-conversion-trackingSkill
- chatgpt-ads-launchSkill
- competitor-analysisSkill
- creative-testingSkill
- cross-platform-attributionSkill
- dayparting-schedulerSkill
- executive-reportingSkill
- first-party-data-strategySkill
- google-ads-operatorSkill
- google-ads-quality-scoreSkill
- google-shopping-optimizerSkill
- gtm-metricsSkill
- incrementality-testingSkill
- keyword-researchSkill
- kill-scale-rulesSkill
- klaviyo-campaignsSkill
- landing-page-optimizerSkill
- launch-gatesSkill
- linkedin-ads-operatorSkill
- linkedin-ads-targetingSkill
- media-plan-builderSkill
- meta-ads-diagnosticsSkill
- meta-ads-operatorSkill
- mmm-budget-plannerSkill
- multi-channel-reportingSkill
- multi-platform-ads-operatorSkill
- multi-platform-launchSkill
- negative-keyword-minerSkill
- openai-ads-operatorSkill
- performance-max-optimizerSkill
- pixel-capi-auditorSkill
- pixel-capi-setupSkill
- platform-cost-benchmarksSkill
- public-ad-library-intelligenceSkill
- retargeting-sequence-designerSkill
- roas-calculatorSkill
- seasonal-budget-plannerSkill
- spearSkill
- spec-driven-devSkill
- synter-mcp-setupSkill
- tiktok-ads-operatorSkill
- tracking-leak-detectorSkill
- ugc-creative-briefSkill
- ui-contrast-reviewSkill
- utm-builderSkill
- video-ad-scriptwriterSkill
- x-ads-operatorSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 24
Create a campaign definition JSON file:
- Distinctive: line 235
Before deploying, the launcher validates:
- Distinctive: line 237
OAuth Credentials: - All platform connections are active
- Distinctive: line 391
Set realistic budgets: - Ensure minimums met per platform
- Distinctive: line 392
Check credentials: - Verify all OAuth connections active
- Distinctive: line 393
Review targeting: - Ensure targeting makes sense per platform
- Distinctive: line 394
Monitor after launch: - Use health monitoring skill for alerts
- Distinctive: line 396
Sync status regularly: - Keep database in sync with platforms
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Cross-Platform Campaign Launcher
Deploy advertising campaigns to multiple platforms simultaneously from a single unified campaign definition. Supports Google Ads, Meta Ads, LinkedIn Ads, X Ads, Reddit Ads, TikTok Ads, Amazon Ads, The Trade Desk, and Amazon DSP.
Capabilities
- Unified Campaign Creation - Define once, deploy to multiple platforms
- Platform-Specific Mapping - Auto-maps objectives, budgets, and targeting per platform
- Parallel Deployment - Launches to all selected platforms concurrently
- Rollout Validation - Pre-flight checks before deployment
- Deployment Status Tracking - Track success/failure per platform
- Budget Distribution - Split budget across platforms (equal, weighted, or custom)
- Dry Run Mode - Preview what would be created without deploying
Workflow
Step 1: Define Unified Campaign
Create a campaign definition JSON file:
{
"name": "Q1 2026 Lead Generation",
"objective": "LEAD_GENERATION",
"budget": {
"total_daily": 500,
"currency": "USD",
"distribution": "weighted",
"weights": {
"google": 0.35,
"meta": 0.25,
"linkedin": 0.20,
"x": 0.10,
"reddit": 0.10
}
},
"schedule": {
"start_date": "2026-02-01",
"end_date": "2026-03-31"
},
"targeting": {
"locations": ["US", "CA", "GB"],
"age_min": 25,
"age_max": 55,
"interests": ["marketing", "advertising", "business"],
"job_titles": ["Marketing Manager", "CMO", "Director of Marketing"]
},
"platforms": ["google", "meta", "linkedin", "x", "reddit"],
"status": "PAUSED"
}Step 2: Validate Campaign Definition
python3 scripts/validate_unified_campaign.py \
--config campaign.json \
--check-credentials \
--check-budgetsStep 3: Preview Deployment (Dry Run)
python3 scripts/launch_unified_campaign.py \
--config campaign.json \
--dry-runStep 4: Deploy to All Platforms
python3 scripts/launch_unified_campaign.py \
--config campaign.jsonStep 5: Check Deployment Status
python3 scripts/check_deployment_status.py \
--deployment-id dep_abc123Step 6: Sync Status to Database
python3 scripts/sync_deployment_status.py \
--deployment-id dep_abc123Common Operations
Quick launch to Google + Meta
python3 scripts/launch_unified_campaign.py \
--name "Spring Sale 2026" \
--objective WEBSITE_TRAFFIC \
--daily-budget 200 \
--platforms google,meta \
--locations US \
--status PAUSEDLaunch lead gen to B2B platforms
python3 scripts/launch_unified_campaign.py \
--name "Enterprise Demo Requests" \
--objective LEAD_GENERATION \
--daily-budget 500 \
--platforms linkedin,google \
--job-titles "CTO,VP Engineering,Director IT" \
--industries "Technology,Software" \
--status PAUSEDDistribute budget across platforms
python3 scripts/launch_unified_campaign.py \
--name "Brand Awareness 2026" \
--objective BRAND_AWARENESS \
--daily-budget 1000 \
--platforms google,meta,linkedin,x,reddit \
--distribution weighted \
--weights "google:0.30,meta:0.25,linkedin:0.20,x:0.15,reddit:0.10" \
--status PAUSEDObjective Mapping
| Unified Objective | Google Ads | Meta Ads | X Ads | TikTok | Amazon | TTD | Amazon DSP | ||
BRAND_AWARENESS | Display/Video | REACH | BRAND_AWARENESS | AWARENESS | AWARENESS | REACH | - | MaximizeReach | AWARENESS |
WEBSITE_TRAFFIC | Search/Display | TRAFFIC | WEBSITE_VISITS | CLICKS | TRAFFIC | TRAFFIC | - | MaximizeClicks | CONSIDERATION |
LEAD_GENERATION | Search/Lead Forms | LEAD_GENERATION | LEAD_GENERATION | LEADS | CONVERSIONS | LEAD_GENERATION | - | MaximizeConversions | CONVERSION |
CONVERSIONS | Search/pMax | CONVERSIONS | WEBSITE_CONVERSIONS | CONVERSIONS | CONVERSIONS | CONVERSIONS | PURCHASES | MaximizeConversions | CONVERSION |
APP_INSTALLS | App | APP_INSTALLS | - | APP_INSTALL | APP_INSTALL | APP_PROMOTION | - | - | - |
VIDEO_VIEWS | Video | VIDEO_VIEWS | VIDEO_VIEWS | VIDEO_VIEWS | VIDEO_VIEWS | VIDEO_VIEWS | - | ViewableImpressions | AWARENESS |
ENGAGEMENT | Display | ENGAGEMENT | ENGAGEMENT | ENGAGEMENTS | ENGAGEMENT | ENGAGEMENT | - | MaximizeClicks | CONSIDERATION |
Budget Distribution Modes
| Mode | Description |
equal | Split budget equally across all platforms |
weighted | Split budget by specified weights (must sum to 1.0) |
custom | Specify exact amounts per platform |
performance | Auto-optimize based on historical ROAS (requires data) |
Parameters
| Parameter | Required | Default | Description |
--config | No | - | Path to campaign JSON config file |
--name | Yes* | - | Campaign name (*required if no config) |
--objective | Yes* | - | Unified campaign objective |
--daily-budget | Yes* | - | Total daily budget in USD |
--platforms | Yes* | all | Comma-separated platform list |
--distribution | No | equal | Budget distribution mode |
--weights | No | - | Platform weights for weighted distribution |
--locations | No | US | Comma-separated geo targets |
--start-date | No | tomorrow | Campaign start date (YYYY-MM-DD) |
--end-date | No | - | Campaign end date (YYYY-MM-DD) |
--status | No | PAUSED | Initial campaign status |
--dry-run | No | false | Preview without deploying |
--parallel | No | true | Deploy to platforms in parallel |
Scripts Reference
| Script | Purpose |
launch_unified_campaign.py | Main launcher - deploys to all platforms |
validate_unified_campaign.py | Validate config and credentials |
check_deployment_status.py | Check status of a deployment |
sync_deployment_status.py | Sync deployment status to database |
list_active_deployments.py | List all active multi-platform deployments |
pause_deployment.py | Pause campaigns across all platforms |
resume_deployment.py | Resume paused deployment |
update_deployment_budget.py | Update budget across all platforms |
Deployment Output
{
"success": true,
"deployment_id": "dep_20260118_abc123",
"name": "Q1 2026 Lead Generation",
"total_budget": 500,
"currency": "USD",
"platforms": {
"google": {
"success": true,
"campaign_id": "customers/123/campaigns/456",
"budget_allocated": 175,
"status": "PAUSED"
},
"meta": {
"success": true,
"campaign_id": "23849573845",
"budget_allocated": 125,
"status": "PAUSED"
},
"linkedin": {
"success": true,
"campaign_id": "389457839",
"budget_allocated": 100,
"status": "PAUSED"
},
"x": {
"success": true,
"campaign_id": "1234567890",
"budget_allocated": 50,
"status": "PAUSED"
},
"reddit": {
"success": true,
"campaign_id": "t5_abc123",
"budget_allocated": 50,
"status": "PAUSED"
}
},
"created_at": "2026-01-18T10:30:00Z"
}Pre-Flight Checks
Before deploying, the launcher validates:
- OAuth Credentials - All platform connections are active
- Budget Minimums - Each platform meets minimum budget requirements
- Targeting Availability - Targeting options supported on each platform
- Objective Support - Objective available on all selected platforms
- Geo Targeting - Locations available on all platforms
- Asset Requirements - Required creatives exist for each platform
Platform-Specific Notes
Google Ads
- Requires
GOOGLE_ADS_DEVELOPER_TOKEN - Campaigns created as Search (for leads/conversions) or Display (for awareness)
- Uses customer ID from
GOOGLE_ADS_CUSTOMER_ID
Meta Ads
- Requires
META_AD_ACCOUNT_ID - Creates campaign under ad account
- Audience targeting mapped to Meta's detailed targeting
LinkedIn Ads
- Requires
LINKEDIN_AD_ACCOUNT_ID - Best for B2B with job title/industry targeting
- Lead gen uses LinkedIn Lead Gen Forms
X Ads
- Requires
TWITTER_AD_ACCOUNT_ID - Campaigns created with funding instrument
- Interest targeting mapped to X's categories
Reddit Ads
- Requires
REDDIT_AD_ACCOUNT_ID - User-Agent header required
- Interest/subreddit targeting available
TikTok Ads
- Requires
TIKTOK_ADVERTISER_ID - Video-first platform
- Interest and behavior targeting
Amazon Ads
- Requires
AMAZON_ADS_PROFILE_ID - Product-focused campaigns
- Sponsored Products/Brands/Display
The Trade Desk
- Requires
TTD_AUTH_TOKENandTTD_ADVERTISER_ID - API token auth (not OAuth)
- Supports Display, Video, CTV, Audio, Native
- Budgets in micros (multiply by 1,000,000)
- Modern campaigns use
Version: "Kokai"
Amazon DSP
- Requires
AMAZON_DSP_PROFILE_IDandAMAZON_DSP_ADVERTISER_ID - OAuth 2.0 with PKCE
- Order = Campaign, Line Item = Ad Group
- Lifetime budgets (not daily)
- Region-specific (NA, EU, FE)
Environment Variables
Required per platform:
# Google Ads
GOOGLE_ADS_DEVELOPER_TOKEN
GOOGLE_ADS_CUSTOMER_ID
GOOGLE_ADS_LOGIN_CUSTOMER_ID
# Meta Ads
META_AD_ACCOUNT_ID
META_ACCESS_TOKEN
# LinkedIn Ads
LINKEDIN_AD_ACCOUNT_ID
LINKEDIN_ACCESS_TOKEN
# X Ads
TWITTER_AD_ACCOUNT_ID
X_ACCESS_TOKEN
# Reddit Ads
REDDIT_AD_ACCOUNT_ID
REDDIT_ACCESS_TOKEN
# TikTok Ads
TIKTOK_ADVERTISER_ID
TIKTOK_ACCESS_TOKEN
# Amazon Ads
AMAZON_ADS_PROFILE_ID
AMAZON_ACCESS_TOKEN
# The Trade Desk
TTD_AUTH_TOKEN
TTD_ADVERTISER_ID
TTD_ENVIRONMENT # sandbox or prod
# Amazon DSP
AMAZON_DSP_PROFILE_ID
AMAZON_DSP_ADVERTISER_ID
AMAZON_DSP_ACCESS_TOKEN
AMAZON_DSP_REGION # na, eu, or fe- Tokens refreshed automatically if expired
Database Schema
Deployments tracked in unified_deployments table:
CREATE TABLE unified_deployments (
id UUID PRIMARY KEY,
deployment_id VARCHAR(255) UNIQUE NOT NULL,
user_id INTEGER REFERENCES users(id),
name VARCHAR(255) NOT NULL,
objective VARCHAR(50) NOT NULL,
total_budget DECIMAL(10,2),
currency VARCHAR(3) DEFAULT 'USD',
distribution_mode VARCHAR(20) DEFAULT 'equal',
status VARCHAR(20) DEFAULT 'PENDING',
platforms JSONB NOT NULL,
created_at TIMESTAMPTZ DEFAULT NOW(),
updated_at TIMESTAMPTZ DEFAULT NOW()
);
CREATE TABLE deployment_campaigns (
id UUID PRIMARY KEY,
deployment_id UUID REFERENCES unified_deployments(id),
platform VARCHAR(20) NOT NULL,
platform_campaign_id VARCHAR(255),
budget_allocated DECIMAL(10,2),
status VARCHAR(20) DEFAULT 'PENDING',
error_message TEXT,
created_at TIMESTAMPTZ DEFAULT NOW(),
updated_at TIMESTAMPTZ DEFAULT NOW()
);Error Handling
| Error | Cause | Solution |
MISSING_CREDENTIALS | Platform OAuth not connected | Connect platform in Settings |
BUDGET_TOO_LOW | Platform minimum not met | Increase budget or remove platform |
OBJECTIVE_NOT_SUPPORTED | Platform doesn't support objective | Remove platform from deployment |
TARGETING_UNAVAILABLE | Targeting option not on platform | Adjust targeting or remove platform |
RATE_LIMITED | Too many API requests | Retry with backoff |
PARTIAL_FAILURE | Some platforms failed | Check individual errors, retry failed |
Best Practices
- Always start PAUSED - Review campaigns before enabling
- Use dry-run first - Preview deployment before creating
- Set realistic budgets - Ensure minimums met per platform
- Check credentials - Verify all OAuth connections active
- Review targeting - Ensure targeting makes sense per platform
- Monitor after launch - Use health monitoring skill for alerts
- Use weighted distribution - Allocate more to high-performing platforms
- Sync status regularly - Keep database in sync with platforms
About this skill
Part of the Synter free skills collection — open-source agent skills for advertising, PPC, and marketing automation.
Want this skill (and 40+ more) running on autopilot against your live ad accounts? Try Synter — AI Agent Media Buyers that connect to Google, Meta, LinkedIn, TikTok, Reddit, Amazon, and 7+ more platforms.
- 🌐 syntermedia.ai
- 📚 All free skills
- 💬 Built by @syntermedia — questions? Open an issue.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

