Meta Ads CLI — Claude Code Skills

Two Claude Code skills para trabajar con el Meta Ads CLI directamente desde Claude.

Skills incluidas

meta-ads-setup

Guía interactiva de instalación end-to-end del CLI desde cero. Diseñada para usuarios sin experiencia previa con la Meta Marketing API.

Cubre:

• Verificación de Python 3.12+ y uv
• Instalación del paquete meta-ads
• Setup completo en Meta Business Suite (Business Portfolio, System User, Ad Account, Page assignment)
• Creación de App en developers.facebook.com con caso de uso Marketing API
• Asignación de la app al system user (paso contraintuitivo)
• Generación de token con scopes correctos y expiración "Nunca"
• Guardado seguro en ~/.env-meta-ads (chmod 600)
• Persistencia en shell vía .zshrc / .bashrc
• Validación final con meta auth status y meta ads adaccount list
• Troubleshooting table con todos los gotchas comunes

Triggers: "instalar meta ads", "configurar ads cli", "set up meta ads cli", etc.

meta-ads

Operación del CLI día a día. Asume que ya está instalado y autenticado.

Cubre:

• Cheatsheet de comandos (auth, listing, insights, CRUD de campaigns/adsets/ads/creatives)
• 6 recipes operativas (reporte 7d, ROAS por campaña, A/B PAUSED end-to-end, audit low-CTR, breakdowns demográficos, pause campaign)
• Tablas de objectives, optimization goals, CTAs válidos
• Output formats (table / json / plain) y tips para jq
• Patrones de automatización (cron, idempotencia, exit codes)
• Gotchas frecuentes

Triggers: "meta ads campaign list", "insights de mi cuenta", "crear campaña meta", etc.

Skills relacionados (en sus propios repos)

• meta-ads-launch — Lanza una campaña completa de Meta Ads desde un brief tipo "manager → empleado". Genera campaña + 9 anuncios hand-drawn (3 estilos × 3 ángulos) + audiencia, todo en PAUSED.

Instalación

Clona en tu directorio de skills de Claude Code:

cd ~/.claude/skills
git clone https://github.com/santmun/meta-ads-skills.git
mv meta-ads-skills/meta-ads-setup ./meta-ads-setup
mv meta-ads-skills/meta-ads ./meta-ads
rm -rf meta-ads-skills

Reinicia Claude Code y los skills deberían aparecer.

Flujo recomendado

1. Primera vez: invoca meta-ads-setup y deja que Claude te guíe paso a paso. Necesitarás cuenta de Facebook y unos 15-20 min.
2. De ahí en adelante: usa meta-ads para listar campañas, generar reportes, crear campañas en PAUSED, etc.

Licencia

MIT.