Communitygithub.com

unempyd/revenueos

一次性审计所有 Google Search Console 属性——根据点击次数和展示次数对所有网站进行排名,并提供同比变化数据;然后对每个网站的关键词进行差异分析,找出新排名、上升、下降、丢失或排名靠前但未获得点击的关键词。专为代理机构和多站点所有者打造。

revenueos 是什么?

这是一个面向开发者和 AI 代理的高级审计工具,能够跨 Google Search Console (GSC) 账户中的所有属性同时进行审计,解决了逐个网站手动导出数据的难题。它生成一个带有同比变化(环比)的排名表格,并对每个网站执行关键词差异分析,识别出新增、上升、下降、丢失以及点击率差距的关键词。该工具支持所有 GSC 属性,包括网域属性和 URL 前缀属性,并提供 CLI 标志用于自定义时间段(如季度对比)、过滤特定网站、限制结果数量和设置最低点击量阈值。它能够自动检测数据滞后并并行获取数据,因此在处理包含 40 个属性的账户时也能在几秒钟内完成。输出结果按照新增、上升、下降、丢失和点击率差距等部分进行组织,每个部分都有清晰的解释,便于解读 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/secret 不同的 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。

各部分及其含义

部分解读方式
新增上一周期点击量为零的查询。增长实际来自这里。
上升增长 ≥50%。检查排名是否也随之变动——如果没有,说明需求上升,而不是您的排名上升。
下降基于真实基础下降 ≥40%。排名能告诉您是哪种下降: 排名下降 = 排名损失;排名不变但点击量崩盘 = 上方的展示位抢走了点击(AI 摘要、新的 SERP 功能或查询形态改变)。
丢失之前有排名,现在无数据。
点击率差距≥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.

相关技能