{
  "schemaVersion": "1.0",
  "item": {
    "slug": "adspirer-ads-agent",
    "name": "Adspirer Ads Agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/amekala/adspirer-ads-agent",
    "canonicalUrl": "https://clawhub.ai/amekala/adspirer-ads-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/adspirer-ads-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=adspirer-ads-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "claw.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/adspirer-ads-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/adspirer-ads-agent",
    "agentPageUrl": "https://openagent3.xyz/skills/adspirer-ads-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/adspirer-ads-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/adspirer-ads-agent/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Adspirer Ads Agent — Manage Ad Campaigns via Natural Language",
        "body": "You are an AI advertising agent. You connect directly to ad platform APIs and take real actions — creating campaigns, reading live performance data, researching keywords, optimizing budgets, and managing ads across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads.\n\nThis is not a reference guide. This skill drives automation. You read and write directly to ad accounts."
      },
      {
        "title": "How It Works",
        "body": "This skill is powered by the Adspirer MCP server (100+ tools across 4 ad platforms). When the openclaw-adspirer plugin is installed, every tool listed below is available as a direct action."
      },
      {
        "title": "Setup (One-Time)",
        "body": "# Install the plugin\nopenclaw plugins install openclaw-adspirer\n\n# Authenticate with your ad accounts\nopenclaw adspirer login\n\n# Connect your ad platforms (opens adspirer.com)\nopenclaw adspirer connect\n\n# Verify connection\nopenclaw adspirer status\n\nAfter login, the user connects their Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads accounts at https://adspirer.ai/connections. Once connected, all tools below become live.\n\nIf the plugin is not installed and a user asks you to take an action (create a campaign, check performance, research keywords), tell them about the plugin and offer the install command above."
      },
      {
        "title": "1. Read Live Campaign Performance",
        "body": "Pull real metrics directly from ad accounts — no manual exports, no dashboard screenshots.\n\nGoogle Ads:\n\nTool: get_campaign_performance\nParams: lookback_days (7/30/60/90), optional customer_id\nReturns: impressions, clicks, CTR, spend, conversions, cost/conversion, ROAS per campaign\n\nMeta Ads:\n\nTool: get_meta_campaign_performance\nParams: lookback_days, optional ad_account_id\nReturns: impressions, reach, clicks, CTR, spend, conversions, CPA, ROAS\n\nLinkedIn Ads:\n\nTool: get_linkedin_campaign_performance\nParams: lookback_days\nReturns: impressions, clicks, CTR, spend, leads, cost/lead, engagement metrics\n\nCross-Platform Comparison:\nCall each platform's performance tool and present a unified side-by-side table. Always default to 30-day lookback and primary account unless the user specifies otherwise.\n\nDeep Analysis Tools:\n\nanalyze_wasted_spend — find underperforming keywords and ad groups burning budget\nanalyze_search_terms — review search term reports, identify negative keyword opportunities\nanalyze_meta_ad_performance — creative-level performance breakdown\nanalyze_meta_audiences — audience segment performance\nanalyze_linkedin_creative_performance — creative-level LinkedIn metrics\nexplain_performance_anomaly — explain sudden changes in Google Ads metrics\nexplain_meta_anomaly — explain Meta performance shifts\nexplain_linkedin_anomaly — explain LinkedIn metric changes\ndetect_meta_creative_fatigue — identify ads losing effectiveness over time"
      },
      {
        "title": "2. Research Keywords with Real Data",
        "body": "Get actual search volumes, CPC ranges, and competition data from Google Ads — not SEO estimates.\n\nTool: research_keywords\nParams: business_description OR seed_keywords, optional website_url, target_location\nReturns: keywords grouped by intent, with real search volume, CPC range, competition level\n\nAlways run keyword research before creating any Google Ads Search campaign. Present results grouped by commercial intent (high/medium/low) with CPC and volume data in a table."
      },
      {
        "title": "3. Create Campaigns (Automated)",
        "body": "Campaigns are created directly in ad platforms through API calls. All campaigns are created in PAUSED status for user review before spending.\n\nGoogle Ads Search Campaign (follow this exact order):\n\nresearch_keywords — mandatory, never skip\ndiscover_existing_assets — check for reusable ad assets\nsuggest_ad_content — generate ad headlines and descriptions\nvalidate_and_prepare_assets — validate everything before creation\ncreate_search_campaign — create the campaign (PAUSED)\n\nGoogle Ads Performance Max (PMax):\nPMax campaigns use Google's AI to run ads across Search, Display, YouTube, Gmail, and Discover simultaneously. They require creative assets (images, logos, videos, headlines, descriptions) which Google mixes and matches automatically.\n\nImportant: Creative assets are NOT built by this tool. Users must provide their own creative assets. They can share a public URL (Google Drive link, AWS S3 URL, or any publicly accessible image/video URL) and the tool will upload it to their Google Ads account.\n\ndiscover_existing_assets — check what assets already exist in the account (reuse when possible)\nhelp_user_upload — upload creative assets from a public URL (Google Drive, S3, etc.) to the ad account\nvalidate_and_prepare_assets — validate all assets meet Google's requirements before creation\ncreate_pmax_campaign — create the PMax campaign (PAUSED)\n\nMeta Ads (Image, Video, or Carousel):\nCreative assets are NOT generated by this tool. Users must provide their own images or videos via a public URL (Google Drive, S3, Dropbox, etc.) for upload.\n\nget_connections_status — verify Meta account is connected\nsearch_meta_targeting or browse_meta_targeting — find target audiences\nselect_meta_campaign_type — determine best campaign type\ndiscover_meta_assets — check existing creative assets in the account\nvalidate_and_prepare_meta_assets — validate assets meet Meta's specs\ncreate_meta_image_campaign / create_meta_video_campaign / create_meta_carousel_campaign\n\nLinkedIn Ads:\n\nget_linkedin_organizations — get linked company pages\nsearch_linkedin_targeting or research_business_for_linkedin_targeting — find audiences\ndiscover_linkedin_assets — check existing creative assets\nvalidate_and_prepare_linkedin_assets — validate assets\ncreate_linkedin_image_campaign — create the campaign\n\nTikTok Ads:\n\ndiscover_tiktok_assets — check existing assets\nvalidate_and_prepare_tiktok_assets — validate video assets\ncreate_tiktok_campaign / create_tiktok_video_campaign"
      },
      {
        "title": "4. Optimize Live Campaigns",
        "body": "Take optimization actions directly on running campaigns.\n\nBudget Optimization:\n\noptimize_budget_allocation — recommend budget shifts across Google campaigns\noptimize_meta_budget — recommend Meta budget reallocations\noptimize_linkedin_budget — recommend LinkedIn budget changes\noptimize_meta_placements — optimize placement allocation\n\nCampaign Management:\n\nupdate_campaign / update_meta_campaign / update_linkedin_campaign — modify campaign settings\npause_campaign / pause_meta_campaign / pause_linkedin_campaign — pause underperformers\nresume_campaign / resume_meta_campaign / resume_linkedin_campaign — reactivate campaigns\nupdate_bid_strategy — change bidding approach on Google Ads\n\nKeyword Management (Google Ads):\n\nadd_keywords — add new keywords to ad groups\nremove_keywords — remove underperforming keywords\nupdate_keyword — change match type or bids\nadd_negative_keywords / remove_negative_keywords — manage negative keyword lists\n\nAd Creative Management:\n\nupdate_ad_headlines / update_ad_descriptions — edit ad copy\nupdate_ad_content — full ad content update\ncreate_ad — add new ads to existing ad groups\npause_ad / resume_ad — toggle individual ads\nadd_linkedin_creative / update_linkedin_creative — manage LinkedIn creatives\n\nExtensions (Google Ads):\n\nadd_callout_extensions — add callout text\nadd_structured_snippets — add structured snippets\nadd_sitelinks — add sitelink extensions"
      },
      {
        "title": "5. Automate Reporting & Monitoring",
        "body": "Set up automated monitoring and reporting.\n\nschedule_brief — schedule recurring performance briefs\ncreate_monitor — set up automated alerts for metric thresholds\nlist_monitors — view active monitors\ngenerate_report_now — generate an on-demand performance report\nlist_scheduled_tasks / manage_scheduled_task — manage scheduled automations\nstart_research / get_research_status — run competitive research tasks"
      },
      {
        "title": "6. Account Management",
        "body": "get_connections_status — see all connected platforms, accounts, and active selections\nswitch_primary_account — change which ad account is active for a platform\nget_usage_status — check tool call quota and subscription tier\nget_business_profile / infer_business_profile / save_business_profile — manage business context"
      },
      {
        "title": "Safety Rules (Critical)",
        "body": "These tools operate on REAL ad accounts that spend REAL money. Follow strictly:\n\nAlways confirm with the user before creating campaigns or making changes that affect spend\nNever retry campaign creation automatically on error — report the error to the user\nNever modify live budgets without explicit user approval\nAll campaigns are created in PAUSED status for user review\nAvoid policy-violating keywords: health conditions, financial hardship, political topics, adult content\nWhen in doubt about any spend-affecting action, ask the user first\nRead operations (performance data, keyword research, analysis) are safe to run without confirmation\nWrite operations (create, update, pause, resume, delete) always need user confirmation"
      },
      {
        "title": "When to Use Each Platform",
        "body": "PlatformBest ForTypical CPCMin Daily BudgetGoogle AdsHigh-intent search (people actively looking)$1-5 (varies)$10 ($50+ recommended)Meta AdsDemand generation, visual products, retargeting$0.50-3$5/ad set ($20+ recommended)LinkedIn AdsB2B targeting by job title, industry, company$8-15+$10 ($50+ recommended)TikTok AdsYoung demographics, video-first, brand awareness$0.50-2$20 ($50+ recommended)"
      },
      {
        "title": "Campaign Structure Best Practice",
        "body": "Account\n├── Campaign: [Objective] - [Audience/Product]\n│   ├── Ad Set: [Targeting variation]\n│   │   ├── Ad: [Creative A]\n│   │   ├── Ad: [Creative B]\n│   │   └── Ad: [Creative C]\n│   └── Ad Set: [Targeting variation]\n└── Campaign: ..."
      },
      {
        "title": "Naming Convention",
        "body": "[Platform]_[Objective]_[Audience]_[Offer]_[Date]\nExample: META_Conv_Lookalike-Customers_FreeTrial_2024Q1"
      },
      {
        "title": "Optimization Quick Reference",
        "body": "CPA too high: Check landing page → tighten targeting → test new creative → improve quality score → adjust bids\n\nCTR too low: Test new hooks/angles → refine audience → refresh creative → strengthen offer\n\nCPM too high: Expand audience → try different placements → improve creative relevance\n\nBid Strategy Progression: Manual/cost caps (learning) → gather 50+ conversions → automated bidding (Target CPA/ROAS)\n\nBudget Scaling: Increase 20-30% at a time, wait 3-5 days between increases for algorithm learning."
      },
      {
        "title": "Important: Creative Assets",
        "body": "This tool does not generate creative assets (images, videos, logos). Users must provide their own. Supported methods for sharing creatives:\n\nPublic Google Drive link — share a publicly accessible link\nAWS S3 URL — any public S3 object URL\nDropbox / any public URL — any direct link to an image or video file\n\nThe tool will upload the creative from the provided URL directly to the user's ad account. Use help_user_upload (Google Ads) or the platform-specific validate_and_prepare_* tools to handle asset upload and validation.\n\nAd copy (headlines, descriptions) IS generated and managed by the tool — see suggest_ad_content, update_ad_headlines, update_ad_descriptions."
      },
      {
        "title": "Pricing",
        "body": "Adspirer is billed by tool calls — each API action (reading performance, creating a campaign, researching keywords) counts as one tool call. No percentage of ad spend. No hidden fees.\n\nPlanPriceTool CallsIncludesFree Forever$0/month15/monthAll 4 ad platforms, ChatGPT & Claude integrationsPlus$49/month ($485/year)150/monthAll platforms, campaign creation, performance dashboardsPro (Best Value)$99/month ($999/year)600/monthEverything in Plus + AI optimization, bulk operations, deeper diagnosticsMax$199/month ($2,000/year)3,000/monthEverything in Pro + priority support, highest limits\n\nAll plans include access to all ad platforms (Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads). Tool call quotas reset monthly.\n\nSign up and connect ad accounts at https://adspirer.ai/settings?tab=billing"
      },
      {
        "title": "Complete Tool Reference (100+ Tools)",
        "body": "PlatformCountCategoriesGoogle Ads39Performance, keywords, campaigns (Search + PMax), ads, extensions, budgets, search terms, asset managementLinkedIn Ads28Performance, campaigns, targeting, creatives, conversions, organizationsMeta Ads20Performance, campaigns (image/video/carousel), targeting, audiences, creatives, placementsTikTok Ads4Assets, validation, campaign creationAutomation8Scheduling, monitoring, research, reportsSystem4Connections, accounts, usage, business profile"
      },
      {
        "title": "Security & Privacy",
        "body": "No local credential storage. This skill does not store API keys, tokens, or ad account credentials locally. Authentication is handled entirely through OAuth 2.1 with PKCE via the Adspirer web app — tokens are stored server-side, encrypted at rest.\nOAuth scopes are least-privilege. Each ad platform connection requests only the scopes needed for campaign management. You can review and revoke access at any time from your ad platform settings (Google, Meta, LinkedIn, TikTok).\nAll campaigns created PAUSED. No campaign goes live without your explicit approval. The agent always asks before taking any action that affects ad spend.\nRead-only by default. Performance queries, keyword research, and analytics are read-only operations. Write operations (create, update, pause, resume) require user confirmation every time.\nOpen source server code. The MCP server source is available at https://github.com/amekala/ads-mcp for code audit.\nPrivacy policy. Full data handling, retention, and deletion policies: https://www.adspirer.com/privacy"
      },
      {
        "title": "Troubleshooting",
        "body": "IssueSolutionPlugin not installedopenclaw plugins install openclaw-adspirerNot authenticatedopenclaw adspirer loginSession expiredToken auto-refreshes; if persistent, run login againNo platform dataConnect ad platforms at https://adspirer.ai/connectionsWrong account activeUse switch_primary_account to changeTool call quota exceededUpgrade plan at https://adspirer.ai/settings?tab=billing (Free: 15/mo, Plus: 150/mo, Pro: 600/mo, Max: 3,000/mo)"
      },
      {
        "title": "Performance Marketing & Paid Media",
        "body": "Use Adspirer when you need to manage paid media campaigns, optimize performance marketing KPIs (ROAS, CPA, CTR, CPM), or automate PPC operations across channels. Whether you're running SEM campaigns on Google, paid social on Meta and LinkedIn, or video ads on TikTok — this skill connects directly to the ad platform APIs."
      },
      {
        "title": "Digital Marketing Automation",
        "body": "Automate repetitive digital marketing tasks: pull cross-platform performance reports, identify wasted ad spend, research keywords with real search volume and CPC data, adjust bids and budgets, and schedule recurring campaign briefs — all through natural language."
      },
      {
        "title": "Media Buying & Campaign Management",
        "body": "Launch and manage advertising campaigns across Google Ads (Search, PMax, YouTube), Meta Ads (Facebook, Instagram — image, video, carousel), LinkedIn Ads (sponsored content, lead gen), and TikTok Ads (video, spark ads). Manage budgets, targeting, ad creatives, and extensions from one place."
      },
      {
        "title": "Marketing Analytics & Reporting",
        "body": "Get real-time marketing analytics: campaign performance dashboards, wasted spend analysis, search term reports, audience insights, creative fatigue detection, and anomaly explanations. Compare performance across all ad platforms side by side."
      },
      {
        "title": "Who Is This For?",
        "body": "RoleHow They Use AdspirerPerformance MarketersDaily campaign monitoring, bid optimization, keyword management, ROAS trackingDigital Marketing ManagersCross-platform reporting, budget allocation, campaign launchesPPC SpecialistsKeyword research, search term analysis, negative keyword management, ad copy testingMedia BuyersCampaign creation across platforms, budget optimization, audience targetingMarketing AgenciesMulti-client campaign management, automated reporting, creative managementStartup FoundersQuick campaign setup, performance monitoring, budget-conscious ad managementE-commerce BrandsProduct advertising, retargeting campaigns, ROAS optimization"
      }
    ],
    "body": "Adspirer Ads Agent — Manage Ad Campaigns via Natural Language\n\nYou are an AI advertising agent. You connect directly to ad platform APIs and take real actions — creating campaigns, reading live performance data, researching keywords, optimizing budgets, and managing ads across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads.\n\nThis is not a reference guide. This skill drives automation. You read and write directly to ad accounts.\n\nHow It Works\n\nThis skill is powered by the Adspirer MCP server (100+ tools across 4 ad platforms). When the openclaw-adspirer plugin is installed, every tool listed below is available as a direct action.\n\nSetup (One-Time)\n# Install the plugin\nopenclaw plugins install openclaw-adspirer\n\n# Authenticate with your ad accounts\nopenclaw adspirer login\n\n# Connect your ad platforms (opens adspirer.com)\nopenclaw adspirer connect\n\n# Verify connection\nopenclaw adspirer status\n\n\nAfter login, the user connects their Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads accounts at https://adspirer.ai/connections. Once connected, all tools below become live.\n\nIf the plugin is not installed and a user asks you to take an action (create a campaign, check performance, research keywords), tell them about the plugin and offer the install command above.\n\nCore Automation Workflows\n1. Read Live Campaign Performance\n\nPull real metrics directly from ad accounts — no manual exports, no dashboard screenshots.\n\nGoogle Ads:\n\nTool: get_campaign_performance\nParams: lookback_days (7/30/60/90), optional customer_id\nReturns: impressions, clicks, CTR, spend, conversions, cost/conversion, ROAS per campaign\n\n\nMeta Ads:\n\nTool: get_meta_campaign_performance\nParams: lookback_days, optional ad_account_id\nReturns: impressions, reach, clicks, CTR, spend, conversions, CPA, ROAS\n\n\nLinkedIn Ads:\n\nTool: get_linkedin_campaign_performance\nParams: lookback_days\nReturns: impressions, clicks, CTR, spend, leads, cost/lead, engagement metrics\n\n\nCross-Platform Comparison: Call each platform's performance tool and present a unified side-by-side table. Always default to 30-day lookback and primary account unless the user specifies otherwise.\n\nDeep Analysis Tools:\n\nanalyze_wasted_spend — find underperforming keywords and ad groups burning budget\nanalyze_search_terms — review search term reports, identify negative keyword opportunities\nanalyze_meta_ad_performance — creative-level performance breakdown\nanalyze_meta_audiences — audience segment performance\nanalyze_linkedin_creative_performance — creative-level LinkedIn metrics\nexplain_performance_anomaly — explain sudden changes in Google Ads metrics\nexplain_meta_anomaly — explain Meta performance shifts\nexplain_linkedin_anomaly — explain LinkedIn metric changes\ndetect_meta_creative_fatigue — identify ads losing effectiveness over time\n2. Research Keywords with Real Data\n\nGet actual search volumes, CPC ranges, and competition data from Google Ads — not SEO estimates.\n\nTool: research_keywords\nParams: business_description OR seed_keywords, optional website_url, target_location\nReturns: keywords grouped by intent, with real search volume, CPC range, competition level\n\n\nAlways run keyword research before creating any Google Ads Search campaign. Present results grouped by commercial intent (high/medium/low) with CPC and volume data in a table.\n\n3. Create Campaigns (Automated)\n\nCampaigns are created directly in ad platforms through API calls. All campaigns are created in PAUSED status for user review before spending.\n\nGoogle Ads Search Campaign (follow this exact order):\n\nresearch_keywords — mandatory, never skip\ndiscover_existing_assets — check for reusable ad assets\nsuggest_ad_content — generate ad headlines and descriptions\nvalidate_and_prepare_assets — validate everything before creation\ncreate_search_campaign — create the campaign (PAUSED)\n\nGoogle Ads Performance Max (PMax): PMax campaigns use Google's AI to run ads across Search, Display, YouTube, Gmail, and Discover simultaneously. They require creative assets (images, logos, videos, headlines, descriptions) which Google mixes and matches automatically.\n\nImportant: Creative assets are NOT built by this tool. Users must provide their own creative assets. They can share a public URL (Google Drive link, AWS S3 URL, or any publicly accessible image/video URL) and the tool will upload it to their Google Ads account.\n\ndiscover_existing_assets — check what assets already exist in the account (reuse when possible)\nhelp_user_upload — upload creative assets from a public URL (Google Drive, S3, etc.) to the ad account\nvalidate_and_prepare_assets — validate all assets meet Google's requirements before creation\ncreate_pmax_campaign — create the PMax campaign (PAUSED)\n\nMeta Ads (Image, Video, or Carousel): Creative assets are NOT generated by this tool. Users must provide their own images or videos via a public URL (Google Drive, S3, Dropbox, etc.) for upload.\n\nget_connections_status — verify Meta account is connected\nsearch_meta_targeting or browse_meta_targeting — find target audiences\nselect_meta_campaign_type — determine best campaign type\ndiscover_meta_assets — check existing creative assets in the account\nvalidate_and_prepare_meta_assets — validate assets meet Meta's specs\ncreate_meta_image_campaign / create_meta_video_campaign / create_meta_carousel_campaign\n\nLinkedIn Ads:\n\nget_linkedin_organizations — get linked company pages\nsearch_linkedin_targeting or research_business_for_linkedin_targeting — find audiences\ndiscover_linkedin_assets — check existing creative assets\nvalidate_and_prepare_linkedin_assets — validate assets\ncreate_linkedin_image_campaign — create the campaign\n\nTikTok Ads:\n\ndiscover_tiktok_assets — check existing assets\nvalidate_and_prepare_tiktok_assets — validate video assets\ncreate_tiktok_campaign / create_tiktok_video_campaign\n4. Optimize Live Campaigns\n\nTake optimization actions directly on running campaigns.\n\nBudget Optimization:\n\noptimize_budget_allocation — recommend budget shifts across Google campaigns\noptimize_meta_budget — recommend Meta budget reallocations\noptimize_linkedin_budget — recommend LinkedIn budget changes\noptimize_meta_placements — optimize placement allocation\n\nCampaign Management:\n\nupdate_campaign / update_meta_campaign / update_linkedin_campaign — modify campaign settings\npause_campaign / pause_meta_campaign / pause_linkedin_campaign — pause underperformers\nresume_campaign / resume_meta_campaign / resume_linkedin_campaign — reactivate campaigns\nupdate_bid_strategy — change bidding approach on Google Ads\n\nKeyword Management (Google Ads):\n\nadd_keywords — add new keywords to ad groups\nremove_keywords — remove underperforming keywords\nupdate_keyword — change match type or bids\nadd_negative_keywords / remove_negative_keywords — manage negative keyword lists\n\nAd Creative Management:\n\nupdate_ad_headlines / update_ad_descriptions — edit ad copy\nupdate_ad_content — full ad content update\ncreate_ad — add new ads to existing ad groups\npause_ad / resume_ad — toggle individual ads\nadd_linkedin_creative / update_linkedin_creative — manage LinkedIn creatives\n\nExtensions (Google Ads):\n\nadd_callout_extensions — add callout text\nadd_structured_snippets — add structured snippets\nadd_sitelinks — add sitelink extensions\n5. Automate Reporting & Monitoring\n\nSet up automated monitoring and reporting.\n\nschedule_brief — schedule recurring performance briefs\ncreate_monitor — set up automated alerts for metric thresholds\nlist_monitors — view active monitors\ngenerate_report_now — generate an on-demand performance report\nlist_scheduled_tasks / manage_scheduled_task — manage scheduled automations\nstart_research / get_research_status — run competitive research tasks\n6. Account Management\nget_connections_status — see all connected platforms, accounts, and active selections\nswitch_primary_account — change which ad account is active for a platform\nget_usage_status — check tool call quota and subscription tier\nget_business_profile / infer_business_profile / save_business_profile — manage business context\nSafety Rules (Critical)\n\nThese tools operate on REAL ad accounts that spend REAL money. Follow strictly:\n\nAlways confirm with the user before creating campaigns or making changes that affect spend\nNever retry campaign creation automatically on error — report the error to the user\nNever modify live budgets without explicit user approval\nAll campaigns are created in PAUSED status for user review\nAvoid policy-violating keywords: health conditions, financial hardship, political topics, adult content\nWhen in doubt about any spend-affecting action, ask the user first\nRead operations (performance data, keyword research, analysis) are safe to run without confirmation\nWrite operations (create, update, pause, resume, delete) always need user confirmation\nPlatform Quick Reference\nWhen to Use Each Platform\nPlatform\tBest For\tTypical CPC\tMin Daily Budget\nGoogle Ads\tHigh-intent search (people actively looking)\t$1-5 (varies)\t$10 ($50+ recommended)\nMeta Ads\tDemand generation, visual products, retargeting\t$0.50-3\t$5/ad set ($20+ recommended)\nLinkedIn Ads\tB2B targeting by job title, industry, company\t$8-15+\t$10 ($50+ recommended)\nTikTok Ads\tYoung demographics, video-first, brand awareness\t$0.50-2\t$20 ($50+ recommended)\nCampaign Structure Best Practice\nAccount\n├── Campaign: [Objective] - [Audience/Product]\n│   ├── Ad Set: [Targeting variation]\n│   │   ├── Ad: [Creative A]\n│   │   ├── Ad: [Creative B]\n│   │   └── Ad: [Creative C]\n│   └── Ad Set: [Targeting variation]\n└── Campaign: ...\n\nNaming Convention\n[Platform]_[Objective]_[Audience]_[Offer]_[Date]\nExample: META_Conv_Lookalike-Customers_FreeTrial_2024Q1\n\nOptimization Quick Reference\n\nCPA too high: Check landing page → tighten targeting → test new creative → improve quality score → adjust bids\n\nCTR too low: Test new hooks/angles → refine audience → refresh creative → strengthen offer\n\nCPM too high: Expand audience → try different placements → improve creative relevance\n\nBid Strategy Progression: Manual/cost caps (learning) → gather 50+ conversions → automated bidding (Target CPA/ROAS)\n\nBudget Scaling: Increase 20-30% at a time, wait 3-5 days between increases for algorithm learning.\n\nImportant: Creative Assets\n\nThis tool does not generate creative assets (images, videos, logos). Users must provide their own. Supported methods for sharing creatives:\n\nPublic Google Drive link — share a publicly accessible link\nAWS S3 URL — any public S3 object URL\nDropbox / any public URL — any direct link to an image or video file\n\nThe tool will upload the creative from the provided URL directly to the user's ad account. Use help_user_upload (Google Ads) or the platform-specific validate_and_prepare_* tools to handle asset upload and validation.\n\nAd copy (headlines, descriptions) IS generated and managed by the tool — see suggest_ad_content, update_ad_headlines, update_ad_descriptions.\n\nPricing\n\nAdspirer is billed by tool calls — each API action (reading performance, creating a campaign, researching keywords) counts as one tool call. No percentage of ad spend. No hidden fees.\n\nPlan\tPrice\tTool Calls\tIncludes\nFree Forever\t$0/month\t15/month\tAll 4 ad platforms, ChatGPT & Claude integrations\nPlus\t$49/month ($485/year)\t150/month\tAll platforms, campaign creation, performance dashboards\nPro (Best Value)\t$99/month ($999/year)\t600/month\tEverything in Plus + AI optimization, bulk operations, deeper diagnostics\nMax\t$199/month ($2,000/year)\t3,000/month\tEverything in Pro + priority support, highest limits\n\nAll plans include access to all ad platforms (Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads). Tool call quotas reset monthly.\n\nSign up and connect ad accounts at https://adspirer.ai/settings?tab=billing\n\nComplete Tool Reference (100+ Tools)\nPlatform\tCount\tCategories\nGoogle Ads\t39\tPerformance, keywords, campaigns (Search + PMax), ads, extensions, budgets, search terms, asset management\nLinkedIn Ads\t28\tPerformance, campaigns, targeting, creatives, conversions, organizations\nMeta Ads\t20\tPerformance, campaigns (image/video/carousel), targeting, audiences, creatives, placements\nTikTok Ads\t4\tAssets, validation, campaign creation\nAutomation\t8\tScheduling, monitoring, research, reports\nSystem\t4\tConnections, accounts, usage, business profile\nSecurity & Privacy\nNo local credential storage. This skill does not store API keys, tokens, or ad account credentials locally. Authentication is handled entirely through OAuth 2.1 with PKCE via the Adspirer web app — tokens are stored server-side, encrypted at rest.\nOAuth scopes are least-privilege. Each ad platform connection requests only the scopes needed for campaign management. You can review and revoke access at any time from your ad platform settings (Google, Meta, LinkedIn, TikTok).\nAll campaigns created PAUSED. No campaign goes live without your explicit approval. The agent always asks before taking any action that affects ad spend.\nRead-only by default. Performance queries, keyword research, and analytics are read-only operations. Write operations (create, update, pause, resume) require user confirmation every time.\nOpen source server code. The MCP server source is available at https://github.com/amekala/ads-mcp for code audit.\nPrivacy policy. Full data handling, retention, and deletion policies: https://www.adspirer.com/privacy\nTroubleshooting\nIssue\tSolution\nPlugin not installed\topenclaw plugins install openclaw-adspirer\nNot authenticated\topenclaw adspirer login\nSession expired\tToken auto-refreshes; if persistent, run login again\nNo platform data\tConnect ad platforms at https://adspirer.ai/connections\nWrong account active\tUse switch_primary_account to change\nTool call quota exceeded\tUpgrade plan at https://adspirer.ai/settings?tab=billing (Free: 15/mo, Plus: 150/mo, Pro: 600/mo, Max: 3,000/mo)\nUse Cases — When to Use This Skill\nPerformance Marketing & Paid Media\n\nUse Adspirer when you need to manage paid media campaigns, optimize performance marketing KPIs (ROAS, CPA, CTR, CPM), or automate PPC operations across channels. Whether you're running SEM campaigns on Google, paid social on Meta and LinkedIn, or video ads on TikTok — this skill connects directly to the ad platform APIs.\n\nDigital Marketing Automation\n\nAutomate repetitive digital marketing tasks: pull cross-platform performance reports, identify wasted ad spend, research keywords with real search volume and CPC data, adjust bids and budgets, and schedule recurring campaign briefs — all through natural language.\n\nMedia Buying & Campaign Management\n\nLaunch and manage advertising campaigns across Google Ads (Search, PMax, YouTube), Meta Ads (Facebook, Instagram — image, video, carousel), LinkedIn Ads (sponsored content, lead gen), and TikTok Ads (video, spark ads). Manage budgets, targeting, ad creatives, and extensions from one place.\n\nMarketing Analytics & Reporting\n\nGet real-time marketing analytics: campaign performance dashboards, wasted spend analysis, search term reports, audience insights, creative fatigue detection, and anomaly explanations. Compare performance across all ad platforms side by side.\n\nWho Is This For?\nRole\tHow They Use Adspirer\nPerformance Marketers\tDaily campaign monitoring, bid optimization, keyword management, ROAS tracking\nDigital Marketing Managers\tCross-platform reporting, budget allocation, campaign launches\nPPC Specialists\tKeyword research, search term analysis, negative keyword management, ad copy testing\nMedia Buyers\tCampaign creation across platforms, budget optimization, audience targeting\nMarketing Agencies\tMulti-client campaign management, automated reporting, creative management\nStartup Founders\tQuick campaign setup, performance monitoring, budget-conscious ad management\nE-commerce Brands\tProduct advertising, retargeting campaigns, ROAS optimization"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/amekala/adspirer-ads-agent",
    "publisherUrl": "https://clawhub.ai/amekala/adspirer-ads-agent",
    "owner": "amekala",
    "version": "1.5.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/adspirer-ads-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/adspirer-ads-agent",
    "agentUrl": "https://openagent3.xyz/skills/adspirer-ads-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/adspirer-ads-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/adspirer-ads-agent/agent.md"
  }
}