4 formas de conectar X Ads a Claude en 2026
Porter Metrics+X Ads+
Tutorial de X Ads + IA · 2026

4 formas de conectar X Ads a Claude en 2026 (la forma fácil)

Aprende a conectar X Ads a Claude vía MCP en menos de 5 minutos, con rutas alternativas para Sheets, BigQuery y API directa.

rocket_launch Pruébalo gratisPrueba gratuita ilimitada de 14 días. Luego, consultas ilimitadas para hasta 3 cuentas y 30 días de historial — sin tarjeta de crédito.
Juan Bello

Juan Bello

Fundador, Porter Metrics · 4 de mayo de 2026 · 19 min de lectura

Para conectar X Ads a Claude vía MCP: copia mcp.portermetrics.com/mcp, ve a Claude.ai, abre Conectores → Gestionar conectores → Agregar conector personalizado, pega la URL e inicia sesión. Desde allí, pregúntale a Claude lo que sea sobre tus campañas de X Ads en lenguaje natural.

Una vez conectado, puedes automatizar tus informes y análisis de X Ads: haz preguntas sobre tus datos, crea dashboards, activa alertas o envía informes listos para el cliente como el que aparece abajo.

Requisitos previos

  • Una cuenta de Porter Metrics con tu cuenta de X Ads conectada (el plan gratuito es suficiente para probarlo de principio a fin)
  • Una cuenta de Claude: el plan gratuito funciona para Claude Web; se necesita una suscripción Pro para las funciones de Claude Code y Desktop MCP
  • Acceso de administrador o estándar a las cuentas publicitarias de X Ads que quieres conectar

Conectar X Ads a Claude con MCP

Para este tutorial usaremos el método MCP. Aquí tienes una breve explicación de qué es MCP y por qué es la mejor opción para X Ads.

MCP (Model Context Protocol) es el estándar abierto que permite a herramientas de IA como Claude, ChatGPT, Claude Code y otras acceder y usar APIs externas: los elementos que hacen funcionar herramientas como X Ads detrás de escena. En lugar de crear una integración personalizada para cada herramienta de IA que uses, instalas un MCP y cada IA compatible accede a los mismos datos.

content_paste
Configuración con copiar y pegar
Sin tokens, sin scripts, sin ayuda de desarrolladores: literalmente pega una URL en Claude y listo.
hub
Funciona con todas las herramientas de IA
Claude, Claude Code, ChatGPT, Cursor, Antigravity, Lovable, Vercel v0, Zapier. Una URL de MCP, cada herramienta que habla el protocolo.
merge_type
Más de 20 fuentes en una sola conexión
El MCP de Porter incluye X Ads además de Google Ads, GA4, Shopify, HubSpot, Klaviyo, Google Sheets y más de 20 adicionales. Consulta y combínalas todas en una sola conversación.
tune
Granularidad perfecta
Las hojas de cálculo te limitan a las columnas que exportaste. MCP accede directamente a la API de X Ads, así que puedes filtrar por campaña, desglosar por grupo de anuncios o ubicación, y agregar nuevas dimensiones sobre la marcha sin reconstruir tablas.

La configuración completa toma menos de 5 minutos y se divide en tres pasos: conectar X Ads a Porter, apuntar Claude al MCP de Porter, y hacer tu primera pregunta.

1. Conecta tus datos de X Ads a Porter

Porter se sitúa entre la API de X Ads y Claude. Se encarga de OAuth, limitación de tasas, paginación y toda la infraestructura para que Claude solo vea datos limpios y estructurados.

Regístrate en Porter. Crea una cuenta gratuita en portermetrics.com. El plan gratuito es suficiente para ejecutar este flujo completo de principio a fin.

Conecta tu cuenta de X Ads. En Porter, haz clic en Crear → selecciona Claude como destino → selecciona X Ads como fuente → inicia sesión con X para otorgar acceso a tus cuentas publicitarias.

Selecciona tus cuentas publicitarias. Elige las cuentas publicitarias de X Ads que quieres que Claude consulte. Cuando seleccionas varias cuentas publicitarias bajo una sola conexión, Porter combina automáticamente sus datos para que puedas consultarlas como una sola.

Opcional: activa el almacenamiento en BigQuery si estás conectando varias cuentas publicitarias con grandes volúmenes de datos. Esto mantiene las respuestas de Claude rápidas incluso a gran escala.

