NotFair Google Ads MCP

Plugin NotFair

Habilidades de SEO, GEO e marketing de código aberto para agentes de IA.

O Plugin NotFair oferece ao Claude Code, Codex, Hermes e outros agentes compatíveis fluxos de trabalho de marketing práticos que eles podem seguir — não apenas mais uma coleção genérica de prompts. Use-o para auditar um site, investigar uma queda de tráfego, analisar GA4 e Search Console, encontrar desperdício de gastos com anúncios no Google, Meta, X, LinkedIn, Reddit e TikTok, operar contas conectadas do WordPress e GoHighLevel, criar planos de campanha e fazer alterações revisáveis.

Cada habilidade tem um ponto de entrada skills/<name>/SKILL.md detectável. Ela carrega um WORKFLOW.md legível na pasta da categoria, com referências de apoio, scripts e avaliações quando necessário. Inspecione-a, adapte-a ou contribua com um fluxo de trabalho melhor.

O que seu agente pode fazer

Área	Exemplos
SEO	Auditorias completas de site e página, pesquisa de palavras-chave, planejamento de conteúdo, SEO técnico, schema, SEO local, SEO internacional, SEO para e-commerce e monitoramento de regressões
GEO / AEO	Melhore o conteúdo para citação e visibilidade no ChatGPT, Perplexity, Gemini, Claude e Google AI Overviews
Mídia paga	Planeje, revise e otimize campanhas multicanais com orçamentos, medição e limites de aprovação explícitos
Google Ads	Audite contas, analise termos de pesquisa, gerencie palavras-chave e orçamentos, escreva textos de RSA, planeje ativos e diagnostique páginas de destino
Meta Ads	Revise o desempenho do Facebook e Instagram, diagnostique fadiga criativa, avalie públicos e crie briefings criativos baseados em evidências
X Ads	Analise campanhas e itens de linha, revise o desempenho de conversões, gerencie segmentação e criativos e execute alterações aprovadas
LinkedIn Ads	Conecte mídia B2B à qualidade de leads, analise grupos de campanha e campanhas e gerencie segmentação, criativos, conversões e leads
Reddit Ads	Analise campanhas, grupos de anúncios e anúncios, revise conversões e públicos e execute alterações aprovadas no Reddit Ads
TikTok Ads	Analise anunciantes conectados do TikTok, revise o desempenho de entrega e criativos e execute alterações aprovadas na campanha
WordPress	Leia e atualize conteúdo, mídia, comentários, design, configurações, plugins e alterações aprovadas no site conectado do WordPress
GoHighLevel	Leia contatos, conversas, oportunidades e calendários e faça apenas alterações de CRM explicitamente solicitadas
Analytics	Consulte dados ao vivo do GA4 e Search Console, compare períodos completos, inspecione URLs, gerencie sitemaps e atualize a configuração de medição suportada
Conteúdo	Transforme a demanda de pesquisa em planos editoriais, briefings, artigos, páginas de destino, metadados e dados estruturados

O Plugin NotFair atualmente oferece 48 habilidades em SEO, GEO, mídia paga, plataformas de publicidade, analytics, WordPress, CRM e revisão entre modelos.

Início rápido

Claude Code

Instale o plugin NotFair pelo seu marketplace:

/plugin marketplace add nowork-studio/notfair-plugin
/plugin install notfair@nowork-studio

Depois, peça o fluxo de trabalho que você precisa:

/notfair:seo-analysis
/notfair:geo-optimizer
/notfair:google-ads-audit
/notfair:meta-ads-creative
/notfair:paid-ads-x
/notfair:google-analytics
/notfair:search-console

Você também pode usar linguagem natural:

Audite meu site e me diga por que o tráfego orgânico caiu.

Encontre páginas que poderiam ganhar citações em respostas de IA.

Revise os gastos com anúncios do mês passado e mostre as oportunidades mais seguras para melhorar o ROAS.

Cursor

