Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add swan-gtm/gtm-skills --skill meta-api-referencegit clone --depth 1 https://github.com/swan-gtm/gtm-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/swan-gtm/gtm-skills/meta-api-reference)<a href="https://agentmods.dev/skills/swan-gtm/gtm-skills/meta-api-reference"><img src="https://agentmods.dev/badge/skills/swan-gtm/gtm-skills/meta-api-reference/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/swan-gtm/gtm-skills/meta-api-reference"><img src="https://agentmods.dev/badge/skills/swan-gtm/gtm-skills/meta-api-reference.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00038 | $0.08622 |
| Opus 5 | $0.00019 | $0.04311 |
| Sonnet 5 | $0.00008 | $0.01724 |
| Haiku 4.5 | $0.00004 | $0.00862 |
Grade A, and why
meta-api-reference scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
r = requests.get(url, params=params) How it starts
The opening of the file, as written. The whole thing — 892 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Meta Marketing API - Complete Reference
Configuration
- API Version:
v22.0 - Base URL:
https://graph.facebook.com/v22.0/ - Two tokens in
.env:ADS_MANAGER_ACCESS_TOKEN- Marketing API (campaign management, insights, reporting)AD_LIBRARY_ACCESS_TOKEN- Ad Library API (competitor research)
- Token expiry: ~60 days from last refresh (check
.envcomment for date)
Account Hierarchy
Ad Account (act_XXXX)
-> Campaign (objective, budget if CBO, bid strategy)
-> Ad Set (targeting, budget if ABO, optimization, schedule)
-> Ad (creative reference, status)
-> Ad Creative (media, copy, CTA, url_tags)
Campaign Schema
Endpoint: POST /{account_id}/campaigns
Required Fields
| Field | Type | Description |
|---|---|---|
name |
string | Campaign name |
objective |
enum | Marketing objective (ODAX framework) |
status |
enum | Campaign status |
special_ad_categories |
array | Special category declarations (pass [] if none) |
Optional Fields
| Field | Type | Description |
|---|---|---|
daily_budget |
int (cents) | Daily budget for CBO (5000 = $50.00) |
lifetime_budget |
int (cents) | Lifetime budget for CBO |
bid_strategy |
enum | Bidding strategy |
buying_type |
enum | Buying type |
is_adset_budget_sharing_enabled |
string | "true" for CBO, "false" for ABO |
execution_options |
array | ["validate_only"] or ["include_recommendations"] |
Objective (ODAX Framework)
| Value | Description | Use For |
|---|---|---|
OUTCOME_AWARENESS |
Brand awareness, reach | Top of funnel |
OUTCOME_ENGAGEMENT |
Post engagement, video views, page likes | Mid funnel |
OUTCOME_TRAFFIC |
Link clicks, landing page views | Mid funnel |
OUTCOME_LEADS |
Lead gen forms, conversions (lead) | Bottom of funnel |
OUTCOME_SALES |
Conversions (purchase), catalog sales | Bottom of funnel |
OUTCOME_APP_PROMOTION |
App installs, app engagement | App campaigns |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 9d ago First seen · 892 lines · 38 tokens per session scan A 070cf41bbdf9
meta-api-reference is a skill published in the GitHub repository swan-gtm/gtm-skills (153 stars, last pushed 2d ago), licensed MIT. It adds 38 tokens to every session and 8,622 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
ad-campaign-analyzer
Analyze cross-channel campaign data, quantify uncertainty, and propose evidence-labeled budget tests without overstating causality.
google-search-ads-builder
End-to-end Google Search Ads campaign builder. Performs deep keyword research (competitor SEO, review language mining, Reddit/HN community terminology, site audit), builds keyword architecture with funnel mapping and intent classification, creates ad group structure, generates headline/description variants, builds…
meta-ads-analyzer
Diagnose Meta Ads campaign performance and account gaps using Meta's actual system mechanics — including customer-journey coverage, Breakdown Effect, Learning Phase, Auction Overlap, Pacing, and Creative Fatigue. Use for performance diagnosis, account audits, full-funnel or TOF/MOF/BOF gap analysis, deciding what to…
ad-campaign-analyzer
Analyze ad campaign performance data (Google, Meta, LinkedIn) to identify what's working, what's wasting budget, and specific cut/scale/test recommendations. Runs statistical analysis, funnel diagnostics, and multi-channel budget reallocation with specific dollar-amount shift recommendations and scenario modeling.
competitor-ad-intelligence
Scrape competitor ads from Meta, TikTok, Google, and LinkedIn ad libraries, analyze creative patterns (hooks, formats, CTAs), reverse-engineer landing page funnels, and produce a strategic teardown with vulnerability analysis and counter-play recommendations. Use when you need to understand the competitive ad…
ad-angle-miner
Mine the highest-converting ad angles from customer reviews, Reddit complaints, support tickets, and competitor ads. Extracts actual pain language, competitor weaknesses, and outcome phrases that real buyers use. Outputs a ranked angle bank with proof quotes and recommended ad formats per angle.