Communitygithub.com

unempyd/revenueos

모든 Google Search Console 속성을 한 번에 감사합니다. 모든 사이트를 클릭수와 노출수로 순위를 매기고, 기간 대비 변화량을 보여주며, 사이트별 키워드 차이를 분석하여 새로 순위에 오른 키워드, 상승 중인 키워드, 하락 중인 키워드, 손실된 키워드, 또는 순위는 높지만 클릭을 얻지 못하는 키워드를 파악합니다. 에이전시 및 다중 사이트 소유자를 위해 설계되었습니다.

revenueos란 무엇인가요?

이 스킬은 단일 Google Search Console(GSC) 속성 수준을 넘어, 계정 내 모든 속성을 통합 감사하여 포트폴리오 전반의 검색 성능을 한눈에 파악할 수 있도록 합니다. `audit_gsc.py` 스크립트를 실행하면 모든 속성의 클릭수와 노출수를 기준으로 순위를 매기고 기간 대비 변화량(delta)을 계산하며, 상위 12개 사이트에 대해 키워드 수준의 차이 분석(NEW, RISING, DROPPING, LOST, CTR GAP)을 제공합니다. 추가 플래그(`--days`, `--site`, `--top` 등)를 통해 분석 기간을 조정하거나 특정 사이트만 집중적으로 확인할 수 있습니다. OAuth 리프레시 토큰을 통해 인증하며, `unauthorized_client` 오류는 일반적인 설정 실패 원인이므로 올바른 OAuth 클라이언트 쌍을 사용해야 합니다. 이 스킬은 다중 사이트 소유자나 에이전시가 각 사이트를 개별적으로 확인하지 않고도 전체 포트폴리오의 성과를 빠르게 평가하고, 새로운 키워드 기회나 문제가 있는 사이트를 식별하는 데 유용합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

GSC 포트폴리오 감사

Search Console 계정의 모든 속성에 대해 "전체적으로 어떻게 돌아가고 있나?"라는 질문에 답합니다. 이는 사이트별 도구로는 수십 번의 수동 내보내기 없이는 답할 수 없는 질문입니다.

설정

https://www.googleapis.com/auth/webmasters.readonly 범위의 OAuth 리프레시 토큰이 필요합니다:

export GOOGLE_GSC_CLIENT_ID=...      # 또는 GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=...  # 또는 GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com"   # 선택 사항, 쉼표로 구분
pip install requests

가장 흔한 설정 실패는 토큰 갱신 시 unauthorized_client입니다. 이는 리프레시 토큰이 현재 사용 중인 ID/비밀번호와 다른 OAuth 클라이언트에 대해 발급되었음을 의미합니다. 시간이 지남에 따라 Google 통합을 추가한 계정은 일반적으로 여러 클라이언트를 보유하고 있습니다. 토큰을 발급한 쌍을 일치시키세요.

실행

python3 scripts/audit_gsc.py            # 전체: 상위 12개 사이트에 대한 순위 및 키워드 차이 분석
python3 scripts/audit_gsc.py portfolio  # 순위 테이블만 표시
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90  # 분기 대비

플래그: --days (기간, 직전 동일 기간과 비교), --site (반복 가능), --top, --limit, --min-clicks.

섹션 및 의미

섹션해석 방법
NEW이전 기간에 클릭이 전혀 없었던 쿼리. 실제 성장이 발생하는 곳입니다.
RISING50% 이상 상승. 위치도 함께 이동했는지 확인하세요. 이동하지 않았다면 수요가 증가한 것이지 순위가 오른 것이 아닙니다.
DROPPING실제 기준보다 40% 이상 하락. 위치가 어떤 종류인지 알려줍니다: 순위 하락 = 순위 손실; 순위는 유지되었지만 클릭이 급감 = 상단에서 클릭을 가져간 무언가(AI 개요, 새로운 SERP 기능, 또는 쿼리 자체 변화).
LOST이전에는 순위에 있었지만 지금은 데이터 없음.
CTR GAP노출수 1,500 이상, 상위 10위, CTR 2% 미만. 제목과 설명을 다시 작성하는 것이 가장 저렴한 개선책입니다.

해석

  • 클릭을 먼저 보고, 그 다음에 노출수를 보세요. 하나의 큰 속성이 포트폴리오 노출수를 충분히 흔들어 다른 모든 것이 성장한 것을 가릴 수 있습니다.
  • 브랜드 키워드와 비브랜드 키워드를 분리하세요. 전체 키워드 세트가 자체 이름(또는 경쟁사의 오타)뿐인 사이트는 클릭수가 아무리 좋아도 획득 엔진이 없는 것입니다. 보고서에 명확히 언급하세요.
  • 전체 사이트가 자체 헤드 텀에서 붕괴하는 것은 일반적으로 SEO 문제가 아닙니다. 순위 진단 전에 소유권을 확인하세요: whois <domain> | grep -i "registrar\|updated date" 및 여전히 사이트가 응답하는지 확인. 만료, 이전 또는 분쟁 중인 도메인은 전형적인 순위 절벽을 생성하며 SEO 작업으로 해결할 수 없습니다.
  • 포트폴리오 테이블의 "new"는 이전 기간에 클릭이 0이었음을 의미합니다. 최근에 출시된 사이트의 경우 데이터 공백이 아니라 출시입니다.
  • 읽을 수 없는 언어의 쿼리를 건너뛰지 마세요. 다국적 사이트의 경우 성장은 대개 비영어 롱테일에서 발생합니다. 걸러내지 말고 흥미로운 쿼리를 번역하세요.
  • 403을 반환하는 속성은 검색결과 등록은 되어 있지만 검색 애널리틱스는 허용되지 않은 것입니다. 스크립트는 이를 숨기지 않고 보고합니다.

참고 사항

  • GSC 데이터는 약 3일 지연됩니다. 스크립트가 이를 자동으로 보정합니다.
  • 두 기간 모두 속성별로 병렬로 가져오므로 40개 속성 계정도 몇 초 만에 완료됩니다.
  • 쿼리 행 수는 기간당 25,000개로 제한되며, 이는 28일 기간 동안 단일 사이트가 반환하는 양보다 훨씬 많습니다.

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.

관련 스킬