2. Conecta el MCP a Claude

La URL del MCP de Porter es lo que pegas en Claude. Una vez agregado, Claude puede consultar datos de X Ads bajo demanda en cualquier conversación.

Ve a claude.ai y haz clic en el + icono en el campo de chat para abrir el menú de herramientas.

En el menú que se abre, pasa el cursor sobre Conectores y haz clic en Gestionar conectores.

En el panel de Conectores, haz clic en el + botón en la parte superior de la lista para empezar a agregar un nuevo conector.

Elige Agregar conector personalizado del menú desplegable que aparece.

Se abre un diálogo con los campos de nombre y URL. Escribe Porter en el primer campo para nombrar el conector.

En el segundo campo, pega https://mcp.portermetrics.com/mcp. No toques la configuración avanzada.

Haz clic en Agregar en la parte inferior derecha del diálogo. Claude abre una ventana de inicio de sesión: usa la misma cuenta de Google vinculada a tu espacio de trabajo de Porter y aprueba el acceso.

Una vez que termine la autorización, verás las herramientas de solo lectura de Porter aparecer en el panel de conectores. Estás listo para empezar a hacer preguntas.

Para un tutorial más completo con capturas de pantalla en cada paso, consulta el tutorial del MCP de Porter.

3. Empieza a crear preguntas y dashboards

Con Porter conectado, abre un nuevo chat de Claude y pregunta lo que sea sobre tu X Ads en lenguaje natural. Claude llama a Porter detrás de escena, extrae datos en vivo de X y responde con tablas, gráficos o resúmenes.

Prueba una de estas para verificar que la configuración funciona:

chat_bubble“¿Cuáles fueron mis campañas de X Ads con mejor rendimiento la semana pasada, ordenadas por ROAS?”
chat_bubble“Muéstrame los grupos de anuncios de X Ads con el Cost per click más alto este mes.”
chat_bubble“Desglosa mis Impressions y Clicks de X Ads por Placement y Gender en los últimos 7 días.”

Para un catálogo completo de prompts para copiar y pegar organizados por caso de uso (rendimiento, fatiga, presupuesto, agencia, B2B, e-commerce, multicanal), salta a la sección de prompts de abajo.

Otras formas de conectar X Ads a Claude

MCP es el camino que acabamos de recorrer, y el que recomendamos para la mayoría de los marketers. Pero no es la única forma de llevar datos de X Ads a Claude. Las alternativas más comunes son la API directa de X Ads (o su MCP oficial si tiene uno), un puente con Google Sheets en vivo, y BigQuery para escalar. Cada una tiene sus pros y contras: elige la que se adapte a cómo ya trabaja tu equipo.

  • 🔌 API directa de X Ads (o MCP oficial) — Habla directamente con la Ads API tú mismo, o instala el MCP nativo de X Ads (si existe). Control máximo, pero tú te encargas de la autenticación, los límites de tasa y la paginación, y solo obtienes una fuente.
  • 📊 Google Sheets — Hoja en vivo o carga de CSV puntual. Auditable, familiar, más rápido para grandes exportaciones, pero la agregación ocurre en la Hoja, no en la API.
  • 🗄️ Google BigQuery — Para cuentas publicitarias grandes o agencias que ejecutan análisis multicuenta. BigQuery agrega; Claude solo consulta resúmenes preconstruidos.

Vía la API directa de X Ads (o MCP oficial)

Si estás construyendo un producto alrededor de X Ads, o eres un desarrollador que prefiere controlar cada capa de la integración, el camino más directo es hablar con la Ads API tú mismo, o instalar el MCP oficial de X Ads (si existe). X aún no ofrece un MCP oficial, así que esto significa escribir llamadas a la API directamente en Claude Code o en tus propios scripts. Necesitarás seguir los límites de tasa y cuotas y solicitar acceso a la API cuando corresponda. De cualquier forma, omites Porter por completo y llamas a X desde tu propio código o desde Claude Code con solicitudes HTTP sin procesar.

