Communitygithub.com

unempyd/revenueos

一次性稽核所有 Google Search Console 資源,根據點擊數和曝光數對所有網站進行排名,並提供逐期差異分析,以及每個網站的關鍵字差異比較,找出新排名、上升、下降、遺失或排名佳但無點擊的關鍵字。專為代理商和多網站擁有者設計。

revenueos 是什麼?

此技能旨在解決跨多個 Google Search Console 資源進行大規模 SEO 稽核的難題。傳統的 GSC 工具一次只能處理一個網站,但對於管理數十甚至上百個網站的代理商或企業來說,這種方式效率極低。此技能提供一個全面的投資組合儀表板,能一次性提取所有已驗證資源的點擊、曝光、排名和點擊率資料,並根據流量指標對網站進行排名。其核心功能包括「逐期差異分析」,可自動比較兩個時間範圍(例如最近 28 天與前一個 28 天)的資料,以辨識每個網站的關鍵字趨勢(新增、上升、下降、遺失、點擊率差距)。此技能支援所有主要的 GSC 平台,並透過並行 API 呼叫最佳化以實現快速資料收集。它提供詳細的解讀指南,協助使用者區分品牌流量與非品牌流量、識別技術性 SEO 問題(例如過期網域或資料延遲),並避免常見的誤解,例如將新網站的推出錯誤歸因於 SEO 成效。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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)上一個時間範圍內點擊數為零的查詢。這是成長的真正來源。
上升 (RISING)上升 ≥50%。檢查排名是否也跟著移動——如果沒有,表示需求上升,而不是您的排名提升。
下降 (DROPPING)以實際基數為準下降 ≥40%。排名會告訴您是那一種: 排名下降 = 排名損失;排名維持但點擊量暴跌 = 有東西搶走了您上方的點擊(AI 概述、新的 SERP 功能,或查詢型態改變)。
遺失 (LOST)之前有排名,現在無資料。
點擊率差距 (CTR GAP)≥1,500 次曝光,前 10 名,點擊率低於 2%。標題和描述重寫,這是最便宜的勝利。

解讀

  • 首先報告點擊數,其次才是曝光數。 一個大型資源可能足以左右整個投資組合的曝光數,掩蓋其他所有網站都有成長的事實。
  • 將品牌流量與非品牌流量分開。 一個網站整個關鍵字集都是自己的名稱(或競爭對手的拼寫錯誤),無論點擊數看起來多好,都沒有收購引擎。請在報告中直接說明。
  • 整個網站在自身核心詞上的崩潰通常不是 SEO 問題。 在診斷排名之前,請先確認所有權:whois <domain> | grep -i "registrar\|updated date",加上檢查它是否還能解析。到期、轉移或有爭議的網域會產生典型的排名懸崖,這是任何 SEO 工作都無法解決的。
  • 投資組合表格中的「新增」表示上一個時間範圍內的點擊數為零,對於剛啟動的網站來說,這是上線,而不是資料缺口。
  • 不要跳過您看不懂語言的查詢。 在多市場網站上,成長通常來自非英語的長尾關鍵字;請翻譯有趣的查詢,而不是過濾掉它們。
  • 回傳 403 錯誤的資源表示已通過 listing 驗證,但未通過搜尋分析驗證。腳本會報告此錯誤,而不是隱藏它。

附註

  • 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.

相關技能