Communitygithub.com

unempyd/revenueos

Audite todas as propriedades do Google Search Console de uma vez — classifique todos os sites por cliques e impressões com deltas período a período e diferencie palavras-chave por site para identificar o que está ranqueando novo, subindo, caindo, perdido ou ranqueando bem sem ganhar cliques. Construído para agências e proprietários de vários sites.

O que é revenueos?

Este skill permite auditar todas as propriedades do Google Search Console (GSC) de uma só vez, gerando uma tabela ranqueada de sites por cliques e impressões, com variações período a período, e uma análise de palavras-chave por site para identificar termos novos, em ascensão, em queda, perdidos e com baixo CTR. Ele resolve o problema de quem gerencia múltiplos sites e precisa de uma visão consolidada do portfólio, evitando exportações manuais individuais. É suportado por scripts Python executáveis via linha de comando, com flags como `--days`, `--site`, `--top`, `--limit` e `--min-clicks`. O skill faz paralelismo na coleta de dados, lida automaticamente com a latência de 3 dias do GSC e reporta propriedades com erro 403. Por fim, oferece orientações de interpretação, como priorizar cliques sobre impressões e separar termos de marca dos demais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/unempyd/revenueos/tree/HEAD/skills/creative/gsc-portfolio-audit

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Auditoria de Portfólio GSC

Responde "como está tudo?" em todas as propriedades de uma conta do Search Console — a pergunta que as ferramentas por site não conseguem responder sem dezenas de exportações manuais.

Configuração

Requer um token de atualização OAuth com escopo https://www.googleapis.com/auth/webmasters.readonly:

export GOOGLE_GSC_CLIENT_ID=...      # ou GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=...  # ou GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com"   # opcional, separado por vírgulas
pip install requests

A falha mais comum na configuração é unauthorized_client ao atualizar o token. Isso significa que o token de atualização foi emitido para um cliente OAuth diferente do ID/segredo que você está usando. Contas que adicionaram integrações do Google ao longo do tempo geralmente têm vários clientes; associe o par que gerou o token.

Execução

python3 scripts/audit_gsc.py            # completo: ranqueamento + diff de palavras-chave para os 12 primeiros
python3 scripts/audit_gsc.py portfolio  # apenas a tabela ranqueada
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90  # trimestre contra trimestre

Flags: --days (janela, comparada com a janela imediatamente anterior), --site (repetível), --top, --limit, --min-clicks.

Seções e o que significam

SeçãoLeia como
NOVOconsultas com zero cliques no período anterior. De onde o crescimento realmente está vindo.
SUBINDOsubiu ≥50%. Verifique se a posição também mudou — se não, a demanda aumentou, não o seu ranqueamento.
CAINDOcaiu ≥40% sobre uma base real. A posição diz que tipo: o ranque caiu = perda de posição; o ranque se manteve mas os cliques despencaram = algo pegou os cliques acima de você (AI Overview, um novo recurso SERP, ou a consulta mudou de forma).
PERDIDOranqueava antes, sem dados agora.
LACUNA DE CTR≥1.500 impressões, top 10, abaixo de 2% de CTR. Reescrever título e descrição, os ganhos mais baratos disponíveis.

Interpretação

  • Relate cliques primeiro, impressões depois. Uma propriedade grande pode balançar as impressões do portfólio o suficiente para mascarar que todo o resto cresceu.
  • Separe marca de não-marca. Um site cujo conjunto de palavras-chave é apenas seu próprio nome (ou erros de grafia do concorrente) não tem motor de aquisição, por mais que o número de cliques pareça bom. Diga isso claramente no relatório.
  • Um colapso de site inteiro em seu próprio termo de marca geralmente não é SEO. Verifique a propriedade antes de diagnosticar rankings: whois <dominio> | grep -i "registrar\|updated date" além de verificar se ainda resolve. Domínios expirados, transferidos ou disputados produzem um precipício de ranqueamento que nenhum trabalho de SEO consertará.
  • "novo" na tabela do portfólio significa zero cliques na janela anterior, o que para um site recém-lançado é um lançamento, não uma lacuna de dados.
  • Não pule consultas em idiomas que você não lê. Em sites multimercado, o crescimento geralmente está na cauda longa em idiomas não ingleses; traduza as interessantes em vez de filtrá-las.
  • Uma propriedade retornando 403 é verificada para listagem, mas não para análises de pesquisa. O script a reporta em vez de escondê-la.

Notas

  • Os dados do GSC têm um atraso de cerca de 3 dias; o script compensa isso automaticamente.
  • Ambos os períodos são buscados por propriedade em paralelo, então uma conta de 40 propriedades leva segundos.
  • As linhas de consulta são limitadas a 25.000 por período, bem acima do que qualquer site individual retorna para uma janela de 28 dias.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

