Setup & Installation
openclaw skills install @kein-s/meta-ads-report
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install meta-ads-report
What This Skill Does
Monitors Meta (Facebook/Instagram) ad account performance through chat. Reports spend, conversions, and cost per acquisition broken down by ad set. Also lists active pixel event names to help configure conversion tracking correctly.
Pulls live Meta Ads data through natural language queries instead of manually navigating Ads Manager dashboards.
When to use it
- Check yesterday's ad spend without opening Ads Manager
- Calculate CAC for a custom date range in plain language
- Break down conversion performance by ad set
- Find the exact pixel event name causing zero conversion counts
- Get a quick monthly ad report mid-campaign
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Calculate CAC for the last 7 days
AGENT
- 1Parses 'last 7 days' into a concrete date range
- 2Queries Meta Graph API with META_AD_ACCOUNT_ID and META_ACCESS_TOKEN
- 3Fetches spend and conversion data filtered by META_EVENT_NAME
- 4Calculates CAC per ad set (spend / conversions)
- 5Formats results as a breakdown table
OUTPUT
A table showing each ad set's spend, conversions, and CAC for the past 7 days
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
META_ACCESS_TOKEN — User Access Token from Meta Graph API Explorer with ads_read and read_insights permissionsMETA_AD_ACCOUNT_ID — Ad Account ID from Facebook Ads Manager (must start with act_)