Instale o NotFair pelo marketplace de plugins do Cursor. O plugin carrega as habilidades de marketing de código aberto deste repositório e registra uma conexão hospedada do NotFair MCP. Conclua o fluxo OAuth no navegador quando o Cursor solicitar e peça ao Cursor para auditar uma conta de anúncios, analisar GA4 ou Search Console ou executar um dos fluxos de trabalho de SEO e GEO listados abaixo.

Para testes locais antes da listagem no marketplace estar disponível, clone este repositório no diretório local de plugins do Cursor:

git clone https://github.com/nowork-studio/notfair-plugin.git ~/.cursor/plugins/local/notfair

Reinicie o Cursor após instalar ou atualizar o plugin local.

Kiro Powers

Instale o repositório público como um power personalizado no painel de Powers do Kiro, ou encontre o NotFair no registro de Powers após a aprovação da listagem. O plugin.json e o mcp.json raiz seguem a especificação Agent Plugins 1.0.

Gemini CLI

Instale a extensão diretamente do GitHub:

gemini extensions install https://github.com/nowork-studio/notfair-plugin

A extensão carrega as orientações do repositório e o NotFair MCP universal. Execute o /mcp auth NotFair no Gemini CLI quando a autenticação for solicitada.

Codex, Hermes e outros agentes

Instale o plugin universal NotFair diretamente pelo Codex:

codex plugin marketplace add nowork-studio/notfair-plugin --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

O Codex instala as habilidades, registra uma conexão NotFair MCP e abre o fluxo OAuth. Se você preferir um checkout local no workspace, clone o repositório e abra-o como workspace; o AGENTS.md mapeia solicitações de marketing para a habilidade certa.

git clone https://github.com/nowork-studio/notfair-plugin.git
cd notfair-plugin

Se o marketplace nowork-studio já estiver configurado, atualize-o:

codex plugin marketplace upgrade nowork-studio --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

Para configuração específica do host, forneça ao seu agente o INSTALL_FOR_AGENTS.md ou cole:

Retrieve and follow the instructions at:
https://raw.githubusercontent.com/nowork-studio/notfair-plugin/main/INSTALL_FOR_AGENTS.md

Por que habilidades em vez de um agente de marketing gigante?

O trabalho de marketing fica pouco confiável quando cada solicitação passa pelo mesmo prompt vago. O Plugin NotFair divide o trabalho em procedimentos focados e testáveis.

• Especializado: cada habilidade tem um trabalho definido, entradas obrigatórias, regras de decisão e formato de saída.
• Baseado em evidências: fluxos de trabalho com dados ao vivo usam Search Console, Google Analytics, Google Ads, Meta Ads, X Ads, LinkedIn Ads, Reddit Ads, TikTok Ads, WordPress ou GoHighLevel em vez de adivinhar com base em práticas recomendadas genéricas.
• Seguro por design: a revisão somente leitura vem antes da mutação, as alterações em mídia paga permanecem explícitas e capacidades não suportadas nunca são sugeridas.
• Independente de host: as habilidades canônicas são arquivos simples, não lógica presa em um runtime de agente.
• Forkável: tudo é licenciado sob MIT, então as equipes podem revisar e adaptar os fluxos de trabalho aos seus próprios padrões.

Catálogo de habilidades

SEO e GEO