unempyd/revenueos

Audit paid-ad landing pages for message match, mobile experience, performance, accessibility, trust, forms, consent, tracking, security, and conversion friction. Use for landing-page audit, post-click experience, LP audit, conversion-rate optimization, form optimization, ad-to-page message match, redirects, blocked navigation, or requests involving private, loopback, link-local, or metadata IP destinations.

unempyd/revenueos

Audit TikTok Ads measurement, Pixel and Events API, mobile-first creative, audiences, Smart+, Shop and commerce campaigns, bidding, budgets, pacing, attribution, and policy. Use for TikTok Ads, TikTok Pixel, Events API, Smart+, TikTok Shop Ads, GMV Max, Spark Ads, or TikTok campaign optimization.

unempyd/revenueos

Use when the user asks to \"pick which social channels to run\", \"should we be on X platform or 小红书\", or \"plan our organic social channel portfolio\"; produces an audience/objective-first portfolio with capability/access matrix, cadence-budget reality check, declared ECHO operating profile, boundary routing, and proposed-state registry events. Not for recording canonical channel facts — use channel-registry. 社媒渠道选择/渠道组合规划/平台能力矩阵/自然社媒

unempyd/revenueos

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

unempyd/revenueos

Use when the user asks to \"pre-launch check the landing page\", \"run a Quality-Score preflight\", or \"verify ad-to-page message match before launch\"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

unempyd/revenueos

Use when the user asks to \"optimize our landing page for influencer traffic\", \"fix our promo-code landing page\", or \"improve conversion from a creator campaign\"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer. 落地页优化/达人流量转化提升

unempyd/revenueos

Use when the user asks to \"script this short video\", \"write a TikTok / Reels / Shorts script\", \"给这条抖音或视频号视频写脚本\", or \"fix the hook — viewers drop off in the first seconds\"; produces timestamped beat-sheet scripts on the retention-gate model (0-2s hook / 2-5s confirmation / 5-15s payoff / loop-or-CTA) with per-scene script lines, on-screen text for muted viewing, asset keywords, and 9:16 format-param rows per platform norm card for TikTok, Reels, Shorts, 抖音, and 视频号 — plus 2-3 hook options from named hook families and an AI-content disclosure line by default on realistic synthetic media. Spec-only: rendering, TTS, and publishing stay with the user's own tools — no pipelines, no upload automation. Not for creator video briefs — use brief-generator; long-form video SEO belongs to content-writer. 短视频脚本/抖音分镜/开头钩子/竖屏9:16

unempyd/revenueos

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' 'copy this edit,' 'match this video style,' 'reverse-engineer this video,' 'edit like this reference,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

unempyd/revenueos

Edit podcast audio or video — trim pre/post-show chat, remove filler words, cut silences, enhance audio quality, and cut a video version of the same edit. Use when the user asks to edit a podcast, clean up audio, remove fillers, trim a recording, or improve voice quality.

unempyd/revenueos

Deconstruct and analyze video ad creatives for marketing insights. Use when the user says "analyze this ad", "ad creative analysis", "deconstruct this video ad", "video ad review", "ad breakdown", "why does this ad work", "creative analysis", or provides a video ad URL and asks for marketing insights.

unempyd/revenueos

Create high-converting landing page copy and structure. Use when the user says "landing page", "sales page", "create a landing page", "landing page copy", "conversion page", "lead gen page", "signup page", "product page copy", "hero section", "write landing page", or asks for marketing page copy with conversion goals.

unempyd/revenueos

You are a Conversion Rate Optimization Strategist and Persuasive Content Specialist. Use this skill when the user wants to audit or improve a landing page, write conversion-focused copy, optimize CTAs, build an FAQ schema block, translate features into benefits, or maximize conversions on any specific page type. Activate when the user mentions "landing page," "sales page," "lead capture page," "squeeze page," "webinar sign-up page," "product launch page," "waitlist page," "early access page," "thank you page," "upsell page," "SaaS pricing page," "onboarding page," "ecommerce page," "audit this page," "improve conversions," "CTA optimization," "hero section," "headline rewrite," "subhead," "benefits section," "features to benefits," "FAQ schema," "schema FAQ," "trust elements," "page layout," "above the fold," "scroll order," "microcopy," "mobile-first copy," "landing page copy," "page flow," "drop-off," "weak CTA," "conversion copy," "page goal," "split test copy," "A/B test copy," or "wireframe suggestion...

unempyd/revenueos

When the user wants to create, optimize, or audit campaign landing pages for paid ads, email, or other traffic. Also use when the user mentions "landing page," "PPC landing page," "SEM landing page," "conversion page," "campaign page," "lead capture page," "landing page optimization," "LP conversion," "single-page funnel," or "squeeze page." Not for the main site homepage; use homepage-generator.

Habilidades Relacionadas