NotFair Google Ads MCP
MCP de Google Ads alojado con 117 herramientas para auditar, optimizar y cambiar campañas de forma segura desde Claude, ChatGPT, Codex, Cursor y otros clientes de IA.
Documentación
Plugin NotFair
Habilidades de SEO, GEO y marketing de código abierto para agentes de IA.
El Plugin NotFair ofrece a Claude Code, Codex, Hermes y otros agentes compatibles flujos de trabajo de marketing prácticos que pueden seguir, no otra colección genérica de indicaciones. Úsalo para auditar un sitio, investigar una caída de tráfico, analizar GA4 y Search Console, encontrar gasto publicitario desperdiciado en Google, Meta, X y LinkedIn, crear planes de campaña y realizar cambios revisables.
Cada habilidad se construye de forma abierta como un SKILL.md legible, con referencias de apoyo, scripts y evaluaciones cuando sea necesario. Inspecciónalo, adáptalo o contribuye con un mejor flujo de trabajo.
Lo que tu agente puede hacer
| Área | Ejemplos |
|---|---|
| SEO | Auditorías de sitio completo y de páginas, investigación de palabras clave, planificación de contenido, SEO técnico, schema, SEO local, SEO internacional, SEO de comercio electrónico y monitoreo de regresiones |
| GEO / AEO | Mejorar contenido para citación y visibilidad en ChatGPT, Perplexity, Gemini, Claude y Google AI Overviews |
| Medios pagados | Planificar, revisar y optimizar campañas multicanal con presupuestos, medición y límites de aprobación explícitos |
| Google Ads | Auditar cuentas, analizar términos de búsqueda, gestionar palabras clave y presupuestos, redactar copys de RSA, planificar activos y diagnosticar páginas de destino |
| Meta Ads | Revisar el rendimiento de Facebook e Instagram, diagnosticar fatiga creativa, evaluar audiencias y crear briefs creativos basados en evidencia |
| X Ads | Analizar campañas y elementos de línea, revisar el rendimiento de conversiones, gestionar segmentación y creatividad, y ejecutar cambios aprobados |
| LinkedIn Ads | Conectar medios B2B con la calidad de leads, analizar grupos de campañas y campañas, y gestionar segmentación, creatividad, conversiones y leads |
| Analítica | Consultar datos en vivo de GA4 y Search Console, comparar períodos completos, inspeccionar URLs, gestionar sitemaps y actualizar la configuración de medición compatible |
| Contenido | Convertir la demanda de búsqueda en planes editoriales, briefs, artículos, páginas de destino, metadatos y datos estructurados |
El Plugin NotFair incluye actualmente 45 habilidades en SEO, GEO, medios pagados, plataformas publicitarias, analítica y revisión entre modelos.
Inicio rápido
Claude Code
Instala el plugin NotFair desde su marketplace:
/plugin marketplace add nowork-studio/notfair-plugin
/plugin install notfair@nowork-studio
Luego solicita el flujo de trabajo que necesites:
/notfair:seo-analysis
/notfair:geo-optimizer
/notfair:google-ads-audit
/notfair:meta-ads-creative
/notfair:paid-ads-x
/notfair:google-analytics
/notfair:search-console
También puedes usar lenguaje natural:
Audita mi sitio y dime por qué cayó el tráfico orgánico.
Encuentra páginas que podrían obtener citas en respuestas de IA.
Revisa el gasto publicitario del mes pasado y muéstrame las oportunidades más seguras para mejorar el ROAS.
Cursor
Instala NotFair desde el marketplace de plugins de Cursor. El plugin carga las habilidades de marketing de código abierto de este repositorio y registra una conexión MCP de NotFair alojada. Completa el flujo OAuth del navegador cuando Cursor te lo solicite, luego pídele a Cursor que audite una cuenta de anuncios, analice GA4 o Search Console, o ejecute uno de los flujos de trabajo de SEO y GEO que se enumeran a continuación.
Para pruebas locales antes de que la lista del marketplace esté disponible, clona este repositorio en el directorio de plugins locales de Cursor:
git clone https://github.com/nowork-studio/notfair-plugin.git ~/.cursor/plugins/local/notfair
Reinicia Cursor después de instalar o actualizar el plugin local.
Kiro Powers
Instala el repositorio público como un power personalizado desde el panel de Powers de Kiro, o busca NotFair en el registro de Powers después de que su listado sea aprobado. El plugin.json raíz y el mcp.json siguen la especificación de Agent Plugins 1.0.
Gemini CLI
Instala la extensión directamente desde GitHub:
gemini extensions install https://github.com/nowork-studio/notfair-plugin
La extensión carga la guía del repositorio y el MCP universal de NotFair. Ejecuta /mcp auth NotFair en Gemini CLI cuando se solicite autenticación.
Codex, Hermes y otros agentes
Instala el plugin universal de NotFair directamente a través de Codex:
codex plugin marketplace add nowork-studio/notfair-plugin --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair
Codex instala las habilidades, registra una conexión MCP de NotFair y abre su flujo OAuth. Si prefieres una copia local del espacio de trabajo, clona el repositorio y ábrelo como espacio de trabajo; AGENTS.md asigna solicitudes de marketing a la habilidad correcta.
git clone https://github.com/nowork-studio/notfair-plugin.git
cd notfair-plugin
Si el marketplace de nowork-studio ya está configurado, actualízalo en su lugar:
codex plugin marketplace upgrade nowork-studio --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair
Para la configuración específica del host, dale a tu agente INSTALL_FOR_AGENTS.md, o pega:
Retrieve and follow the instructions at:
https://raw.githubusercontent.com/nowork-studio/notfair-plugin/main/INSTALL_FOR_AGENTS.md
¿Por qué habilidades en lugar de un agente de marketing gigante?
El trabajo de marketing se vuelve poco confiable cuando cada solicitud pasa por la misma indicación vaga. El Plugin NotFair divide el trabajo en procedimientos enfocados y comprobables.
- Especializado: cada habilidad tiene un trabajo definido, entradas requeridas, reglas de decisión y formato de salida.
- Basado en evidencia: los flujos de trabajo con datos en vivo usan Search Console, Google Analytics, Google Ads, Meta Ads, X Ads o LinkedIn Ads en lugar de adivinar a partir de mejores prácticas genéricas.
- Seguro por diseño: la revisión de solo lectura precede a la mutación, los cambios en medios pagados permanecen explícitos y las capacidades no compatibles nunca se implican.
- Independiente del host: las habilidades canónicas son archivos simples, no lógica atrapada dentro de un runtime de agente.
- Bifurcable: todo está bajo licencia MIT, por lo que los equipos pueden revisar y adaptar los flujos de trabajo a sus propios estándares.
Catálogo de habilidades
SEO y GEO
| Habilidad | Qué hace |
|---|---|
seo-analysis | Audita un sitio completo con Search Console y datos de rastreo, luego prioriza las correcciones de mayor impacto. |
seo-page | Realiza una auditoría profunda de una URL para intención, contenido, estructura y SEO en la página. |
content-writer | Escribe o mejora artículos, páginas de destino y páginas de servicios basados en búsqueda. |
content-planner | Convierte oportunidades de Search Console en un calendario editorial priorizado y fechado. |
keyword-research | Construye un universo de palabras clave, clasifica la intención y organiza clústeres de temas. |
meta-tags-optimizer | Mejora títulos, meta descripciones, etiquetas Open Graph y el potencial de clics en SERP. |
schema-markup-generator | Crea y valida datos estructurados JSON-LD. |
broken-link-checker | Encuentra enlaces internos y externos rotos e informa problemas de salud del sitio. |
geo-optimizer | Audita y reescribe contenido para citación en motores de búsqueda y respuesta de IA. |
local-seo | Revisa Google Business Profile, páginas locales, consistencia de NAP, reseñas y schema local. |
hreflang-international | Diagnostica problemas de hreflang, canónicos, idioma y segmentación regional. |
sitemap-audit | Verifica la estructura del sitemap XML, frescura, cobertura y validez de URLs. |
image-seo | Revisa texto alternativo, formatos, compresión, imágenes responsivas, CLS y descubrimiento de imágenes. |
ecommerce-seo | Audita páginas de producto, páginas de categoría, variantes, navegación facetada y schema de producto. |
programmatic-seo | Planifica páginas plantilladas útiles a escala con salvaguardas de demanda, unicidad e indexación. |
competitor-pages | Compara páginas de clasificación y produce un brief práctico de SERP. |
sxo | Conecta la visibilidad de búsqueda y el CTR de SERP con la experiencia de conversión posterior al clic. |
seo-drift | Crea una línea base y detecta regresiones de clasificación, metadatos, canónicos e indexación. |
backlink-audit | Revisa dominios de referencia, texto ancla, riesgo de enlaces y oportunidades de enlaces internos. |
setup-cms | Conecta WordPress, Strapi, Contentful o Ghost. |
Medios pagados
| Habilidad | Qué hace |
|---|---|
paid-ads | Enruta preguntas amplias de medios pagados al canal y flujo de trabajo correctos. |
paid-ads-setup | Conecta cuentas y captura contexto de negocio, economía, seguimiento y presupuesto. |
paid-ads-launch | Produce un plan de campaña o experimento multicanal revisable antes de que comience el gasto. |
paid-ads-review | Crea cuadros de mando semanales o mensuales comparables y verifica la salud del seguimiento. |
paid-ads-optimize | Encuentra problemas de desperdicio y ritmo, luego propone cambios limitados y reversibles. |
paid-ads-creative | Desarrolla conceptos multicanal, registros de afirmaciones, hipótesis de fatiga y briefs de prueba. |
paid-ads-x | Audita y opera campañas de X Ads conectadas, elementos de línea, segmentación, creatividad, audiencias y presupuestos. |
paid-ads-linkedin | Audita y opera LinkedIn Ads conectados en torno a resultados de pipeline calificados. |
paid-ads-tiktok | Crea planes de campaña de TikTok, briefs de creadores y experimentos de formato corto. |
paid-ads-amazon | Planifica y revisa Amazon Ads con salvaguardas de ACoS conscientes del margen. |
paid-ads-chatgpt | Diseña experimentos limitados de ChatGPT Ads o revisa exportaciones verificadas. |
paid-ads-integrations | Verifica el acceso a conectores, cuentas y herramientas antes de prometer una capacidad. |
paid-ads-guide | Explica instalación, plataformas compatibles, límites y solución de problemas. |
Google Ads
| Habilidad | Qué hace |
|---|---|
google-ads-audit | Puntúa la salud de la cuenta, valida el seguimiento y encuentra gasto desperdiciado. |
google-ads | Revisa el rendimiento y gestiona palabras clave, ofertas, presupuestos, negativas y campañas compatibles. |
google-ads-copy | Escribe titulares y descripciones de RSA compatibles con variantes de prueba. |
google-ads-assets | Planifica enlaces de sitio, destacados, fragmentos, activos de imagen y briefs de Performance Max. |
google-ads-landing | Diagnostica la relevancia de palabra clave a anuncio a página y la calidad de la página de destino. |
Meta Ads
| Habilidad | Qué hace |
|---|---|
meta-ads-audit | Audita seguimiento, estructura, salud creativa, audiencias, eficiencia de gasto y preparación para escalar. |
meta-ads | Revisa el rendimiento de Facebook e Instagram y ejecuta operaciones de campaña compatibles. |
meta-ads-creative | Produce conceptos basados en evidencia, ángulos de copy, briefs de UGC y experimentos de actualización. |
Analítica
| Habilidad | Qué hace |
|---|---|
google-analytics | Analiza adquisición, participación, páginas, eventos y conversiones de GA4 en vivo y gestiona de forma segura la configuración de medición compatible. |
search-console | Analiza consultas y páginas de Search Console en vivo, inspecciona URLs y gestiona envíos de sitemaps aprobados. |
Revisión entre modelos y mantenimiento
| Habilidad | Qué hace |
|---|---|
gemini | Usa Google Gemini para una segunda opinión, desafío adversarial o consulta abierta. |
upgrade | Actualiza un plugin NotFair instalado y resume lo que cambió. |
Datos en vivo e integraciones
Algunas habilidades funcionan completamente desde un repositorio, URL o exportación proporcionada. El análisis de cuentas en vivo usa un MCP universal de NotFair conectado por OAuth. El plugin registra esa conexión automáticamente. Durante el despliegue escalonado primero en Google, los espacios de trabajo habilitados conectan Google Ads en el mismo flujo de OAuth; cada otra plataforma estará disponible después de conectarse en el espacio de trabajo de NotFair seleccionado.
| Fuente de datos | Uso | Conexión |
|---|---|---|
| Google Search Console | Rendimiento de búsqueda, consultas, páginas, indexación, inspección de URL y mapas del sitio | NotFair MCP universal mediante herramientas search_console_ |
| Google Analytics 4 | Adquisición, interacción, páginas de destino, eventos, conversiones, tiempo real y configuración de medición | NotFair MCP universal mediante herramientas google_analytics_ |
| Google Ads | Rendimiento de campañas, términos de búsqueda, ofertas, presupuestos, palabras clave e historial de cambios | NotFair MCP universal mediante herramientas google_ads_ |
| Meta Ads | Campañas de Facebook e Instagram, conjuntos de anuncios, creatividades e información | NotFair MCP universal mediante herramientas meta_ads_ |
| X Ads | Campañas, elementos de línea, rendimiento, segmentación, publicaciones promocionadas, audiencias y mutaciones aprobadas | NotFair MCP universal mediante herramientas x_ads_ |
| LinkedIn Ads | Grupos de campañas, campañas, creatividades, análisis, segmentación, conversiones y clientes potenciales | NotFair MCP universal mediante herramientas linkedin_ads_ |
| Plataformas CMS | Revisión de contenido y campos SEO en WordPress, Strapi, Contentful o Ghost | API de la plataforma o MCP compatible |
| Google Gemini | Revisión entre modelos | Clave de API de Gemini |
Google Ads, Meta Ads, X Ads y LinkedIn Ads utilizan herramientas de mutación explícitas y acotadas. Search Console y GA4 también exponen escrituras de configuración limitadas con reglas de aprobación y relectura. TikTok, Amazon y ChatGPT Ads permanecen como flujos de planificación o revisión de exportación, a menos que la sesión actual del agente exponga un conector verificado.
Privacidad y soporte
Dentro de una habilidad, los conectores utilizan marcadores de posición independientes de la herramienta, como ~~google-ads, ~~meta-ads, ~~x-ads, ~~linkedin-ads, ~~search-console, ~~google-analytics y ~~cms. El agente resuelve cada marcador de posición a una herramienta compatible disponible en la sesión actual, de modo que el flujo de trabajo no esté vinculado a un único espacio de nombres de MCP.
Cómo está organizado el repositorio
notfair-plugin/
├── AGENTS.md # intent-to-skill resolver for AI agents
├── .claude-plugin/ # Claude Code plugin manifest
├── paid-ads/ # cross-channel planning, review, optimization
├── google-ads/ # audit, management, copy, assets, landing pages
├── meta-ads/ # audit, management, creative
├── analytics/ # Google Analytics and Search Console MCP workflows
├── seo/ # SEO, GEO, content, and technical-search skills
├── gemini/ # cross-model review
├── test/ # unit and LLM-judge evals
└── notfair/ # optional local goal-loop application
AGENTS.md es el punto de entrada universal. Asigna la intención del usuario al SKILL.md canónico y documenta la dependencia externa que requiere cada flujo de trabajo.
Opcional: ejecutar objetivos de marketing recurrentes localmente
Este repositorio también incluye una aplicación local para convertir un resultado de marketing medible en un bucle de agente recurrente. Es un complemento de la biblioteca de habilidades, no un requisito para usarlas.
npx notfair@latest
La aplicación se ejecuta en tu máquina con Codex o Claude Code, almacena el estado localmente y puede rastrear una métrica verificada a lo largo del tiempo. Consulta notfair/README.md para obtener detalles de configuración, arquitectura y operación.
Contribuciones
Cada habilidad vive en su propia carpeta de categoría:
seo/your-skill-name/
├── SKILL.md # required instructions and frontmatter
├── references/ # optional supporting knowledge
└── scripts/ # optional deterministic tooling
Al agregar o cambiar una habilidad:
- Mantén el flujo de trabajo enfocado en una tarea de marketing clara.
- Usa instrucciones imperativas y comprobables en
SKILL.md. - Agrega o actualiza la cobertura de evaluación.
- Actualiza
AGENTS.md, el manifiesto del plugin,VERSIONyCHANGELOG.md.
Abre una solicitud de extracción con una habilidad o una mejora coherente. Para contribuciones de aplicaciones, consulta notfair/CONTRIBUTING.md y notfair/ARCHITECTURE.md.
Comunidad
- Únete al Discord de NotFair
- Abre un problema
- Marca el repositorio con una estrella si estos flujos de trabajo hacen que tu agente sea más útil