Habilidade	O que faz
seo-analysis	Audita um site completo com Search Console e dados de rastreamento e prioriza as correções de maior impacto.
seo-page	Realiza uma auditoria profunda de uma URL para intenção, conteúdo, estrutura e SEO on-page.
content-writer	Escreve ou melhora artigos, páginas de destino e páginas de serviço orientados por busca.
content-planner	Transforma oportunidades do Search Console em um calendário editorial priorizado e datado.
keyword-research	Constrói um universo de palavras-chave, classifica a intenção e organiza clusters de tópicos.
meta-tags-optimizer	Melhora títulos, meta descrições, tags Open Graph e o potencial de CTR nos resultados de busca.
schema-markup-generator	Cria e valida dados estruturados JSON-LD.
broken-link-checker	Encontra links internos e externos quebrados e relata problemas de saúde do site.
geo-optimizer	Audita e reescreve conteúdo para citação em mecanismos de busca e resposta com IA.
local-seo	Revisa o Google Business Profile, páginas locais, consistência de NAP, avaliações e schema local.
hreflang-international	Diagnostica problemas de hreflang, canonical, idioma e segmentação regional.
sitemap-audit	Verifica a estrutura do sitemap XML, atualização, cobertura e validade das URLs.
image-seo	Revisa texto alternativo, formatos, compressão, imagens responsivas, CLS e descoberta de imagens.
ecommerce-seo	Audita páginas de produto, páginas de categoria, variantes, navegação facetada e schema de produto.
programmatic-seo	Planeja páginas de modelo úteis em escala com diretrizes de demanda, exclusividade e indexação.
competitor-pages	Compara páginas ranqueadas e produz um briefing prático de SERP.
sxo	Conecta a visibilidade de busca e o CTR da SERP à experiência de conversão pós-clique.
seo-drift	Cria uma linha de base e detecta regressões de ranqueamento, metadados, canonical e indexação.
backlink-audit	Revisa domínios de referência, texto âncora, risco de links e oportunidades de links internos.
setup-cms	Configuração local de Application-Password / .env.local para scripts de SEO no WordPress, Strapi, Contentful ou Ghost.

Mídia paga

Habilidade	O que faz
paid-ads	Direciona perguntas amplas de mídia paga para o canal e fluxo de trabalho certos.
paid-ads-setup	Conecta contas e captura contexto de negócios, economia, rastreamento e orçamento.
paid-ads-launch	Produz um plano de campanha ou experimento multicanal revisável antes do início dos gastos.
paid-ads-review	Cria scorecards semanais ou mensais comparáveis e verifica a saúde do rastreamento.
paid-ads-optimize	Encontra desperdício e problemas de ritmo de gastos e propõe mudanças estreitas e reversíveis.
paid-ads-creative	Desenvolve conceitos multicanais, registros de alegações, hipóteses de fadiga e briefings de teste.
paid-ads-x	Audita e opera campanhas conectadas do X Ads, itens de linha, segmentação, criativos, públicos e orçamentos.
paid-ads-linkedin	Audita e opera o LinkedIn Ads conectado em torno de resultados qualificados de pipeline.
paid-ads-reddit	Audita e opera campanhas conectadas do Reddit Ads, grupos de anúncios, anúncios, públicos, pixels e orçamentos.
paid-ads-tiktok	Audita e opera a entrega, criativos, segmentação e orçamentos do TikTok Ads conectado.
paid-ads-amazon	Planeja e revisa o Amazon Ads com diretrizes de ACoS conscientes de margem.
paid-ads-chatgpt	Projeta experimentos limitados do ChatGPT Ads ou revisa exportações verificadas.
paid-ads-integrations	Verifica o acesso a conectores, contas e ferramentas antes de prometer uma capacidade.
paid-ads-guide	Explica instalação, plataformas suportadas, limites e solução de problemas.

Google Ads

Habilidade	O que faz
google-ads-audit	Pontua a saúde da conta, valida o rastreamento e encontra desperdício de gastos.
google-ads	Revisa o desempenho e gerencia palavras-chave, lances, orçamentos, negativas e campanhas suportados.
google-ads-copy	Escreve títulos e descrições de RSA em conformidade com variantes de teste.
google-ads-assets	Planeja sitelinks, frases de destaque, snippets, ativos de imagem e briefings de Performance Max.
google-ads-landing	Diagnostica a relevância palavra-chave-anúncio-página e a qualidade da página de destino.

Meta Ads

