Conecta Apple Search Ads a Claude o ChatGPT en cinco minutos

El conector de Hermoso para Apple Search Ads conecta tu cuenta de Apple Ads con Claude, ChatGPT, Cursor, la CLI o HTTP simple, para que un agente pueda gestionar tus anuncios de búsqueda en la App Store por ti. Crea la campaña, el grupo de anuncios, las palabras clave de segmentación y las negativas, comprueba lo que Apple guardó de verdad e informa del rendimiento hasta el término que alguien escribió antes de instalar la app. Todo lo que crea se crea en pausa, y activar el gasto es un paso aparte que hay que confirmar de forma explícita. Los informes pueden acabar en una hoja de Google, en un panel de Looker Studio o en un archivo JSON, y la página de MCP de Apple Ads enumera todo lo que el conector puede hacer.

Conectarlo tarda unos cinco minutos. No tendrás que ejecutar openssl, y ninguna contraseña de Apple llega nunca a Hermoso.

Conectar Apple Search Ads a Claude

Para conectar Apple Search Ads a Claude, añade Hermoso a Claude como conector y luego conecta tu cuenta de Apple Ads dentro de Hermoso una vez. En Claude, abre Customize › Connectors › Add custom connector, ponle el nombre Hermoso, pega https://app.hermoso.ai/mcp y apruébalo con tu cuenta de Hermoso. No hay ninguna clave que pegar en Claude. Después, conecta Apple Ads en Hermoso en Configuración › Conectores, siguiendo los pasos más abajo en esta página. A partir de ese momento, Claude puede llamar a todas las herramientas de Apple Ads que tiene Hermoso: pídele un informe, un cambio de palabras clave o una campaña nueva con palabras normales. En Claude Code basta con dos comandos: /plugin marketplace add hermoso-ai/hermoso y luego /plugin install hermoso@hermoso. Hermoso en Claude tiene los pasos completos.

Conectar Apple Search Ads a ChatGPT

Con ChatGPT funciona igual. En ChatGPT, abre Plugins y luego Add › Create MCP App, ponle el nombre Hermoso, pega https://app.hermoso.ai/mcp como Server URL, deja la autenticación en OAuth y apruébalo con tu cuenta de Hermoso. Si no aparece Create MCP App, activa una vez el modo desarrollador en Settings › Plugins › Developer mode. Con Apple Ads conectado en Hermoso, ChatGPT puede sacar tu informe de palabras clave, escribirlo en una hoja de Google o preparar una campaña para que la revises. Hermoso en ChatGPT lo explica paso a paso.

Cursor, Codex y cualquier otro cliente MCP

Cualquier cliente que hable el Model Context Protocol llega a las mismas herramientas en la misma dirección. Cursor lee https://app.hermoso.ai/mcp desde su mcp.json; Codex usa el plugin de Hermoso con codex plugin marketplace add hermoso-ai/hermoso, que maneja las mismas herramientas desde la terminal. Uses el cliente que uses, tus credenciales de Apple nunca pasan por el chat. El agente llama a las herramientas de Hermoso, y Hermoso firma cada petición a Apple con la clave que guarda. La página de MCP de Apple Ads enumera todas las herramientas.

Qué pedir una vez conectado

• “Saca el rendimiento de Apple Search Ads de la semana pasada por palabra clave y muéstrame las diez con el coste por adquisición más alto.”
• “Pon el gasto, las instalaciones y el CPA de los últimos 30 días por campaña en una hoja de Google nueva llamada Apple Ads.” (Conecta Google Drive primero.)
• “¿Qué términos de búsqueda trajeron instalaciones este mes en mi campaña de EE. UU. y todavía no tengo como palabras clave exactas?”
• “Añade ‘budget planner’ y ‘expense tracker’ como palabras clave de coincidencia exacta en el grupo de anuncios Brand, y ‘jobs’ como negativa.”
• “¿Qué palabras clave sugiere Apple para mi app, y qué porcentaje de impresiones consigo en las que ya estoy pujando?”
• “Crea una campaña pausada para mi app en Reino Unido con un presupuesto diario de 50 dólares, y luego muéstrame lo que Apple guardó.”