La contrapartida que debes conocer. Ir directo te da el control máximo y los datos más frescos posibles: cada endpoint, cada parámetro, sin capa de abstracción en medio. Pero ahora eres responsable de los flujos de OAuth, tokens de actualización, límites de tasa, paginación, cambios de esquema y reintentos de errores. Y, críticamente, solo obtienes una fuente. En el momento en que también quieras Google Ads, GA4 o Shopify en la misma conversación, vuelves a construir (o unir) más integraciones.
Cuando esto tiene sentido: equipos de ingeniería que necesitan una sola fuente con control total, productos que ofrecen datos de X Ads como una función (donde de todos modos posees la integración), o scripts puntuales donde no te importa escribir el código de autenticación y paginación tú mismo. Para marketers que quieren hacer preguntas en lenguaje natural y combinar X Ads con el resto de su stack en una sola conversación, el camino del MCP de Porter es dramáticamente menos trabajo.

Vía Google Sheets (hoja en vivo o CSV manual)

Si tu equipo ya vive en Google Sheets, o quieres un rastro de auditoría antes de que Claude toque algo, introduce X Ads en una Hoja y luego deja que Claude lea la Hoja. Puedes automatizar el flujo X Ads → Sheets con Porter para que se actualice diariamente, o hacer exportaciones de CSV puntuales desde la interfaz nativa de X Ads para análisis estático.

La contrapartida que debes conocer. Con el camino del MCP, Claude llama a la API de X directamente y X hace el filtrado y la agregación de su lado: limpio y determinista. Con el camino de Sheets, Claude agrega dentro de la Hoja misma, lo que puede introducir alucinaciones en totales, promedios y uniones cuando tienes miles de filas. La ventaja es la velocidad: para rangos de fechas muy grandes o análisis histórico, una Hoja preconstruida es dramáticamente más rápida que las llamadas a la API en vivo.
Cuando esto tiene sentido: equipos de finanzas que quieren revisar los números antes de que Claude actúe sobre ellos, agencias que ya entregan informes de clientes en Sheets, análisis histórico a lo largo de años de datos, o cualquier caso donde te importe más la velocidad que la frescura en tiempo real.

Lee el tutorial completo de Sheets →

Vía Google BigQuery (para escalar)

Este es el camino que la mayoría pasa por alto, y es el que te salva cuando tu cuenta publicitaria de X Ads se pone seria. Un solo anunciante grande o una agencia que gestiona más de 10 cuentas publicitarias alcanzará los límites de tasa de la API y tendrá problemas de latencia al consultar Claude directamente. Claude literalmente te dirá que está tardando demasiado o que se agota el tiempo en extracciones grandes.

BigQuery soluciona eso. Cargas datos de X Ads en tablas de BigQuery de forma programada, luego conectas BigQuery a Claude, ya sea a través de un MCP de BigQuery o vía Claude Code con consultas SQL. En lugar de pedirle a Claude que extraiga datos sin procesar de X Ads, dejas que BigQuery agregue en tablas pequeñas y optimizadas, y Claude solo consulta el resultado resumido. Problema de escala resuelto.

Cuando esto tiene sentido: cuentas publicitarias empresariales con millones de impresiones, agencias que ejecutan análisis multicuenta en más de 10 clientes, o cualquier equipo que ya use BigQuery como data warehouse. Porter carga X Ads (y más de 25 fuentes adicionales) directamente en BigQuery para que no tengas que construir tu propio ETL.

Lee el tutorial completo de BigQuery →

Conectar X Ads a Claude Code

La mayoría de los marketers agrupan a Claude y Claude Code juntos y pasan por alto la mayor ventaja de todo el ecosistema MCP. No son la misma herramienta, y la diferencia importa enormemente una vez que empiezas a trabajar seriamente con datos de X Ads.

Claude es una interfaz de chat. Haces una pregunta, Claude extrae datos en vivo a través del MCP, responde, tal vez crea un dashboard rápido dentro de la conversación. Genial para análisis puntuales. El problema: todo es efímero. ¿Quieres actualizar el dashboard mañana? Lo regeneras desde cero. ¿Quieres el mismo informe cada lunes? Vuelves a hacer la pregunta cada lunes.

Claude Code es Claude ejecutándose dentro de la terminal de tu computadora. Como tiene acceso a tu sistema de archivos, tiempo de ejecución y otras herramientas de desarrollo, no solo responde preguntas: puede construir software real. Scripts persistentes, rutinas programadas, aplicaciones HTML, dashboards internos, integraciones que funcionan 24/7 sin tu intervención. Una vez conectado al MCP de Porter para X Ads, toda una categoría de trabajo se vuelve posible.

Lo que Claude Code desbloquea que Claude solo no puede

