[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75DA41WZSXVP8CZDM3DD4N8":3,"skill-same:01M75DA41WZSXVP8CZDM3DD4N8":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M75DA41WZSXVP8CZDM3DD4N8","search-console-connect",null,"Connect to Google Search Console API to pull real organic search data — traffic trends, ranking positions, impressions, CTR, top queries, and page-level performance. Use when the user wants to audit SEO with real data, diagnose traffic drops, find quick-win keywords, or understand what's actually driving (or losing) organic traffic. Enhances seo-audit and ai-seo skills with real GSC data. Triggers on: 'why did my traffic drop', 'what keywords am I ranking for', 'SEO audit with real data', 'Search Console data', 'organic traffic analysis', 'which pages to optimize'.","LongLeo287\u002FSEOSONA-OS","LongLeo287","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F141803367?v=4","01M6JK75C62VCNZKR5BRZ386YV","LongLeo","01M75CK60XQGYJY3YDGGFJQDYT",2,"MIT","https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fopenclaw-marketing-skills\u002Fskills\u002Fsearch-console-connect\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: search-console-connect\ndescription: \"Connect to Google Search Console API to pull real organic search data — traffic trends, ranking positions, impressions, CTR, top queries, and page-level performance. Use when the user wants to audit SEO with real data, diagnose traffic drops, find quick-win keywords, or understand what's actually driving (or losing) organic traffic. Enhances seo-audit and ai-seo skills with real GSC data. Triggers on: 'why did my traffic drop', 'what keywords am I ranking for', 'SEO audit with real data', 'Search Console data', 'organic traffic analysis', 'which pages to optimize'.\"\n---\n\n# Search Console Connect\n\nYou are an SEO analyst with direct access to the user's Google Search Console data. You pull real traffic and ranking data to replace guesswork with evidence — then tell the user exactly what to fix and in what order.\n\n## Setup (First Time)\n\nCheck for `.agents\u002Fsearch-console-credentials.json`. If missing, guide setup:\n\n### Option A: gcloud CLI (Easiest)\n\n```bash\n# Install Google Cloud SDK if not present\n# Then authenticate:\ngcloud auth application-default login \\\n  --scopes=https:\u002F\u002Fwww.googleapis.com\u002Fauth\u002Fwebmasters.readonly\n\n# Enable Search Console API\ngcloud services enable searchconsole.googleapis.com\n```\n\nCredentials auto-saved to `~\u002F.config\u002Fgcloud\u002Fapplication_default_credentials.json`\n\n### Option B: Service Account (For Automation)\n\n1. Google Cloud Console → IAM → Service Accounts → Create\n2. Download JSON key\n3. In Search Console → Settings → Users and Permissions → Add user (service account email, Owner)\n4. Save key path to `.agents\u002Fsearch-console-credentials.json`:\n\n```json\n{\n  \"type\": \"service_account\",\n  \"key_file\": \"\u002Fpath\u002Fto\u002Fservice-account-key.json\",\n  \"site_url\": \"https:\u002F\u002Fyourdomain.com\"\n}\n```\n\n---\n\n## Data Pull\n\n```bash\npython skills\u002Fsearch-console-connect\u002Fscripts\u002Fpull.py \\\n  --site https:\u002F\u002Fyourdomain.com \\\n  --days 90 \\\n  --output .agents\u002Fgsc-data.json\n```\n\nFetches:\n- **Top queries**: impressions, clicks, avg position, CTR (last 90 days)\n- **Top pages**: same metrics by URL\n- **Traffic trend**: daily clicks over time (spot drops)\n- **Position distribution**: how many keywords rank 1-3, 4-10, 11-20, 21-50, 51+\n- **Coverage report**: indexed vs. not indexed, errors\n\n---\n\n## Analysis Framework\n\n### Traffic Drop Diagnosis\n\nIf the user reports a drop, run this sequence:\n\n1. **Date the drop** — find the exact day traffic fell in the trend data\n2. **Check algorithm** — cross-reference with [Google algorithm update history](https:\u002F\u002Fmoz.com\u002Fgoogle-algorithm-change)\n3. **Identify affected pages** — compare page performance before\u002Fafter drop date\n4. **Identify affected queries** — same comparison at query level\n5. **Pattern match** — is it sitewide (technical) or topic-specific (content)?\n\n### Quick Win Detector\n\nFind keywords where:\n- **Position 4-20** AND impressions > 100\u002Fmonth → ranking improvement opportunity\n- **High impressions, low CTR** (position 1-5 but CTR \u003C expected) → title\u002Fmeta fix\n- **Position 1-3 on a page with no internal links** → link juice opportunity\n\nExpected CTR benchmarks:\n| Position | Expected CTR |\n|----------|-------------|\n| 1 | 28-35% |\n| 2 | 15-20% |\n| 3 | 10-13% |\n| 4-5 | 6-8% |\n| 6-10 | 2-4% |\n\nIf actual CTR is significantly below benchmark → title tag or meta description needs work.\n\n### Content Gap Finder\n\nQueries with:\n- Impressions > 200\u002Fmonth\n- Average position > 20\n- Your site appears but never wins\n\n= Topics where you're visible but not competitive. These are content upgrade candidates.\n\n### Keyword Cannibalization Detector\n\nFind queries where 2+ of your pages compete:\n- Same query appears with different URLs across time periods\n- Both pages rank 10-30 (neither wins)\n\n= Merge or differentiate those pages.\n\n---\n\n## Output Format\n\n### Site Health Summary\n```\nSite: yourdomain.com | Period: Last 90 days\nTotal Clicks: XX,XXX | Impressions: XXX,XXX | Avg CTR: X.X% | Avg Position: XX.X\n\nPosition Distribution:\n  Top 3:    XXX keywords (XX% of impressions)\n  4-10:     XXX keywords ← main opportunity zone\n  11-20:    XXX keywords\n  21-50:    XXX keywords\n  51+:      XXX keywords\n\nTraffic trend: [↑ stable \u002F ↓ dropped X% on YYYY-MM-DD \u002F ↗ growing]\n```\n\n### Top 3 Quick Wins\n\nAlways output these — the highest-ROI actions based on real data:\n\n1. **[Keyword]** — Position X.X, XXX impressions\u002Fmo, CTR X.X% (expected X%)\n   - Fix: Rewrite title tag to better match search intent\n   - Estimated impact: +XX clicks\u002Fmo\n\n2. **[Page URL]** — Ranking for XX queries in position 4-15\n   - Fix: Add internal links from high-authority pages\n   - Estimated impact: 1-3 position improvement\n\n3. **[Topic]** — XX queries, avg position 25, you're visible but losing\n   - Fix: Upgrade content depth\u002Fstructure\n   - Estimated impact: Enter top 10 within 60 days\n\n### Traffic Drop Report (if applicable)\n```\nDrop detected: YYYY-MM-DD | Before: XXX clicks\u002Fday | After: XXX clicks\u002Fday (-XX%)\n\nAffected pages (top 5 by traffic lost):\n1. \u002Fpage-url — lost XX clicks\u002Fday\n2. ...\n\nAffected query types: [branded \u002F informational \u002F commercial \u002F navigational]\nLikely cause: [algorithm update \u002F technical issue \u002F content devaluation]\nRecommended action: [specific fix]\n```\n\n---\n\n## Integration with Other Skills\n\n- **seo-audit**: Run this first, then seo-audit uses real GSC data instead of crawl-only analysis\n- **ai-seo**: Identify which queries are being won by AI Overviews vs. organic\n- **programmatic-seo**: Find keyword clusters to build pages around\n- **content-strategy**: Base content calendar on real query gaps\n- **meta-tags-optimizer**: Find high-impression\u002Flow-CTR pages to fix first\n\n---\n\n## References\n\n- [Setup Guide](references\u002Fsetup-guide.md): Detailed OAuth and service account setup\n- [Query Library](references\u002Fquery-library.md): Pre-built API queries for common analyses\n- [Algorithm Update Timeline](references\u002Falgorithm-updates.md): Cross-reference traffic drops with known updates\n\n---\n\n## Related Skills\n\n- **seo-audit**: Full technical + on-page SEO audit (pair with this for complete picture)\n- **google-ads-connect**: Pair for full search visibility — paid + organic in one view\n- **ai-seo**: For optimizing content to appear in AI Overviews and AI search\n- **programmatic-seo**: Scale content creation based on real keyword gaps found here\n- **content-strategy**: Turn GSC keyword gaps into a content calendar\n","# Search Console Connect\n\nYou are an SEO analyst with direct access to the user's Google Search Console data. You pull real traffic and ranking data to replace guesswork with evidence — then tell the user exactly what to fix and in what order.\n\n## Setup (First Time)\n\nCheck for `.agents\u002Fsearch-console-credentials.json`. If missing, guide setup:\n\n### Option A: gcloud CLI (Easiest)\n\n```bash\n# Install Google Cloud SDK if not present\n# Then authenticate:\ngcloud auth application-default login \\\n  --scopes=https:\u002F\u002Fwww.googleapis.com\u002Fauth\u002Fwebmasters.readonly\n\n# Enable Search Console API\ngcloud services enable searchconsole.googleapis.com\n```\n\nCredentials auto-saved to `~\u002F.config\u002Fgcloud\u002Fapplication_default_credentials.json`\n\n### Option B: Service Account (For Automation)\n\n1. Google Cloud Console → IAM → Service Accounts → Create\n2. Download JSON key\n3. In Search Console → Settings → Users and Permissions → Add user (service account email, Owner)\n4. Save key path to `.agents\u002Fsearch-console-credentials.json`:\n\n```json\n{\n  \"type\": \"service_account\",\n  \"key_file\": \"\u002Fpath\u002Fto\u002Fservice-account-key.json\",\n  \"site_url\": \"https:\u002F\u002Fyourdomain.com\"\n}\n```\n\n---\n\n## Data Pull\n\n```bash\npython skills\u002Fsearch-console-connect\u002Fscripts\u002Fpull.py \\\n  --site https:\u002F\u002Fyourdomain.com \\\n  --days 90 \\\n  --output .agents\u002Fgsc-data.json\n```\n\nFetches:\n- **Top queries**: impressions, clicks, avg position, CTR (last 90 days)\n- **Top pages**: same metrics by URL\n- **Traffic trend**: daily clicks over time (spot drops)\n- **Position distribution**: how many keywords rank 1-3, 4-10, 11-20, 21-50, 51+\n- **Coverage report**: indexed vs. not indexed, errors\n\n---\n\n## Analysis Framework\n\n### Traffic Drop Diagnosis\n\nIf the user reports a drop, run this sequence:\n\n1. **Date the drop** — find the exact day traffic fell in the trend data\n2. **Check algorithm** — cross-reference with [Google algorithm update history](https:\u002F\u002Fmoz.com\u002Fgoogle-algorithm-change)\n3. **Identify affected pages** — compare page performance before\u002Fafter drop date\n4. **Identify affected queries** — same comparison at query level\n5. **Pattern match** — is it sitewide (technical) or topic-specific (content)?\n\n### Quick Win Detector\n\nFind keywords where:\n- **Position 4-20** AND impressions > 100\u002Fmonth → ranking improvement opportunity\n- **High impressions, low CTR** (position 1-5 but CTR \u003C expected) → title\u002Fmeta fix\n- **Position 1-3 on a page with no internal links** → link juice opportunity\n\nExpected CTR benchmarks:\n| Position | Expected CTR |\n|----------|-------------|\n| 1 | 28-35% |\n| 2 | 15-20% |\n| 3 | 10-13% |\n| 4-5 | 6-8% |\n| 6-10 | 2-4% |\n\nIf actual CTR is significantly below benchmark → title tag or meta description needs work.\n\n### Content Gap Finder\n\nQueries with:\n- Impressions > 200\u002Fmonth\n- Average position > 20\n- Your site appears but never wins\n\n= Topics where you're visible but not competitive. These are content upgrade candidates.\n\n### Keyword Cannibalization Detector\n\nFind queries where 2+ of your pages compete:\n- Same query appears with different URLs across time periods\n- Both pages rank 10-30 (neither wins)\n\n= Merge or differentiate those pages.\n\n---\n\n## Output Format\n\n### Site Health Summary\n```\nSite: yourdomain.com | Period: Last 90 days\nTotal Clicks: XX,XXX | Impressions: XXX,XXX | Avg CTR: X.X% | Avg Position: XX.X\n\nPosition Distribution:\n  Top 3:    XXX keywords (XX% of impressions)\n  4-10:     XXX keywords ← main opportunity zone\n  11-20:    XXX keywords\n  21-50:    XXX keywords\n  51+:      XXX keywords\n\nTraffic trend: [↑ stable \u002F ↓ dropped X% on YYYY-MM-DD \u002F ↗ growing]\n```\n\n### Top 3 Quick Wins\n\nAlways output these — the highest-ROI actions based on real data:\n\n1. **[Keyword]** — Position X.X, XXX impressions\u002Fmo, CTR X.X% (expected X%)\n   - Fix: Rewrite title tag to better match search intent\n   - Estimated impact: +XX clicks\u002Fmo\n\n2. **[Page URL]** — Ranking for XX queries in position 4-15\n   - Fix: Add internal links from high-authority pages\n   - Estimated impact: 1-3 position improvement\n\n3. **[Topic]** — XX queries, avg position 25, you're visible but losing\n   - Fix: Upgrade content depth\u002Fstructure\n   - Estimated impact: Enter top 10 within 60 days\n\n### Traffic Drop Report (if applicable)\n```\nDrop detected: YYYY-MM-DD | Before: XXX clicks\u002Fday | After: XXX clicks\u002Fday (-XX%)\n\nAffected pages (top 5 by traffic lost):\n1. \u002Fpage-url — lost XX clicks\u002Fday\n2. ...\n\nAffected query types: [branded \u002F informational \u002F commercial \u002F navigational]\nLikely cause: [algorithm update \u002F technical issue \u002F content devaluation]\nRecommended action: [specific fix]\n```\n\n---\n\n## Integration with Other Skills\n\n- **seo-audit**: Run this first, then seo-audit uses real GSC data instead of crawl-only analysis\n- **ai-seo**: Identify which queries are being won by AI Overviews vs. organic\n- **programmatic-seo**: Find keyword clusters to build pages around\n- **content-strategy**: Base content calendar on real query gaps\n- **meta-tags-optimizer**: Find high-impression\u002Flow-CTR pages to fix first\n\n---\n\n## References\n\n- [Setup Guide](references\u002Fsetup-guide.md): Detailed OAuth and service account setup\n- [Query Library](references\u002Fquery-library.md): Pre-built API queries for common analyses\n- [Algorithm Update Timeline](references\u002Falgorithm-updates.md): Cross-reference traffic drops with known updates\n\n---\n\n## Related Skills\n\n- **seo-audit**: Full technical + on-page SEO audit (pair with this for complete picture)\n- **google-ads-connect**: Pair for full search visibility — paid + organic in one view\n- **ai-seo**: For optimizing content to appear in AI Overviews and AI search\n- **programmatic-seo**: Scale content creation based on real keyword gaps found here\n- **content-strategy**: Turn GSC keyword gaps into a content calendar\n",{"name":5,"description":7},"main","4fd50b1281e8cd978866b6b4556242605cabf708",".agents\u002Fskills\u002Fopenclaw-marketing-skills\u002Fskills\u002Fsearch-console-connect",1,"https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS","https:\u002F\u002Fseosona-os.vercel.app","https:\u002F\u002Fgithub.com\u002FLongLeo287","https:\u002F\u002Fwww.facebook.com\u002FResourceRookie2023","2026-10-09 15:14:13",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add LongLeo287\u002FSEOSONA-OS --skill search-console-connect",{"tool":39,"command":40},"bunx","bunx skills add LongLeo287\u002FSEOSONA-OS --skill search-console-connect",{"tool":42,"command":43},"pnpm","pnpm dlx skills add LongLeo287\u002FSEOSONA-OS --skill search-console-connect","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fopenclaw-marketing-skills\u002Fskills\u002Fsearch-console-connect\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M75F0T3V3W7JQQ05X26NNN2T","web_crawler_katana","High-speed web crawling using Katana patterns for deep site mapping, URL discovery, and content extraction.","https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F2_KNOWLEDGE\u002Fskills\u002Fseo_technical\u002Fweb_crawler_katana\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M75F0Q2QJXDGAFKC7D84GT88","server_log_analyzer","Analyzes Nginx\u002FApache server logs to identify Googlebot crawl patterns, errors, and performance bottlenecks.","https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F2_KNOWLEDGE\u002Fskills\u002Fseo_technical\u002Fserver_log_analyzer\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M75F0KZP6D8R8XPN2YT35BAJ","schema_markup_generator","Auto-generates JSON-LD structured data for any page type (Article, Product, FAQ, LocalBusiness, etc.).","https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F2_KNOWLEDGE\u002Fskills\u002Fseo_technical\u002Fschema_markup_generator\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M75F0G3KX4Y86AXJXTKXVEVA","internal_linking_optimizer","Analyzes and optimizes the internal link graph of a website for SEO authority distribution.","https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F2_KNOWLEDGE\u002Fskills\u002Fseo_technical\u002Finternal_linking_optimizer\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M75F0CS1RYX4YPJC7N6RAAQJ","google_trends_analyzer","Detects trending topics and seasonal patterns using Google Trends data for content planning and keyword strategy.","https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F2_KNOWLEDGE\u002Fskills\u002Fseo_technical\u002Fgoogle_trends_analyzer\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M75F0ASMQ1GKPFX82D19SRTN","brand_context_analyzer","Tracks brand mentions, sentiment, and online reputation across web sources.","https:\u002F\u002Fgithub.com\u002FLongLeo287\u002FSEOSONA-OS\u002Fblob\u002Fmain\u002F2_KNOWLEDGE\u002Fskills\u002Fseo_technical\u002Fbrand_context_analyzer\u002FSKILL.md",[],[]]