amekala/ads-mcp/adspirer-ads

Manage advertising campaigns across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads using the Adspirer MCP server (400+ tools across Google Search/PMax/Display/Demand Gen/YouTube, Meta image/video/carousel/lead-gen, LinkedIn sponsored content/carousel/lead-gen with campaign groups, and TikTok in-feed/Spark/Carousel/App Promotion).

When to Use This Skill

Activate when the user:

• Asks about ad campaign performance ("How are my Google Ads doing?")
• Wants to research keywords ("Find keywords for my plumbing business")
• Needs to create campaigns ("Launch a Google Search campaign for...")
• Wants budget optimization ("Where am I wasting ad spend?")
• Mentions advertising platforms (Google Ads, Meta, LinkedIn, TikTok)
• Asks about ad accounts or connections ("Which ad platforms are connected?")

Required Workflow

Follow these steps in order. Do not skip steps.

Step 1: Check Connected Platforms

Always start here before any ad operation:

• Call get_connections_status
• Shows connected platforms, primary/secondary accounts, account IDs
• If the target platform is not connected, direct the user to https://adspirer.ai/connections

Step 2: Identify the Task

Step 3: Execute Tools

Follow the workflow patterns below. Always read first (performance, status), then act (create, optimize).

Step 4: Summarize and Recommend

Present results in tables with key metrics. Highlight top and underperforming items. Propose actionable next steps.

Performance Analysis

• Google Ads: get_campaign_performance — params: lookback_days (7/30/60/90, default 30), optional customer_id
• Meta Ads: get_meta_campaign_performance — params: lookback_days, optional ad_account_id
• LinkedIn Ads: get_linkedin_campaign_performance — params: lookback_days
• TikTok Ads: get_tiktok_campaign_performance — params: lookback_days

Present: impressions, clicks, CTR, spend, conversions, cost/conversion, ROAS. Default to 30-day lookback.

Cross-Platform Performance Dashboard

When the user asks for overall performance, a weekly review, or cross-platform comparison:

1. Call get_connections_status to identify active platforms
2. For each connected platform, pull performance:

• Google: get_campaign_performance
• LinkedIn: get_linkedin_campaign_performance
• Meta: get_meta_campaign_performance
• TikTok: get_tiktok_campaign_performance

1. For each platform, pull waste analysis:

• Google: analyze_wasted_spend
• LinkedIn: analyze_linkedin_wasted_spend
• Meta: analyze_meta_wasted_spend
• TikTok: analyze_tiktok_wasted_spend

1. Present a unified scorecard:

1. Highlight:

• Best performing platform and campaign
• Worst performing platform and campaign
• Total wasted spend and top waste sources
• Budget pacing (on track, under, over)

1. Recommend top 3 actions across all platforms

Campaign Research (run before creating ANY new campaign)

Before creating a campaign on any platform, research the brand's market position and competitive landscape. This combines web research with ad platform data (Adspirer MCP) to inform every campaign decision — targeting, messaging, differentiation, and bidding.

Step 0: Load Strategy Directives

Read STRATEGY.md — ## Active Directives and skim ## Decision Log. If directives exist, note them as context that will inform (not skip) the research steps that follow. Directives shape which competitors to focus on and what positioning angles to explore.

Do NOT skip Campaign Research just because directives exist. Directives may be stale, incomplete, or based on exploratory conversations. Fresh research validates and enriches them. However, avoid fully redundant research — if a comprehensive analysis was done recently (check Decision Log dates), tell the user: "Strategy directives from [date] are available. I'll use them as a starting point and validate with fresh data. Want me to do a full re-analysis instead?"

Step 1: Understand the brand's own website

Crawl the brand's website. Extract:

• What they sell (products, services, pricing tiers)
• Key value propositions and differentiators
• Target audience language (how they describe their customers)
• Pricing (plans, tiers, free trial availability)
• Trust signals (customer logos, testimonials, case studies, awards)
• CTAs used on the site (what actions they push visitors toward)

Step 2: Research the competitive landscape

Search for:

• "[brand's product category] competitors" — find who they compete with
• "[competitor name] vs [brand name]" — find comparison content
• "[competitor name] pricing" — understand competitor price points
• "best [product category] [current year]" — find review/comparison sites

Then crawl the top 3-5 competitor websites. Extract:

• Their positioning and messaging (how they describe themselves)
• Their pricing (cheaper? more expensive? different model?)
• Their unique claims (what do they say they do better?)
• Their target audience (who are they speaking to?)

Step 3: Identify differentiation

Combine brand website + competitor research to answer:

• What does this brand do that competitors don't? (unique features, approach, pricing)
• What language resonates in this market? (common pain points, desired outcomes)
• Where are the gaps? (underserved audiences, unaddressed pain points)
• What should ad copy emphasize to stand out?

Step 4: Pull existing ad intelligence from Adspirer

• get_campaign_performance — what's already running and how it performs
• analyze_search_terms — what real users search for (Google Ads)
• get_campaign_structure — current ad copy and targeting
• get_benchmark_context — industry benchmarks for this vertical

Step 5: Create a research brief

Present findings to the user before proceeding with campaign creation:

• Market overview (key competitors, price ranges, positioning)
• Recommended differentiation angles (what to emphasize in ads)
• Suggested audiences based on competitive gaps
• Messaging direction (informed by competitor weaknesses and brand strengths)

Get user input on the direction before proceeding to keyword research and campaign creation.

Keyword Research (Google Ads)

Always run before creating Search campaigns. Never use generic SEO keywords.

• Tool: research_keywords
• Params: business_description or seed_keywords, optional website_url, target_location
• Group results by intent (high/medium/low), show search volume, CPC ranges, competition
• Use insights from Campaign Research to inform seed keywords — include competitor brand terms, differentiation keywords, and pain-point language discovered during research
• Strategy directive filter (MANDATORY): After research_keywords returns results,

cross-reference against STRATEGY.md > Google Ads directives:

• Deprioritize keywords matching AVOID directives. Note these to the user.
• Highlight keywords matching PREFER directives.
• Apply CONSTRAINT directives (match type rules, budget caps).
• Flag conflicts: "Keyword '[term]' returned by research but conflicts with active

directive: '[text]'. Deprioritizing it."

Bidding Strategy

Before creating ANY Google Ads campaign, discuss bidding strategy with the user.

1. Pull past performance: get_campaign_performance (lookback_days: 90)
2. Review existing strategies: get_campaign_structure to see what bidding strategies current campaigns use
3. Recommend a strategy based on data:

1. Present recommendation with reasoning to the user
2. Get explicit approval before setting the strategy
3. To change strategy on existing campaigns: update_bid_strategy

Important: Never silently pick a bidding strategy. Always explain the trade-offs and let the user decide.

Campaign Creation

For ALL new campaigns: Run Campaign Research first (see section above) unless the user has already provided competitive context or this is a follow-up campaign for an existing brand workspace with research already done.