Habilidade	O que faz
meta-ads-audit	Audita rastreamento, estrutura, saúde criativa, públicos, eficiência de gastos e prontidão para escalar.
meta-ads	Revisa o desempenho do Facebook e Instagram e executa operações de campanha suportadas.
meta-ads-creative	Produz conceitos baseados em evidências, ângulos de copy, briefings de UGC e experimentos de atualização.

Analytics

Habilidade	O que faz
google-analytics	Analisa aquisição, engajamento, páginas, eventos e conversões ao vivo do GA4 e gerencia com segurança a configuração de medição suportada.
search-console	Analisa consultas e páginas ao vivo do Search Console, inspeciona URLs e gerencia envios de sitemap aprovados.

WordPress

Habilidade	O que faz
wordpress	Opera sites conectados do WordPress: conteúdo, mídia, comentários, design, configurações, plugins, temas e alterações aprovadas de HTML ou admin.

CRM

Skill	O que faz
gohighlevel	Opera contatos, conversas, oportunidades, calendários e outras alterações aprovadas de CRM conectados ao GoHighLevel.

Revisão e manutenção entre modelos

Skill	O que faz
gemini	Usa o Google Gemini para uma segunda opinião, desafio adversarial ou consulta aberta.
upgrade	Atualiza um plugin NotFair instalado e resume o que mudou.

Dados ao vivo e integrações

Algumas skills funcionam inteiramente a partir de um repositório, URL ou exportação fornecida. A análise de conta ao vivo usa um MCP NotFair universal conectado via OAuth. O plugin registra exatamente um servidor chamado NotFair, compartilhado por todas as plataformas suportadas.

O agente escolhe ferramentas a partir das instruções e descrições de capacidade do servidor ao vivo. As skills fornecem fluxos de trabalho de marketing e padrões de evidência sem codificar nomes de ferramentas MCP ou sequências de chamadas. Consulte o guia de conexão e atualização para configuração manual e migração de conexões antigas por plataforma. Cada plataforma fica disponível após ser conectada no workspace NotFair selecionado durante o OAuth. Siga qualquer orientação de configuração de conta retornada pelo servidor.

Fonte de dados	Usada para	Conexão
Google Search Console	Desempenho de pesquisa, consultas, páginas, indexação, inspeção de URL e sitemaps	Uma conexão NotFair
Google Analytics 4	Aquisição, engajamento, páginas de destino, eventos, conversões, tempo real e configuração de medição	Uma conexão NotFair
Google Ads	Desempenho de campanhas, termos de pesquisa, lances, orçamentos, palavras-chave e histórico de alterações	Uma conexão NotFair
Meta Ads	Campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e insights	Uma conexão NotFair
X Ads	Campanhas, itens de linha, desempenho, segmentação, posts promovidos, públicos e mutações aprovadas	Uma conexão NotFair
LinkedIn Ads	Grupos de campanhas, campanhas, criativos, análises, segmentação, conversões e leads	Uma conexão NotFair
Reddit Ads	Campanhas, grupos de anúncios, anúncios, relatórios, públicos, pixels, instrumentos de financiamento e mutações aprovadas	Uma conexão NotFair
TikTok Ads	Entrega de anunciantes, relatórios, criativos, segmentação e mutações aprovadas	Uma conexão NotFair
WordPress	Conteúdo do site conectado, mídia, comentários, design, configurações, plugins, temas e mutações aprovadas	Uma conexão NotFair
GoHighLevel	Contatos, conversas, oportunidades, calendários e mutações aprovadas de CRM	Uma conexão NotFair
Outras plataformas CMS	Revisão de conteúdo de script SEO local em Strapi, Contentful ou Ghost	setup-cms Application Password / token de API, não MCP NotFair
Google Gemini	Revisão entre modelos	Chave de API do Gemini

