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 práticos de marketing 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 e LinkedIn, criar planos de campanha e fazer alterações revisáveis.

Cada habilidade é construída de forma aberta como um SKILL.md legível, com referências de apoio, scripts e avaliações quando necessário. Inspecione, adapte ou contribua com um fluxo de trabalho melhor.

O que seu agente pode fazer

Área	Exemplos
SEO	Auditorias completas de site e páginas, 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	Melhorar o conteúdo para citação e visibilidade no ChatGPT, Perplexity, Gemini, Claude e Google AI Overviews
Mídia paga	Planejar, revisar e otimizar campanhas multicanais com orçamentos, medição e limites de aprovação explícitos
Google Ads	Auditar contas, analisar termos de pesquisa, gerenciar palavras-chave e orçamentos, escrever textos de RSA, planejar ativos e diagnosticar páginas de destino
Meta Ads	Revisar o desempenho do Facebook e Instagram, diagnosticar fadiga criativa, avaliar públicos e criar briefings criativos baseados em evidências
X Ads	Analisar campanhas e itens de linha, revisar o desempenho de conversões, gerenciar segmentação e criativos e executar alterações aprovadas
LinkedIn Ads	Conectar mídia B2B à qualidade de leads, analisar grupos de campanhas e campanhas e gerenciar segmentação, criativos, conversões e leads
Analytics	Consultar dados ao vivo do GA4 e Search Console, comparar períodos completos, inspecionar URLs, gerenciar sitemaps e atualizar a configuração de medição suportada
Conteúdo	Transformar demanda de pesquisa em planos editoriais, briefings, artigos, páginas de destino, metadados e dados estruturados

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

Início rápido

Claude Code

Instale o plugin NotFair a partir do seu marketplace:

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

Em seguida, 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-me as oportunidades mais seguras para melhorar o ROAS.

Cursor

Instale o NotFair no marketplace de plugins do Cursor. O plugin carrega as habilidades de marketing de código aberto deste repositório e registra uma conexão MCP hospedada do NotFair. Conclua o fluxo OAuth no navegador quando o Cursor solicitar e, em seguida, 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 de plugins locais 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 sua listagem. A raiz plugin.json e mcp.json 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 MCP universal do NotFair. Execute /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 MCP do NotFair e abre seu fluxo OAuth. Se você preferir um checkout local no workspace, clone o repositório e abra-o como um workspace; 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 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 uma função definida, 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 ou LinkedIn Ads 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 mudanças 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 dentro de um runtime de agente.
• Forkável: tudo é licenciado sob MIT, para que as equipes possam 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 pesquisa.
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 pesquisa.
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 pesquisa 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 modeladas úteis em escala com salvaguardas 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 pesquisa 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	Conecta 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 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-tiktok	Cria planos de campanha no TikTok, briefings de criadores e experimentos de formato curto.
paid-ads-amazon	Planeja e revisa o Amazon Ads com salvaguardas de ACoS conscientes de margem.
paid-ads-chatgpt	Projeta experimentos limitados de 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, callouts, 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 escala.
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 sitemaps aprovados.

Revisão entre modelos e manutenção

Habilidade	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 habilidades funcionam inteiramente a partir de um repositório, URL ou exportação fornecida. A análise de contas ao vivo usa um MCP universal do NotFair conectado via OAuth. O plugin registra essa conexão automaticamente. Durante a implementação gradual começando pelo Google, os workspaces habilitados conectam o Google Ads no mesmo fluxo OAuth; todas as outras plataformas ficam disponíveis após serem conectadas no workspace NotFair selecionado.

Fonte de dados	Usado para	Conexão
Google Search Console	Desempenho de pesquisa, consultas, páginas, indexação, inspeção de URL e sitemaps	NotFair MCP universal via ferramentas search_console_
Google Analytics 4	Aquisição, engajamento, páginas de destino, eventos, conversões, tempo real e configuração de medição	NotFair MCP universal via ferramentas google_analytics_
Google Ads	Desempenho de campanhas, termos de pesquisa, lances, orçamentos, palavras-chave e histórico de alterações	NotFair MCP universal via ferramentas google_ads_
Meta Ads	Campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e insights	NotFair MCP universal via ferramentas meta_ads_
X Ads	Campanhas, itens de linha, desempenho, segmentação, posts promovidos, públicos e mutações aprovadas	NotFair MCP universal via ferramentas x_ads_
LinkedIn Ads	Grupos de campanhas, campanhas, criativos, análises, segmentação, conversões e leads	NotFair MCP universal via ferramentas linkedin_ads_
Plataformas CMS	Revisão de conteúdo e campos de SEO em WordPress, Strapi, Contentful ou Ghost	API da plataforma ou MCP compatível
Google Gemini	Revisão entre modelos	Chave de API do Gemini

Google Ads, Meta Ads, X Ads e LinkedIn Ads usam ferramentas de mutação explícitas e limitadas. Search Console e GA4 também expõem gravações de configuração restritas com regras de aprovação e leitura de volta. TikTok, Amazon e ChatGPT Ads permanecem como fluxos de trabalho de planejamento ou revisão de exportação, a menos que a sessão atual do agente exponha um conector verificado.

Privacidade e suporte

• Política de Privacidade
• 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, ~~search-console, ~~google-analytics e ~~cms. 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 específico.

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
├── 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 é 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.

Opcional: execute metas de marketing recorrentes localmente

Este repositório também inclui um aplicativo local para transformar um resultado de marketing mensurável em um loop de agente recorrente. Ele é um complemento à biblioteca de skills, não um requisito para usá-las.

npx notfair@latest

O aplicativo roda na sua máquina com Codex ou Claude Code, armazena o estado localmente e pode acompanhar uma métrica verificada ao longo do tempo. Consulte notfair/README.md para detalhes de configuração, arquitetura e operação.

Contribuindo

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

seo/your-skill-name/
├── SKILL.md          # required 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 de marketing clara.
2. Use instruções imperativas e testáveis em SKILL.md.
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. Para contribuições ao aplicativo, consulte notfair/CONTRIBUTING.md e notfair/ARCHITECTURE.md.

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