adspirer-ads-agent
Adspirer — AI-powered advertising and performance marketing agent. Manage Google Ads, Meta Ads (Facebook & Instagram), LinkedIn Ads, and TikTok Ads via natural language.
Install / Use
npx skills add LeoYeAI/openclaw-master-skills --skill adspirer-ads-agentInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of adspirer-ads-agent
adspirer-ads-agent scores 90/100 on our quality scale, 1214th of 2,780 Automation skills we index (top 44%).
Its SKILL.md is 18 KB long, well organised into 31 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
adspirer-ads-agent compared with similar skills
All 4 of these similar skills score higher than adspirer-ads-agent; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| adspirer-ads-agent (this skill)by LeoYeAI | 90 | 2.1k | 4mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install adspirer-ads-agent?
- Run
npx skills add LeoYeAI/openclaw-master-skills --skill adspirer-ads-agent. The install tabs above show the steps for each supported agent. - Which AI agents does adspirer-ads-agent work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is adspirer-ads-agent safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is adspirer-ads-agent still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: adspirer-ads-agent description: "Adspirer — AI-powered advertising and performance marketing agent. Manage Google Ads, Meta Ads (Facebook & Instagram), LinkedIn Ads, and TikTok Ads via natural language. 100+ tools for paid media campaign creation, live performance analysis, PPC keyword research with real CPC data, budget optimization, ad creative management, and cross-platform reporting. Create Search, PMax, display, image, video, and carousel campaigns. Analyze wasted ad spend, research keywords, optimize bids and ROAS, automate monitoring, and track CPA across channels. Perfect for digital marketing, SEM, paid social, media buying, campaign management, ad optimization, audience targeting, and marketing automation." homepage: https://www.adspirer.com author: Adspirer license: MIT category: advertising subcategory: performance-marketing keywords:
- advertising
- ads
- marketing
- digital-marketing
- performance-marketing
- paid-media
- paid-social
- ppc
- sem
- google-ads
- meta-ads
- facebook-ads
- instagram-ads
- linkedin-ads
- tiktok-ads
- campaign-management
- ad-optimization
- keyword-research
- budget-optimization
- roas
- cpa
- media-buying
- marketing-automation
- ad-creative
- audience-targeting
- retargeting
- wasted-spend
- cross-platform tags:
- advertising
- marketing
- google-ads
- meta-ads
- linkedin-ads
- tiktok-ads
- ppc
- performance-marketing
- paid-media
- campaign-management
- keyword-research
- budget-optimization
metadata:
openclaw:
emoji: "📊"
requires:
env: []
bins: []
install:
- id: openclaw-adspirer kind: node label: "Adspirer Ad Management Plugin"
Adspirer Ads Agent — Manage Ad Campaigns via Natural Language
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.
This is not a reference guide. This skill drives automation. You read and write directly to ad accounts.
How It Works
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.
Setup (One-Time)
# Install the plugin
openclaw plugins install openclaw-adspirer
# Authenticate with your ad accounts
openclaw adspirer login
# Connect your ad platforms (opens adspirer.com)
openclaw adspirer connect
# Verify connection
openclaw adspirer status
After 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.
If 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.
Core Automation Workflows
1. Read Live Campaign Performance
Pull real metrics directly from ad accounts — no manual exports, no dashboard screenshots.
Google Ads:
Tool: get_campaign_performance
Params: lookback_days (7/30/60/90), optional customer_id
Returns: impressions, clicks, CTR, spend, conversions, cost/conversion, ROAS per campaign
Meta Ads:
Tool: get_meta_campaign_performance
Params: lookback_days, optional ad_account_id
Returns: impressions, reach, clicks, CTR, spend, conversions, CPA, ROAS
LinkedIn Ads:
Tool: get_linkedin_campaign_performance
Params: lookback_days
Returns: impressions, clicks, CTR, spend, leads, cost/lead, engagement metrics
Cross-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.
Deep Analysis Tools:
analyze_wasted_spend— find underperforming keywords and ad groups burning budgetanalyze_search_terms— review search term reports, identify negative keyword opportunitiesanalyze_meta_ad_performance— creative-level performance breakdownanalyze_meta_audiences— audience segment performanceanalyze_linkedin_creative_performance— creative-level LinkedIn metricsexplain_performance_anomaly— explain sudden changes in Google Ads metricsexplain_meta_anomaly— explain Meta performance shiftsexplain_linkedin_anomaly— explain LinkedIn metric changesdetect_meta_creative_fatigue— identify ads losing effectiveness over time
2. Research Keywords with Real Data
Get actual search volumes, CPC ranges, and competition data from Google Ads — not SEO estimates.
Tool: research_keywords
Params: business_description OR seed_keywords, optional website_url, target_location
Returns: keywords grouped by intent, with real search volume, CPC range, competition level
Always 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.
3. Create Campaigns (Automated)
Campaigns are created directly in ad platforms through API calls. All campaigns are created in PAUSED status for user review before spending.
Google Ads Search Campaign (follow this exact order):
research_keywords— mandatory, never skipdiscover_existing_assets— check for reusable ad assetssuggest_ad_content— generate ad headlines and descriptionsvalidate_and_prepare_assets— validate everything before creationcreate_search_campaign— create the campaign (PAUSED)
Google 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.
Important: 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.
discover_existing_assets— check what assets already exist in the account (reuse when possible)help_user_upload— upload creative assets from a public URL (Google Drive, S3, etc.) to the ad accountvalidate_and_prepare_assets— validate all assets meet Google's requirements before creationcreate_pmax_campaign— create the PMax campaign (PAUSED)
Meta 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.
get_connections_status— verify Meta account is connectedsearch_meta_targetingorbrowse_meta_targeting— find target audiencesselect_meta_campaign_type— determine best campaign typediscover_meta_assets— check existing creative assets in the accountvalidate_and_prepare_meta_assets— validate assets meet Meta's specscreate_meta_image_campaign/create_meta_video_campaign/create_meta_carousel_campaign
LinkedIn Ads:
get_linkedin_organizations— get linked company pagessearch_linkedin_targetingorresearch_business_for_linkedin_targeting— find audiencesdiscover_linkedin_assets— check existing creative assetsvalidate_and_prepare_linkedin_assets— validate assetscreate_linkedin_image_campaign— create the campaign
TikTok Ads:
discover_tiktok_assets— check existing assetsvalidate_and_prepare_tiktok_assets— validate video assetscreate_tiktok_campaign/create_tiktok_video_campaign
4. Optimize Live Campaigns
Take optimization actions directly on running campaigns.
Budget Optimization:
optimize_budget_allocation— recommend budget shifts across Google campaignsoptimize_meta_budget— recommend Meta budget reallocationsoptimize_linkedin_budget— recommend LinkedIn budget changesoptimize_meta_placements— optimize placement allocation
Campaign Management:
update_campaign/update_meta_campaign/update_linkedin_campaign— modify campaign settingspause_campaign/pause_meta_campaign/pause_linkedin_campaign— pause underperformersresume_campaign/resume_meta_campaign/resume_linkedin_campaign— reactivate campaignsupdate_bid_strategy— change bidding approach on Google Ads
Keyword Management (Google Ads):
add_keywords— add new keywords to ad groupsremove_keywords— remove underperforming keywordsupdate_keyword— change match type or bidsadd_negative_keywords/remove_negative_keywords— manage negative keyword lists
Ad Creative Management:
update_ad_headlines/update_ad_descriptions— edit ad copyupdate_ad_content— full ad content updatecreate_ad— add new ads to existing ad groupspause_ad/resume_ad— toggle individual adsadd_linkedin_creative/update_linkedin_creative— manage LinkedIn creatives
Extensions (Google Ads):
add_callout_extensions— add callout textadd_structured_snippets— add structured snippetsadd_sitelinks— add sitelink extensions
5. Automate Reporting & Monitoring
Set up automated monitoring and reporting.
schedule_brief— schedule recurring performance briefscreate_monitor— set up automated alerts for metric thresholdslist_monitors— view active monitorsgenerate_report_now— generate an on-demand performance reportlist_scheduled_tasks/manage_scheduled_task— manage scheduled automationsstart_research/get_research_status— run competitive research tasks
6. Account Management
get_connections_status— see all connected platforms, accounts, and active selectionsswitch_primary_account— change which ad account is active for a platformget_usage_status— check tool call quota and subscription tierget_business_profile/infer_business_profile/save_business_profile— manage business context
Safety Rules (Critical)
These tools operate on REAL ad accounts that spend REAL money. Follow strictly:
- Always confirm with the user before creating campaigns or making changes that affect spend
- Never retry campaign creation automatically on error — report the error to the user
- Never modify live budgets without explicit user approval
- All campaigns are created in PAUSED status for user review
- Avoid policy-violating keywords: health conditions, financial hardship, political topics, adult content
- When in doubt about any spend-affecting action, ask the user first
- Read operations (performance data, keyword research, analysis) are safe to run without confirmation
- Write operations (create, update, pause, resume, delete) always need user confirmation
Platform Quick Reference
When to Use Each Platform
| Platform | Best For | Typical CPC | Min Daily Budget | |----------|----------|-------------|------------------| | Google Ads | High-intent search (people actively looking) | $1-5 (varies) | $10 ($50+ recommended) | | Meta Ads | Demand generation, visual products, retargeting | $0.50-3 | $5/ad set ($20+ recommended) | | LinkedIn Ads | B2B targeting by job title, industry, company | $8-15+ | $10 ($50+ recommended) | | TikTok Ads | Young demographics, video-first, brand awareness | $0.50-2 | $20 ($50+ recommended) |
Campaign Structure Best Practice
Account
├── Campaign: [Objective] - [Audience/Product]
│ ├── Ad Set: [Targeting variation]
│ │ ├── Ad: [Creative A]
│ │ ├── Ad: [Creative B]
│ │ └── Ad: [Creative C]
│ └── Ad Set: [Targeting variation]
└── Campaign: ...
Naming Convention
[Platform]_[Objective]_[Audience]_[Offer]_[Date]
Example: META_Conv_L
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
