API y MCP de Meta Ads: lee, crea y mide campañas sin abrir el Administrador

28 de octubre de 2026 · Equipo Zoosial

Zoosial ofrece una API REST y un servidor MCP para Meta Ads: lees cuentas publicitarias, campañas, conjuntos y anuncios, creas nuevos objetos (siempre nacen en pausa), consultas insights y audiencias, y dejas que un agente como Claude, ChatGPT o Codex opere por ti.

Qué puedes hacer

• Listar cuentas publicitarias conectadas: GET /adaccounts.
• Campañas: GET y POST /ads/campaigns. Conjuntos: GET y POST /ads/adsets. Anuncios: GET y POST /ads/ads.
• Creativos: POST /ads/adcreatives.
• Editar, pausar, activar o borrar: PATCH y DELETE /ads/object.
• Duplicar una campaña, conjunto o anuncio: POST /ads/copy; la copia nace en PAUSED.
• Impulsar una publicación: POST /ads/boost.
• Insights: GET /ads/insights con objectId, level, datePreset, breakdowns y timeIncrement.
• Revisión semanal: GET /ads/review compara los últimos 7 días con los 7 anteriores y alerta, por ejemplo, si el costo por lead sube más de 25%.
• Audiencias y ubicaciones: /ads/audiences y GET /ads/locations.
• Píxel y Conversions API: GET /ads/pixels y POST /ads/pixel-events.
• Quitar las mejoras de IA de Meta de un anuncio: POST /ads/remove-ai.

Cómo conectar la cuenta

1. Crea un perfil con POST /profiles y llama POST /connect/sessions con profileId, platform: "meta", redirectUri (registrado en tu API key; localhost no lo necesita), clientState y endUserId. La url es de un solo uso, caduca en 10 minutos y se abre en el navegador de tu usuario.
2. Meta vuelve a tu redirectUri con un ct válido 15 minutos. GET /profiles/:id/connect/meta/adaccounts/available?ct= lista las cuentas publicitarias y POST /profiles/:id/connect/meta/adaccounts con { ct, adAccountId } conecta una, con formato act_<dígitos>.

No se conecta ninguna de forma automática: cada cuenta se elige. Los endpoints aceptan el id adacc_… o el nativo act_…, que sobrevive a una reconexión. Más en Anuncios.

Ejemplo

Listar campañas y pedir métricas diarias de una:

curl "https://zoosial.com/ads/campaigns?adAccountId=act_123" \
  -H "Authorization: Bearer $SC_API_KEY"

curl "https://zoosial.com/ads/insights?adAccountId=act_123&objectId=ID_DE_CAMPANA&timeIncrement=1" \
  -H "Authorization: Bearer $SC_API_KEY"

Por MCP

El servidor MCP está en https://zoosial.com/mcp y se autoriza con tu cuenta. Herramientas de anuncios:

• Leer: list_ad_accounts, list_ad_campaigns, list_ad_sets, list_ads, ad_insights, list_ad_audiences, list_ad_pixels y search_ad_locations.
• Crear (escribe): create_ad_campaign, create_ad_set, create_ad_creative, create_ad, boost_post, create_dark_post, create_ad_audience, duplicate_ad_object y upload_media.
• Cambiar (confirma): update_ad_object, remove_meta_ai y delete_ad_object.

El servidor también expone el prompt auditoria_anuncios, una auditoría de agencia de tu cuenta. Para un anuncio nuevo: upload_media, create_ad_creative y create_ad en un conjunto. Ejemplos: operar campañas con Claude y guía MCP.

Reglas y límites

• Todo lo que se crea o duplica nace en PAUSED y devuelve un reviewUrl al panel para revisarlo y activarlo.
• Activar, subir presupuesto, borrar y quitar la IA de Meta (que reinicia el aprendizaje del anuncio) piden confirmación en tu cliente. Borrar es irreversible: conviene pausar o archivar.
• Los montos van en centavos de la moneda de la cuenta: 50000 son $500.
• Una API key de solo lectura no puede crear ni cambiar nada.
• Google Ads: hoy solo existe POST /ads/campaigns; lo demás es exclusivo de Meta.
• En upload_media el nombre del archivo debe llevar su extensión real (video.mp4), o Meta lo toma como foto.
• La inversión se paga directo a Meta.

Los webhooks ad.issue, ad.status_changed y ad.recommendation avisan sin pollear.

Precio

La gestión de anuncios viene incluida en el plan gratis (1 perfil, hasta 3 cuentas, sin tarjeta) y en el plan por perfil, que cuesta $95 MXN al mes + IVA por perfil con el primero gratis; hay tramos más baratos con más perfiles. Consulta precios y el producto de anuncios.

Compáralo

Para ver cómo se compara Zoosial con otras opciones, visita las comparativas y el artículo API para conectar redes sociales. El contrato técnico completo está en /llms.txt y /openapi.json.

Preguntas frecuentes

← Todas las integraciones