Leer un informe nunca toca el gasto. Todo lo que cree el agente se crea en pausa, y el interruptor que activa el gasto espera tu confirmación explícita.

Primero, lo que frena a la mayoría

Las instrucciones de Apple dicen: “Desde la interfaz de Ads, elige Account Settings › API. Pega la clave en el campo Public Key.”

Ese campo no existe para un administrador de la cuenta. Inicia sesión como administrador en tu propia cuenta, abre Account Settings › API, y lo que aparece es una tabla titulada Manage API Access (una lista de proveedores externos de servicios con una única acción, Remove Access) y ningún campo de clave en ninguna parte de la página. Parece exactamente una función que no existe, y por eso mucha gente se detiene aquí y concluye que la API no está disponible para ellos.

Sí está disponible. El campo Public Key pertenece a un usuario con un rol de API, y ser administrador de la cuenta no es uno. El diálogo de invitación de Apple ofrece seis roles, de los cuales exactamente dos son roles de API:

• API Account Manager: “acceso de lectura y escritura a todos los grupos de campañas para la gestión de API”. Este es el que debes elegir si quieres que Hermoso cree campañas, no solo que las informe.
• API Account Read Only: “acceso solo de lectura a todos los grupos de campañas para la gestión de API”. Basta para informes, y nada más.

Los otros cuatro (Account Admin, Account Finance, Account Read Only y Limited Access) no pueden crear credenciales de API en absoluto. Así que la solución es una invitación que te envías a ti mismo:

1. Abre Account Settings › User Management y elige Invite Users.
2. Invita una dirección que controles (la tuya, o una compartida como ads-api@yourcompany.com, para que la credencial sobreviva a cualquier persona) con el rol API Account Manager.
3. Acepta la invitación desde esa bandeja de entrada y luego inicia sesión en Apple Ads como ese usuario.

Ahora Account Settings › API tiene un campo Public Key.

La conexión, paso a paso

1. Empieza en Hermoso. Configuración › Conectores › Apple Ads › Conectar. Hermoso genera una clave de firma EC P-256 (la misma clave prime256v1 que habrían producido los dos comandos openssl de Apple) y te muestra solo la mitad pública. Cópiala.
2. Dale la mitad pública a Apple. Como usuario con rol de API, abre Account Settings › API, pégala en Public Key y guarda.
3. Copia de vuelta los tres ids. Apple muestra ahora clientId, teamId y keyId encima de ese campo. Los tres.
4. Termina en Hermoso. Pega los tres ids y guarda. Hermoso intercambia un token con Apple y lee tu lista de organizaciones antes de guardar nada, así que un id mal escrito falla en ese momento, mientras todavía ves lo que pegaste, y no en tu primer informe una hora después.
5. Elige la organización, si tus credenciales cubren más de una. La conexión queda fijada a la que elijas.

Si algo sale mal

No hay campo Public Key en la página de API

Has iniciado sesión como Account Admin, o con cualquiera de los cuatro roles que no son de API. Invítate a ti mismo como API Account Manager e inicia sesión como ese usuario (ver arriba). Es la causa más común de que nunca llegue a hacerse la conexión de Apple Ads.

Apple rechaza las credenciales

Los tres ids tienen que pertenecer a la clave que Apple tiene guardada. Vuelve a copiar clientId, teamId y keyId desde justo encima del campo Public Key, no desde una clave anterior que hayas sustituido. Si siguen fallando, empieza la conexión de nuevo en Hermoso: eso crea un par de claves nuevo, y pegas la mitad pública nueva en Apple.

La sesión de configuración caducó

Hermoso guarda la clave privada generada durante 24 horas mientras vas a pegar su mitad pública en Apple. Pasado ese tiempo desaparece, a propósito. Empieza la conexión de nuevo y pega la clave pública nueva.

Ya generé una clave con openssl