Aquí es donde el ecosistema MCP rinde más frutos. Como Claude Code puede combinar el MCP de Porter con otros MCPs — Firecrawl para web scraping, Airtable para datos estructurados, Notion para wikis, Vercel para despliegue, Slack y Gmail para entrega — ya no estás consultando datos. Estás construyendo herramientas.

🛠️ Crea tu propia app de gestión de presupuestos Stack: Porter MCP + Vercel MCP (o Cloudflare Pages, Netlify) Alimenta a Claude Code con tus objetivos y metas de X Ads — objetivos de CPA, presupuestos diarios, umbrales de ROAS — y pídele que genere un dashboard de ROI personalizado para cada cliente. Construye el HTML, extrae datos en vivo, despliega en una URL. Sin embeds de Data Studio que se rompan cuando el proveedor cambia los precios, sin restricciones de plantillas. El dashboard se actualiza automáticamente porque consulta el MCP de Porter en cada carga de página. Ideal para: agencias que quieren dashboards de clientes white-label sin depender de Looker o Data Studio.

🔍 Monitoreo completo de competidores + rendimiento Stack: Porter MCP + Firecrawl MCP Combina tu propio rendimiento de X Ads desde Porter con páginas de destino de competidores y anuncios en vivo de la plataforma X Ads extraídos vía Firecrawl. Claude Code une ambos en un informe semanal de inteligencia competitiva: tus números junto a sus ángulos creativos y segmentación, con un resumen de LLM sobre lo que cambió semana a semana. Se ejecuta en cron, llega a tu bandeja de entrada cada lunes por la mañana. Ideal para: equipos internos que necesitan contexto de mercado, no solo números internos.

📚 Wiki interna de marketing con métricas en vivo Stack: Porter MCP + Airtable MCP (o Notion MCP) Usa Airtable o Notion como esquema, Porter como fuente de datos. Claude Code mantiene cada página poblada con el gasto actual, CPA y ROAS de cada cuenta publicitaria: sin capturas de pantalla obsoletas, sin copiar y pegar desde Excel. Los nuevos empleados leen una entrada de la wiki y tienen contexto completo sobre la cuenta de un cliente. Ideal para: agencias y equipos de operaciones que incorporan analistas o rotan gestores de cuentas con frecuencia.

🔔 Alertas 24/7 sobre gasto, CTR y caídas de calidad Stack: Porter MCP + Slack MCP (o Gmail MCP) Una rutina de Claude Code en cron extrae X Ads vía Porter, evalúa umbrales — CTR cae por debajo del 1%, el gasto diario se dispara al doble del promedio móvil — y envía alertas de Slack o Gmail en el momento en que algo cruza la línea. Dejas de revisar dashboards reactivamente; el dashboard se revisa a sí mismo y te dice cuándo mirar. Ideal para: cualquier equipo que haya descubierto un problema 48 horas tarde porque nadie abrió el informe.

Conclusión: Claude es para preguntas rápidas y dashboards ad-hoc. Claude Code es para construir apps, dashboards en vivo, alertas y herramientas reales: cualquier cosa que quieras que funcione por sí sola sin volver a preguntar. La misma URL del MCP de Porter funciona en ambos, así que no eliges una vez y te quedas atado.

Casos de uso: qué puedes hacer realmente una vez que X Ads está conectado a Claude

Conseguir la conexión correcta es la mitad de la batalla. El valor real aparece en lo que haces después. Aquí están los casos de uso que los usuarios de Porter construyen alrededor de sus datos de X Ads: desde preguntas y respuestas simples hasta flujos de trabajo completos orientados al cliente.

1. Chatea y haz preguntas directamente

El caso de uso más simple, y aún así el con el que empieza el 80% de los marketers. Abre Claude, haz una pregunta, obtén una respuesta basada en datos en vivo.

chat_bubble“¿Cuáles fueron mis campañas principales de X Ads por Billed Engagements la semana pasada?”
chat_bubble“Muéstrame la tendencia de Spend e Impressions de X Ads este mes vs el mes pasado.”
chat_bubble“¿Qué grupos de anuncios tienen el Cost per click más alto y la Conversion Rate más baja?”

Es la forma más rápida de reemplazar el check-in diario de Ads Manager. Pero el chat es solo la base: los casos de uso interesantes vienen después.

2. Combina X Ads con tus datos de ventas (Stripe, HubSpot, Shopify)