As operações de conta suportadas vêm da conexão ao vivo. As alterações devem permanecer dentro da autorização do usuário e ser verificadas em relação ao estado da conta resultante. Amazon e ChatGPT Ads permanecem fluxos de trabalho de planejamento ou revisão de exportação, a menos que a sessão atual do agente exponha um conector verificado. setup-cms é um assistente local de credenciais de script SEO; o trabalho ao vivo no WordPress usa /notfair:wordpress.

Privacidade e suporte

O plugin se conecta ao endpoint MCP NotFair declarado por meio de OAuth no navegador. Os argumentos de ferramenta solicitados vão para o NotFair e os resultados dos provedores conectados retornam ao seu cliente de IA autorizado. Consulte a política de privacidade para detalhes de armazenamento, retenção e exclusão. Conecte apenas o workspace e as contas de plataforma que você pretende usar.

Fluxos de trabalho locais opcionais executam scripts Python ou shell legíveis. Os rastreadores solicitam as URLs que você fornece; scripts diretos do Search Console usam seu login do Google Cloud explicitamente autorizado; scripts de CMS usam as credenciais do site que você configura por meio de setup-cms. A revisão do Gemini envia o contexto de revisão selecionado para o CLI do Google Gemini após sua configuração de autenticação. Escolha esses fluxos de trabalho explicitamente, mantenha credenciais fora de relatórios e commits e use o MCP OAuth para trabalho ao vivo na plataforma quando disponível. Não há hooks automáticos de plugin ou servidores MCP locais. O visualizador de calendário serve dados locais de planejamento em loopback, e o verificador opcional de atualizações lê o arquivo público de versão do GitHub.

A biblioteca separada de blog Next.js do NotFair agora vive em seu próprio repositório público e é distribuída por meio de seus lançamentos no GitHub. Seu código-fonte e fluxo de trabalho de publicação não estão mais incluídos neste plugin de agente de IA. O aplicativo aposentado NotFair CMO também não está mais incluído.

• Política de Privacidade
• Termos de Serviço
• Suporte de produto e integração
• Suporte e comunidade
• Rastreador de problemas

Dentro de uma skill, os conectores usam placeholders agnósticos de ferramenta, como ~~google-ads, ~~meta-ads, ~~x-ads, ~~linkedin-ads, ~~reddit-ads, ~~tiktok-ads, ~~search-console, ~~google-analytics, ~~wordpress e ~~gohighlevel. O agente resolve cada placeholder para uma ferramenta compatível disponível na sessão atual, de modo que o fluxo de trabalho não fique acoplado a um namespace MCP.

Como o repositório está organizado

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
├── wordpress/                   # live WordPress MCP operator
├── gohighlevel/                 # live GoHighLevel CRM MCP operator
├── seo/                         # SEO, GEO, content, and technical-search skills
├── gemini/                      # cross-model review
├── test/                        # unit and LLM-judge evals
└── skills/                      # shared entry points for every agent host

AGENTS.md é o ponto de entrada universal. Ele mapeia a intenção do usuário para o SKILL.md canônico e documenta a dependência externa que cada fluxo de trabalho exige.

Contribuindo

Cada skill vive em sua própria pasta de categoria:

seo/your-skill-name/
├── WORKFLOW.md       # full instructions and frontmatter
├── references/       # optional supporting knowledge
└── scripts/          # optional deterministic tooling

Ao adicionar ou alterar uma skill:

1. Mantenha o fluxo de trabalho focado em uma tarefa clara de marketing.
2. Use instruções imperativas e testáveis em WORKFLOW.md e mantenha o ponto de entrada em skills/ sincronizado.
3. Adicione ou atualize a cobertura de avaliação.
4. Atualize AGENTS.md, o manifesto do plugin, VERSION e CHANGELOG.md.

Abra um pull request com uma skill ou uma melhoria coerente. Consulte desenvolvimento de plugins para convenções do repositório.

Comunidade

• Junte-se ao Discord do NotFair
• Abra um problema
• Dê uma estrela no repositório se esses fluxos de trabalho tornarem seu agente mais útil

Licença

MIT