Entonces úsala. Pega tu clave privada EC P-256 existente al conectar, en lugar de usar la de Hermoso, y la clave pública que ya está en tu cuenta de Apple seguirá funcionando. Tiene que ser una clave EC P-256 (prime256v1). Apple no acepta ninguna otra curva.

Gestiono varias organizaciones de Apple Ads

Conecta cada una en su propio perfil de Hermoso. Una conexión queda fijada a una sola organización, y eso es lo que evita que una campaña de una agencia acabe en la cuenta de otro cliente.

Lo que puede hacer el conector de Apple Search Ads

Crear: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object.

Leer: list_apple_ads_campaigns (estado, estado de entrega, presupuesto diario y total, los países en los que se ejecuta una campaña y el motivo que indica Apple cuando no puede ejecutarse), list_apple_ads_ad_groups (puja predeterminada y si Search Match de Apple está activo), list_apple_ads_keywords (segmentación y negativas, con tipo de coincidencia y puja), apple_ads_report (impresiones, toques, instalaciones, gasto, TTR, CPT y CPA a nivel de campaña, grupo de anuncios, palabra clave, término de búsqueda o anuncio) y list_apple_ads_orgs.

Todo esto se puede llamar desde Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes o cualquier otro cliente MCP, y desde el estudio web. Es el mismo motor en todos los casos. Consulta el resumen de MCP o la referencia de herramientas de anuncios.

Y más: crea creatividades y anuncios (create_apple_ads_creative, create_apple_ads_ad), carga hasta 1.000 palabras clave en una sola llamada (bulk_apple_ads_keywords) y lee los datos del propio Apple: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity y apple_ads_change_history. Todas se pueden llamar desde el mismo chat.

Exportar datos de Apple Search Ads

La misma conexión sirve para informes. apple_ads_report saca el rendimiento de campañas, grupos de anuncios, anuncios, palabras clave y términos de búsqueda (impresiones, toques, instalaciones, gasto, tasa de toques, coste por toque y coste por adquisición), en totales o en una serie por hora, día, semana o mes, hasta 5.000 filas por página. Leer un informe nunca toca el gasto. El destino de las filas depende de ti, y los tres más habituales están abajo. La guía completa es Exportar datos de Apple Search Ads.

Conectar Apple Search Ads a Google Sheets

Conecta Google Drive junto a Apple Ads (una sola autorización de Google cubre Drive, Sheets y Docs) y pide a tu agente que ponga el informe en una hoja. Llama a apple_ads_report, luego a create_sheet para una hoja de cálculo nueva, o a append_to_sheet para añadir las filas de esta semana a una existente. Hermoso usa el ámbito de Google drive.file, que solo alcanza los archivos que crea y los que tú eliges. Paso a paso: Conectar Apple Search Ads a Google Sheets.

Exportar Apple Search Ads a Looker Studio

Hermoso no tiene un conector nativo de Looker Studio. Looker Studio lee Google Sheets con su propio conector, así que la hoja de arriba es el puente: añádela una vez como fuente de datos de Google Sheets, crea el panel y cada añadido semanal aparecerá en la siguiente actualización. Power BI y Tableau leen la misma hoja de la misma forma. Los pasos para Looker Studio.

Exportar Apple Search Ads a JSON

Para filas en bruto, llama a la herramienta a través de la API REST de Hermoso con una clave de API: POST https://app.hermoso.ai/v1/tools/apple_ads_report con los argumentos del informe como cuerpo JSON, y lee las filas en data.rows de la respuesta. Desde una terminal, npx -y hermoso call apple_ads_report --json '{...}' --structured imprime el mismo resultado en JSON. Un ejemplo completo de petición.

Preguntas frecuentes

¿Cómo conecto Apple Search Ads a Claude?

Añade Hermoso a Claude como conector personalizado con la URL https://app.hermoso.ai/mcp y apruébalo con tu cuenta de Hermoso, luego conecta Apple Ads en Hermoso en Configuración › Conectores. Claude podrá entonces informar, editar y crear tus campañas de Apple Search Ads a través de las herramientas de Apple Ads de Hermoso.