Aquí es donde una visión 360° se vuelve real. Cuando conectas X Ads y tu fuente de ingresos (Stripe para SaaS, HubSpot CRM para B2B, Shopify para e-commerce), Claude puede mapear campañas publicitarias a oportunidades cerradas ganadas o compras reales — usando UTMs, nombres de campañas y marcas de tiempo — y darte una atribución que ningún número de la plataforma puede ofrecer.

chat_bubble“Mapea el gasto de mis campañas de X Ads a compras de Shopify usando los nombres de campañas UTM.”
chat_bubble“Muéstrame la atribución de clicks de X Ads a oportunidades cerradas ganadas de HubSpot este trimestre.”

Claude se encarga del mapeo de UTMs y las uniones. Obtienes un informe de atribución listo para el cliente que ninguna plataforma individual puede generar por sí sola.

3. Alertas y notificaciones automatizadas en Slack o Gmail

Con Claude Code puedes convertir el monitoreo de X Ads en una rutina que funciona por sí sola. Conecta el MCP de Porter (para los datos) junto con un MCP de Slack o Gmail (para la entrega), luego escribe una tarea programada de Claude Code que extrae el rendimiento cada mañana y te avisa solo cuando algo realmente necesita atención.

chat_bubble“Avísame cuando el gasto diario de X Ads supere el doble del promedio móvil de 7 días.”
chat_bubble“Notifícame cuando el CTR de X Ads caiga por debajo del 1% en cualquier campaña activa.”

Sin dashboards, sin check-ins diarios. El informe viene a ti, y solo cuando importa.

4. Presentaciones listas para el cliente con datos en vivo (Gamma, HTML, PDF)

Un dolor común de las agencias: envías a los clientes un enlace de Data Studio, Looker se rompe, el cliente entra en pánico, y pasas una hora explicando un dashboard roto. Con Claude puedes construir la presentación misma — como un deck de Gamma, una página HTML personalizada, o un PDF — poblada con números en vivo cada vez.

chat_bubble“Crea un informe semanal de X Ads listo para el cliente con Spend, Impressions y ROAS por campaña.”
chat_bubble“Genera un deck de Gamma comparando mi rendimiento de X Ads vs Meta Ads el mes pasado.”

La presentación se convierte en un artefacto de entrega que envías al cliente, no en un dashboard que depende de que otra herramienta siga funcionando. Sin iframe roto, sin solicitudes de inicio de sesión, solo el contenido.

Campos y métricas de X Ads que puedes consultar con Claude

Antes de empezar a escribir prompts, ayuda saber qué datos están realmente disponibles. El MCP de Porter le da a Claude acceso a 899 campos y métricas de X Ads en todos los niveles de informe, más desgloses por audiencia, ubicación, dispositivo y geografía. Y la misma URL de MCP también desbloquea más de 25 fuentes adicionales, así que Claude puede combinar X Ads con Google Ads, GA4, Shopify, HubSpot y más en un solo prompt.

Niveles de informe
Account IDAccount NameCampaign IDCampaign nameCampaign statusAd Group IDAd Group nameAd statusAd Name
Métricas de visibilidad
ImpressionsBilled EngagementsCost per 1k impressionsFollowsAverage frequencyTotal audience reach
Métricas de engagement
ClicksCTRCost per clickEngagementsLikesRetweetsMedia viewsVideo play actions
Métricas de conversión
ConversionConversion RateCost Per ConversionApp InstallPurchaseROAS (Onsite)
Eficiencia (tasas y costos)
SpendCampaign BudgetCampaign daily budgetBid amountCPM
Desgloses de audiencia
CountryGenderAgePlatformInterest CategoryKeywordPlacementDMA ID
Fuentes multicanal (misma URL)
Google AdsGA4ShopifyTikTok AdsLinkedIn AdsHubSpotSearch Console+15 más

Prompts que puedes copiar y pegar hoy

1. Para agencias

Úsalos cuando gestiones múltiples cuentas de X Ads de clientes o envíes informes semanales a clientes.

chat_bubble“Muestra mis 5 campañas principales por Billed Engagements en los últimos 7 días en una tabla.”
chat_bubble“Marca cualquier grupo de anuncios donde el Cost per click haya subido un 30% vs la semana pasada.”
chat_bubble“Redacta un resumen semanal de X Ads listo para el cliente con Spend e Impressions.”
chat_bubble“Cruza los nombres de mis campañas de X Ads con las Conversiones de Google Ads del mes pasado.”

