Skip to content
TakoAPI
Back to skills

meta-ads-report

by kein-s

Marketing & Sales
—Not yet rated
Your rating

Brief

A powerful toolkit to monitor your Meta (Facebook/Instagram) advertising performance directly through chat.

Description

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

INPUT

User asks: Calculate CAC for the last 7 days

AGENT
  1. 1

    Parses 'last 7 days' into a concrete date range

  2. 2

    Queries Meta Graph API with META_AD_ACCOUNT_ID and META_ACCESS_TOKEN

  3. 3

    Fetches spend and conversion data filtered by META_EVENT_NAME

  4. 4

    Calculates CAC per ad set (spend / conversions)

  5. 5

    Formats results as a breakdown table

OUTPUT

A table showing each ad set's spend, conversions, and CAC for the past 7 days

Requirements

  • META_ACCESS_TOKEN — User Access Token from Meta Graph API Explorer with ads_read and read_insights permissions
  • META_AD_ACCOUNT_ID — Ad Account ID from Facebook Ads Manager (must start with act_)

Installation

clawhub install kein-s/meta-ads-report

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links