Communitygithub.com

unempyd/revenueos

Audita TODAS las propiedades de Google Search Console a la vez — clasifica todos los sitios por clics e impresiones con deltas período a período, luego compara palabras clave por sitio para descubrir qué está clasificando nuevo, subiendo, cayendo, perdido o bien posicionado sin obtener clics. Diseñado para agencias y propietarios de múltiples sitios.

¿Qué es revenueos?

Este skill automatiza la auditoría completa de todas las propiedades de Google Search Console (GSC) en una cuenta, brindando una visión general del rendimiento del portafolio sin necesidad de exportaciones manuales. Clasifica los sitios por clics e impresiones con variaciones período a período, y realiza un análisis detallado de palabras clave por sitio para identificar términos nuevos, en ascenso, en descenso, perdidos o con baja tasa de clics (CTR gap). Es especialmente útil para agencias y propietarios de múltiples sitios que necesitan comparar el rendimiento entre sitios, detectar caídas o encontrar oportunidades de contenido. Se ejecuta mediante scripts de Python que requieren un token de actualización OAuth con permisos de solo lectura de Search Console. Incluye modos para obtener solo la tabla clasificatoria, consultar consultas específicas de un sitio, o personalizar el período de análisis. La salida interpreta correctamente los datos, distinguiendo entre problemas de SEO reales y cambios de propiedad del dominio, y advierte sobre propiedades que devuelven error 403.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Auditoría de Portafolio GSC

Responde "¿cómo va todo?" en cada propiedad de una cuenta de Search Console, que es la pregunta que las herramientas por sitio no pueden responder sin decenas de exportaciones manuales.

Configuración

Requiere un token de actualización OAuth con https://www.googleapis.com/auth/webmasters.readonly:

export GOOGLE_GSC_CLIENT_ID=...      # o GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=...  # o GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com"   # opcional, separado por comas
pip install requests

El error de configuración más común es unauthorized_client al renovar el token. Significa que el token de actualización fue emitido para un cliente OAuth diferente al id/secret que emparejaste. Las cuentas que han agregado integraciones de Google con el tiempo suelen tener varios clientes; empareja el par que creó el token.

Cómo ejecutarlo

python3 scripts/audit_gsc.py            # completo: clasificación + comparación de palabras clave para los 12 primeros
python3 scripts/audit_gsc.py portfolio  # solo la tabla clasificatoria
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90  # trimestre contra trimestre

Banderas: --days (ventana, comparada con la ventana inmediatamente anterior), --site (repetible), --top, --limit, --min-clicks.

Secciones y qué significan

SecciónLéelo como
NUEVOconsultas con cero clics en el período anterior. De dónde viene realmente el crecimiento.
SUBIENDOsubió ≥50%. Verifica si la posición también se movió — si no lo hizo, aumentó la demanda, no tu clasificación.
BAJANDObajó ≥40% desde una base real. La posición te dice de qué tipo: si cayó el rango = pérdida de clasificación; si el rango se mantuvo pero los clics colapsaron = algo tomó los clics arriba (AI Overview, una nueva característica SERP, o la consulta cambió de forma).
PERDIDOantes clasificaba, ahora no hay datos.
BRECHA DE CTR≥1,500 impresiones, top 10, menos del 2% de CTR. Reescribir título y descripción, las victorias más baratas disponibles.

Interpretación

  • Reporta primero los clics, luego las impresiones. Una propiedad grande puede sesgar las impresiones del portafolio lo suficiente como para ocultar que todo lo demás creció.
  • Separa marca de no marca. Un sitio cuyo conjunto completo de palabras clave es su propio nombre (o errores ortográficos de un competidor) no tiene motor de adquisición, por bueno que parezca el número de clics. Dilo claramente en el informe.
  • Un colapso completo del sitio en su propio término de cabecera no suele ser SEO. Verifica la propiedad antes de diagnosticar clasificaciones: whois <dominio> | grep -i "registrar\|updated date" más si todavía resuelve. Los dominios caducados, transferidos o en disputa producen un acantilado de clasificación de libro de texto que ningún trabajo SEO arreglará.
  • "nuevo" en la tabla del portafolio significa cero clics en la ventana anterior, que para un sitio recién lanzado es un lanzamiento, no un vacío de datos.
  • No omitas consultas en idiomas que no puedas leer. En sitios multimercado, el crecimiento suele estar en cola larga no inglesa; traduce las interesantes en lugar de filtrarlas.
  • Una propiedad que devuelve 403 está verificada para listado pero no para análisis de búsqueda. El script lo reporta en lugar de ocultarlo.

Notas

  • Los datos de GSC se retrasan aproximadamente 3 días; el script lo compensa automáticamente.
  • Ambos períodos se obtienen por propiedad en paralelo, por lo que una cuenta de 40 propiedades toma segundos.
  • Las filas de consultas están limitadas a 25,000 por período, muy por encima de lo que cualquier sitio devuelve para una ventana de 28 días.

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.

Skills relacionados