2. Para marketers B2B

Úsalos para optimización de generación de leads, refinamiento de segmentación por keyword y seguimiento de visitas de perfil a conversión.

chat_bubble“Compara mi Cost per lead este trimestre vs el trimestre pasado por campaña.”
chat_bubble“Muéstrame qué Interest Category tiene el Cost per lead más bajo y la Conversion Rate más alta.”
chat_bubble“Descubre por qué mis Profile Visits cayeron ayer y muestra el desglose por Gender.”
chat_bubble“Compara mi Cost Per Conversion en desktop vs mobile Platform en los últimos 14 días.”

3. Para equipos de e-commerce

Úsalos para monitoreo de compras en sitio web, detección de fatiga creativa y reasignación de presupuesto.

chat_bubble“Lista mis 3 peores campañas por Website Conversion Rate este mes con Spend y Clicks.”
chat_bubble“Marca cualquier anuncio donde el Cost per click se haya duplicado en los últimos 3 días vs la semana anterior.”
chat_bubble“Proyecta mi Spend y Website Purchase para la próxima semana basándote en los últimos 30 días.”
chat_bubble“Avísame cuando el Campaign Budget alcance el 80% gastado antes de que termine el mes.”

4. Multicanal

Úsalos cuando combines X Ads con otras plataformas para informes unificados y atribución.

chat_bubble“Cruza mis campañas de X Ads con Google Ads del mes pasado y muestra cuál generó más Conversiones.”
chat_bubble“Compara la tendencia de Cost per click de X Ads vs Meta Ads en los últimos 90 días.”
chat_bubble“Muéstrame qué plataforma tiene el Cost Per Result más bajo este trimestre: X o LinkedIn.”
chat_bubble“Redacta un informe mensual comparando las Impressions y CTR de X Ads y TikTok Ads.”

Límites, autenticación y mejores prácticas para X Ads vía Claude

chat_bubble“Agotamos nuestra cuota de API en 20 minutos intentando extraer 90 días de datos de campaña para un informe de cliente del lunes por la mañana. El resto de la semana estuvimos bloqueados: tuvimos que exportar CSVs manualmente desde Ads Manager como si fuera 2019.” — operador de agencia, citado en análisis de MCP playground sobre limitaciones de la API de X Ads, 2025.”

Este es el modo de falla más común para marketers que usan X Ads vía API o MCP: agotamiento de cuota durante extracciones masivas de datos, no prohibiciones de cuenta. El marketer suele ser un dueño de agencia o un líder de rendimiento interno que ejecuta auditorías multicuenta los lunes por la mañana: la persona exacta que Porter atiende. El costo real no es una cuenta suspendida; es productividad perdida (4–6 horas de exportaciones manuales) e informes de clientes retrasados que dañan la confianza. El retraso de informes documentado de 48 horas de la API de X Ads agrava el problema: incluso cuando la cuota se reinicia, los datos de ayer a menudo aún no están disponibles, haciendo que las promesas de “tiempo real” de herramientas de terceros sean activamente engañosas.

El cumplimiento de la API de X es basado en cuotas y patrones, no basado en herramientas. X no prohíbe cuentas publicitarias porque usaste Claude o un servidor MCP. Limita o suspende temporalmente el acceso a la API por cómo se usó la API: enviar ráfagas paralelas que exceden los límites de solicitudes por ventana, redistribuir IDs de contenido a escala sin autorización, o hacer scraping agresivo con automatización de navegador. El acceso de solo lectura dentro de las ventanas de tasa documentadas es seguro. Las ráfagas de escritura paralelas, lecturas masivas sin lotes en docenas de cuentas publicitarias, y la redistribución de datos no autorizada no lo son. La plataforma devuelve 429 Too Many Requests errores primero, luego limitación progresiva; la suspensión está reservada para abuso repetido o violaciones de políticas como la redistribución de datos no autorizada.

Las tres formas de agotar tu cuota de X Ads

Después de revisar documentación oficial y hilos de la comunidad, tres patrones aparecen una y otra vez.