¿ChatGPT puede leer mis datos de Apple Search Ads?

Sí. Añade https://app.hermoso.ai/mcp en ChatGPT en Plugins › Add › Create MCP App, y conecta Apple Ads en Hermoso. ChatGPT podrá entonces sacar impresiones, toques, instalaciones, gasto, TTR, CPT y CPA por campaña, grupo de anuncios, anuncio, palabra clave o término de búsqueda, y escribir las filas en una hoja de Google.

¿Existe un servidor MCP de Apple Search Ads?

Sí. El servidor MCP alojado de Hermoso en https://app.hermoso.ai/mcp expone el conjunto completo de herramientas de Apple Ads a Claude, ChatGPT, Cursor, Codex o cualquier cliente MCP: informes, campañas, grupos de anuncios, palabras clave y negativas, creatividades y anuncios, y las sugerencias de palabras clave de Apple. Todo lo que crea se crea en pausa.

¿Por qué no aparece el campo Public Key en la página de API de Apple Ads?

Porque has iniciado sesión como Account Admin. Apple solo muestra ese campo a un usuario con un rol de API. Un administrador ve en su lugar una tabla “Manage API Access” con proveedores externos de servicios, sin ningún campo de clave en la página. Invítate como API Account Manager en Account Settings › User Management, inicia sesión como ese usuario, y el campo aparecerá.

¿Qué rol de Apple Ads necesito?

API Account Manager si quieres que Hermoso cree campañas, grupos de anuncios y palabras clave. Apple lo describe como “acceso de lectura y escritura a todos los grupos de campañas para la gestión de API”. API Account Read Only basta si solo quieres informes. Los otros cuatro roles que ofrece Apple (Account Admin, Account Finance, Account Read Only y Limited Access) no pueden crear credenciales de API en absoluto.

¿Tengo que ejecutar openssl?

No. Las instrucciones de Apple te dan dos comandos de openssl; Hermoso genera el par de claves EC P-256 por ti y te muestra solo la mitad pública. La mitad privada es la que firma tus peticiones, y nunca la ves, la pegas ni la guardas. Si ya tienes una clave de otra herramienta, puedes traerla.

¿Conectar Apple Ads cuesta algo o arriesga el gasto?

No. Las lecturas no tienen coste y todo objeto que cree Hermoso se crea en PAUSA, sin excepciones. Activar un objeto es el único interruptor que pone en marcha el gasto real, y exige una confirmación explícita.

¿Qué son clientId, teamId y keyId?

Los tres identificadores que Apple muestra encima del campo Public Key una vez que guardas tu clave. Identifican tu usuario de API ante Apple; la clave privada demuestra que eres tú. Pega los tres de vuelta en Hermoso y la conexión queda terminada.

¿Puede una conexión cubrir varias organizaciones de Apple Ads?

Una conexión queda fijada a la única organización que eliges al crearla. Apple trata un orgId un poco como un grupo de campañas, así que un solo inicio de sesión puede cubrir varias. Una agencia con un cliente por organización conecta cada una en su propio perfil de Hermoso.

¿Tengo que rotar la clave cada 180 días?

No. Apple limita un secreto de cliente a 180 días, por eso sus instrucciones te piden apuntar una rotación. Hermoso guarda la clave privada y crea un secreto nuevo de vida corta en cada intercambio de token, así que no hay nada guardado en un archivo de configuración que pueda caducar.

¿Puedo exportar datos de Apple Search Ads a Google Sheets o Looker Studio?

Sí. Conecta Google Drive junto a Apple Ads y tu agente escribe el informe en una hoja de Google con create_sheet o append_to_sheet. Hermoso no tiene un conector nativo de Looker Studio; Looker Studio lee esa hoja con su propio conector de Google Sheets.

¿Puedo obtener datos de Apple Search Ads en JSON?

Sí. Llama a POST /v1/tools/apple_ads_report en la API de Hermoso con una clave de API y lee data.rows, o ejecuta hermoso call apple_ads_report con --structured desde la CLI.