1. Ráfagas de API paralelas en múltiples cuentas publicitarias. Enviar solicitudes concurrentes para extraer datos de campaña de muchas cuentas simultáneamente viola las ventanas de tasa por cuenta y por app. La API de X aplica límites a nivel de categoría como 450 escrituras por ventana de 1 minuto y 10,000 lecturas de entidades principales por ventana de 15 minutos a nivel de cuenta publicitaria — exceder estos desencadena 429 limitación inmediata y puede desencadenar una suspensión temporal de acceso si el patrón se repite en un período corto. Fuente: docs.x.com/x-ads-api/fundamentals/rate-limiting. En su lugar: procesa las solicitudes en lotes secuencialmente y respeta los x-rate-limit-remaining headers.

2. Escrituras programáticas a escala sin verificación de nivel. La API de X Ads requiere acceso de nivel Premium para operaciones de escritura (creación de campañas, cambios de presupuesto, ajustes de puja). El nivel Basic es de solo lectura. Intentar operaciones de escritura con un token de nivel Basic fallará silenciosamente o devolverá errores de autorización, y reintentar escrituras fallidas repetidamente puede agotar tu cuota de solicitudes sin lograr nada. Fuente: docs.x.com/x-ads-api/fundamentals/rate-limiting + análisis de corpus de competidores sobre restricciones de niveles de API. En su lugar: verifica tu nivel de API antes de habilitar alcances de escritura, y usa configuraciones de MCP de solo lectura para flujos de trabajo de auditoría e informes.

3. Redistribución no autorizada de Post IDs y contenido en caché. Las directrices para desarrolladores de X imponen un límite estricto de no más de 1.5 millones de redistribuciones de Post ID por período de 30 días y requieren la eliminación de contenido de X en caché dentro de 24 horas desde una solicitud de eliminación. Usar scripts generados por Claude para extraer contenido creativo de anuncios (tweets, imágenes, videos) y redistribuirlos a herramientas de informes externas o dashboards de clientes sin autorización adecuada viola estos términos. Fuente: docs.x.com/developer-guidelines. En su lugar: usa solo métricas de rendimiento agregadas (impressions, clicks, spend) y enlaza de vuelta a activos nativos de X en lugar de almacenarlos en caché o replicarlos.

Los tres comportamientos desencadenan limitación basada en cuotas y 429 respuestas progresivas. Si quieres usar Claude para X Ads de forma segura, procesa tus lecturas en lotes, verifica tu nivel antes de escrituras, y nunca redistribuyas contenido creativo sin autorización.

El protocolo de escalado de 5 reglas

Basado en los límites de tasa y cuotas documentados de X y los comportamientos que realmente han causado limitación, no en conjeturas:

  • Procesa tus lecturas en lotes; nunca hagas ráfagas. Mantente dentro de los 10,000 lecturas de entidades principales por ventana de 15 minutos por cuenta publicitaria y 450 escrituras por ventana de 1 minuto. Exceder estos desencadena 429 limitación que puede bloquearte durante el resto de la ventana. Fuente: docs.x.com/x-ads-api/fundamentals/rate-limiting. El MCP de Porter aplica esto automáticamente encolando solicitudes y respetando los x-rate-limit-remaining headers.

  • Verifica tu nivel de API antes de habilitar escrituras. Los tokens de nivel Basic son de solo lectura; las operaciones de escritura requieren aprobación de nivel Premium de X. Intentar escrituras con nivel Basic desperdicia cuota y produce fallos de autorización. El MCP de Porter usa alcances de solo lectura por defecto y muestra una advertencia si se solicitan operaciones de escritura sin acceso Premium verificado.

  • Respeta el retraso de informes de 48 horas. Los datos de la API de X Ads son no son en tiempo real — los datos de rendimiento de campaña típicamente tienen un retraso de 48 horas antes de estar completamente disponibles y confiables. Tomar decisiones de presupuesto o segmentación basadas en extracciones de API del mismo día o de ayer produce conclusiones inexactas. Fuente: corpus de competidores (mcpplaygroundonline.com, 2025) + documentación comunitaria de la API de X Ads. El MCP de Porter muestra marcas de tiempo de frescura de datos en cada consulta para que los usuarios sepan exactamente qué tan obsoleta es cada métrica.

  • Limita la redistribución de Post ID a ≤1.5 millones por 30 días. Si tu flujo de trabajo implica extraer contenido de tweets, IDs creativos o datos de engagement para redistribución (p. ej., dashboards de clientes, informes externos), mantente por debajo del límite de 1.5 millones de redistribuciones de Post ID por período de 30 días y elimina el contenido en caché dentro de 24 horas desde cualquier solicitud de eliminación. Fuente: docs.x.com/developer-guidelines. El MCP de Porter no almacena en caché ni redistribuye contenido creativo: consulta solo métricas agregadas, manteniéndote bien dentro de este límite.

  • Usa alcances OAuth mínimos y audita anualmente. Solicita solo los alcances que tu conexión MCP realmente necesita (típicamente ads:read para informes; ads:write solo si se confirma el nivel Premium). X requiere auditorías de seguridad anuales para apps con acceso elevado. El MCP de Porter solicita los alcances más estrechos posibles en el momento de la conexión y registra cada llamada a la API para auditorías.

Lo que el MCP de Porter hace diferente: aplica estos límites de tasa y salvaguardas a nivel de plataforma. Porter procesa solicitudes a la API entre cuentas para mantenerse dentro de las ventanas de 10,000 lecturas por 15 minutos y 450 escrituras por minuto, retrocediendo automáticamente cuando x-rate-limit-remaining se acerca a cero. Usa por defecto alcances de solo lectura para que los usuarios de nivel Basic nunca desperdicien cuota en intentos de escritura no autorizados. Muestra marcas de tiempo de frescura de datos en cada respuesta, haciendo que el retraso de informes de 48 horas sea transparente en lugar de oculto. Nunca almacena en caché ni redistribuye Post IDs, manteniéndote bien por debajo del límite de redistribución de 1.5M. Y solicita alcances OAuth mínimos en el momento de la conexión, reduciendo tanto la superficie de ataque de seguridad como la carga de auditoría. Ese es el comportamiento que los sistemas automatizados de X manejan sin problemas, y por eso los usuarios de Porter no son limitados.

Preguntas frecuentes

¿Qué es un MCP de X Ads?

Un MCP de X Ads es un estándar abierto que permite a las herramientas de IA conectarse a tus datos de X Ads sin integraciones personalizadas. El servidor MCP de Porter pone tus campañas, cuentas publicitarias y grupos de anuncios disponibles a través de una URL: sin tokens, sin scripts, sin configuración de desarrolladores.

¿Cuál es la diferencia entre Claude y Claude Code?

Claude es el producto conversacional (web, app, móvil). Claude Code es una herramienta de desarrollo basada en terminal que puede escribir scripts, guardar archivos y automatizar flujos de trabajo. Ambos pueden conectarse a X Ads vía MCP.

¿Qué tan frescos son los datos? ¿Son en tiempo real?

No. Los datos de X Ads tienen un retraso de informes de 48 horas, así que los datos del mismo día y de ayer a menudo están incompletos. El MCP de Porter muestra marcas de tiempo de frescura para que sepas exactamente qué tan actual es cada métrica.

¿Hay límites de tasa para los datos de X Ads?

Sí. X aplica 450 escrituras por ventana de 1 minuto y 10,000 lecturas de entidades principales por ventana de 15 minutos por cuenta publicitaria. El MCP de Porter procesa solicitudes en lotes y respeta los headers de límite de tasa automáticamente.

¿Por qué los números de Claude a veces difieren de Ads Manager?

Tres razones comunes: (1) Retraso de sincronización de facturación — los números de la API pueden retrasarse 36 horas respecto a Ads Manager mientras las transacciones se finalizan. (2) Filtrado por rango de fechas — la API y la interfaz pueden aplicar diferentes filtros de zona horaria o estado. (3) Ventanas de atribución — las configuraciones de atribución personalizadas en Ads Manager pueden no coincidir con los valores predeterminados de la API. La solución: compara rangos de fechas idénticos y verifica que las configuraciones de atribución coincidan.

¿Usar Claude afectará mi acceso o límites de X Ads?

No. X no prohíbe ni restringe cuentas por uso legítimo de la API, y el MCP de Porter es de solo lectura por defecto: se mantiene bien dentro de los límites normales de tasa de X. Lo que hay que vigilar es la limitación de tasa por ráfagas paralelas en múltiples cuentas: consulta la sección de límites de arriba.

¿Listo para chatear con tu X Ads?

Abre Claude, añade el conector de Porter y haz tu primera pregunta. Si aún no tienes Porter, empieza una prueba gratuita y conecta tu cuenta de X Ads — estarás chateando con tus campañas en menos de cinco minutos.

rocket_launch Pruébalo gratisopen_in_new Abre Claude