@olives/devos 2.1.0

package/.agents/skills/seo-geo/references/seo-checklist.md

@@ -0,0 +1,249 @@
+# SEO/GEO Audit Checklist
+
+Complete checklist for auditing and optimizing websites for both traditional SEO and GEO (AI search visibility).
+
+## Priority Levels
+
+| Level | Meaning | Action |
+|-------|---------|--------|
+| **P0** | Critical | Must fix immediately - blocks indexing or causes major issues |
+| **P1** | Important | Should fix soon - significant impact on rankings |
+| **P2** | Recommended | Nice to have - improves visibility and user experience |
+
+---
+
+## Technical SEO
+
+### P0 - Critical
+
+- [ ] **P0** `robots.txt` allows important pages
+- [ ] **P0** Site is accessible (no 5xx errors)
+- [ ] **P0** HTTPS enabled (valid SSL certificate)
+- [ ] **P0** Mobile-responsive design
+- [ ] **P0** No critical pages blocked by `noindex`
+- [ ] **P0** Site is indexed in Google (check: `site:domain.com`)
+
+### P1 - Important
+
+- [ ] **P1** `robots.txt` allows AI bots (GPTBot, PerplexityBot, ClaudeBot)
+- [ ] **P1** XML sitemap exists and is submitted
+- [ ] **P1** Site is indexed in Bing (for Copilot visibility)
+- [ ] **P1** Canonical tags properly implemented
+- [ ] **P1** No duplicate content issues
+- [ ] **P1** Page load time < 3 seconds
+- [ ] **P1** LCP (Largest Contentful Paint) < 2.5s
+
+### P2 - Recommended
+
+- [ ] **P2** FID (First Input Delay) < 100ms
+- [ ] **P2** CLS (Cumulative Layout Shift) < 0.1
+- [ ] **P2** Images optimized (WebP format, lazy loading)
+- [ ] **P2** CSS/JS minified
+- [ ] **P2** GZIP/Brotli compression enabled
+- [ ] **P2** CDN configured
+- [ ] **P2** Mobile-friendly test passed
+- [ ] **P2** No mixed content warnings
+- [ ] **P2** Secure headers configured
+
+---
+
+## On-Page SEO
+
+### P0 - Critical
+
+- [ ] **P0** Unique `<title>` tag exists (50-60 characters)
+- [ ] **P0** Title contains primary keyword
+- [ ] **P0** Unique `<meta description>` exists (150-160 characters)
+- [ ] **P0** Single H1 tag per page
+- [ ] **P0** H1 contains primary keyword
+
+### P1 - Important
+
+- [ ] **P1** Description is compelling and includes keyword
+- [ ] **P1** `<meta name="robots">` correctly set
+- [ ] **P1** Logical heading hierarchy (H1 > H2 > H3)
+- [ ] **P1** All images have `alt` attributes
+- [ ] **P1** Internal links to related content
+- [ ] **P1** No broken links (404s)
+- [ ] **P1** Anchor text is descriptive
+
+### P2 - Recommended
+
+- [ ] **P2** `og:title` set
+- [ ] **P2** `og:description` set
+- [ ] **P2** `og:image` set (1200x630px recommended)
+- [ ] **P2** `og:url` set (canonical URL)
+- [ ] **P2** `og:type` set (website/article)
+- [ ] **P2** `twitter:card` set (summary_large_image)
+- [ ] **P2** `twitter:title` set
+- [ ] **P2** `twitter:description` set
+- [ ] **P2** `twitter:image` set
+- [ ] **P2** Paragraphs are short (2-3 sentences)
+- [ ] **P2** Bullet points used for lists
+- [ ] **P2** Tables used for comparisons
+- [ ] **P2** Alt text includes keywords where natural
+- [ ] **P2** Image file names are descriptive
+- [ ] **P2** External links have `rel="noopener noreferrer"`
+
+---
+
+## Schema Markup (Structured Data)
+
+### P1 - Important
+
+- [ ] **P1** Organization schema on homepage
+- [ ] **P1** WebPage schema on all pages
+- [ ] **P1** Article schema on blog posts
+- [ ] **P1** Schema passes Google Rich Results Test
+- [ ] **P1** No errors in Search Console "Enhancements"
+
+### P2 - Recommended - GEO Enhanced
+
+- [ ] **P2** FAQPage schema on FAQ sections (+40% AI visibility)
+- [ ] **P2** BreadcrumbList schema for navigation
+- [ ] **P2** SpeakableSpecification for voice search
+- [ ] **P2** datePublished and dateModified included
+- [ ] **P2** Author information with credentials
+- [ ] **P2** Publisher information with logo
+- [ ] **P2** Schema passes Schema.org Validator
+
+---
+
+## GEO Optimization (AI Search)
+
+### P1 - Important - Princeton GEO Methods
+
+- [ ] **P1** Content includes authoritative citations (+40%)
+- [ ] **P1** Statistics and data points included (+37%)
+- [ ] **P1** Expert quotes with attribution (+30%)
+- [ ] **P1** NO keyword stuffing (causes -10%)
+
+### P2 - Recommended - GEO Enhancement
+
+- [ ] **P2** Authoritative, confident tone (+25%)
+- [ ] **P2** Content is accessible/easy to understand (+20%)
+- [ ] **P2** Appropriate technical terminology (+18%)
+- [ ] **P2** Diverse vocabulary throughout (+15%)
+- [ ] **P2** High fluency and readability (+15-30%)
+
+### Content Structure for AI
+
+- [ ] "Answer-first" format (direct answer at top)
+- [ ] Clear, extractable paragraphs
+- [ ] FAQ format for common questions
+- [ ] Tables for comparison data
+- [ ] Lists for step-by-step processes
+
+### AI Bot Access
+
+- [ ] GPTBot allowed in robots.txt
+- [ ] PerplexityBot allowed in robots.txt
+- [ ] ClaudeBot allowed in robots.txt
+- [ ] Anthropic-ai allowed in robots.txt
+- [ ] Bingbot allowed in robots.txt
+
+---
+
+## Off-Page SEO
+
+### Backlinks
+
+- [ ] Quality backlinks from relevant sites
+- [ ] Diverse referring domains
+- [ ] No toxic/spammy backlinks
+- [ ] Brand mentions (even without links)
+
+### E-E-A-T Signals
+
+- [ ] Author bios with credentials
+- [ ] About page with company info
+- [ ] Contact information visible
+- [ ] Privacy policy and terms
+- [ ] Trust badges/certifications if applicable
+- [ ] Customer reviews/testimonials
+
+### Social Presence
+
+- [ ] Active social media profiles
+- [ ] Links to social profiles on website
+- [ ] Social sharing buttons on content
+- [ ] Consistent branding across platforms
+
+---
+
+## Content Strategy
+
+### Content Audit
+
+- [ ] All pages have unique, valuable content
+- [ ] No thin content (< 300 words for main pages)
+- [ ] Content matches search intent
+- [ ] Content is up-to-date (within 30 days for news/tech)
+- [ ] Content provides unique value vs competitors
+
+### Keyword Strategy
+
+- [ ] Primary keyword identified for each page
+- [ ] Secondary keywords mapped
+- [ ] Long-tail keywords targeted
+- [ ] No keyword cannibalization
+- [ ] Keywords match user intent
+
+---
+
+## Monitoring & Analytics
+
+### Setup
+
+- [ ] Google Analytics installed
+- [ ] Google Search Console connected
+- [ ] Bing Webmaster Tools connected
+- [ ] Sitemap submitted to both
+
+### Regular Checks
+
+- [ ] Weekly: Check Search Console for errors
+- [ ] Weekly: Review Core Web Vitals
+- [ ] Monthly: Analyze organic traffic trends
+- [ ] Monthly: Review top performing pages
+- [ ] Quarterly: Full SEO audit
+
+---
+
+## Quick Audit Commands
+
+```bash
+# Check meta tags
+curl -sL "https://example.com" | grep -E "<title>|<meta"
+
+# Check robots.txt
+curl -s "https://example.com/robots.txt"
+
+# Check sitemap
+curl -s "https://example.com/sitemap.xml" | head -30
+
+# Check page speed (using PageSpeed Insights API)
+# Requires API key
+curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://example.com&strategy=mobile"
+
+# Check if indexed in Google
+# Manual check: https://www.google.com/search?q=site:example.com
+
+# Validate schema
+# Open: https://search.google.com/test/rich-results?url=https://example.com
+```
+
+---
+
+## Priority Matrix
+
+| Priority | Task | Impact |
+|----------|------|--------|
+| **Critical** | Fix crawl errors | Blocks indexing |
+| **Critical** | HTTPS enabled | Trust + ranking |
+| **High** | Core Web Vitals | UX + ranking |
+| **High** | Mobile-friendly | 60%+ traffic |
+| **High** | FAQPage schema | +40% AI visibility |
+| **Medium** | Meta descriptions | CTR improvement |
+| **Medium** | Internal linking | Authority distribution |
+| **Low** | Social meta tags | Share appearance |

package/.agents/skills/seo-geo/references/tools-and-apis.md

@@ -0,0 +1,313 @@
+# SEO/GEO Tools and API Reference
+
+Curated list of tools and APIs for SEO and GEO optimization.
+
+---
+
+## Free Tools
+
+### Schema Markup Generators
+
+| Tool | URL | Features |
+|------|-----|----------|
+| **TechnicalSEO.com** | technicalseo.com/tools/schema-markup-generator | Multiple schema types, validation |
+| **Rank Ranger** | rankranger.com/schema-markup-generator | FAQ, Article, Product schemas |
+| **Merkle** | technicalseo.com/tools/schema-markup-generator | Comprehensive schema generator |
+| **JSON-LD Generator** | jsonld.com | Simple schema builder |
+
+### Validation Tools
+
+| Tool | URL | Purpose |
+|------|-----|---------|
+| **Google Rich Results Test** | search.google.com/test/rich-results | Test schema markup |
+| **Schema.org Validator** | validator.schema.org | Validate any schema |
+| **Google Mobile-Friendly Test** | search.google.com/test/mobile-friendly | Mobile usability |
+| **PageSpeed Insights** | pagespeed.web.dev | Core Web Vitals |
+
+### SEO Audit Tools
+
+| Tool | URL | Features |
+|------|-----|----------|
+| **SEOmator** | seomator.com/free-seo-audit-tool | Comprehensive free audit |
+| **Screaming Frog (Free)** | screamingfrog.co.uk | Crawl up to 500 URLs |
+| **Google Search Console** | search.google.com/search-console | Official Google data |
+| **Bing Webmaster Tools** | bing.com/webmasters | Bing indexing data |
+
+---
+
+## Paid SEO Tools
+
+### Comprehensive Platforms
+
+| Tool | Price | Best For |
+|------|-------|----------|
+| **Ahrefs** | $99/mo+ | Backlink analysis, keyword research |
+| **Semrush** | $139/mo+ | All-in-one SEO + GEO toolkit |
+| **Moz Pro** | $99/mo+ | Domain authority, link building |
+| **SE Ranking** | $65/mo+ | Affordable all-in-one |
+
+### Content Optimization
+
+| Tool | Price | Best For |
+|------|-------|----------|
+| **Surfer SEO** | $89/mo+ | Content optimization for AI |
+| **Clearscope** | $170/mo+ | Enterprise content optimization |
+| **Frase** | $15/mo+ | AI content briefs |
+| **MarketMuse** | $149/mo+ | Content strategy |
+
+---
+
+## GEO / AI Visibility Tools
+
+### AI Search Monitoring
+
+| Tool | Price | Platforms |
+|------|-------|-----------|
+| **Profound** | $499/mo+ | ChatGPT, Perplexity, Claude, Gemini |
+| **Otterly.ai** | Free trial | ChatGPT, Perplexity, Google AIO |
+| **SE Ranking AI Toolkit** | Included | AI Overviews, ChatGPT |
+| **Semrush AI Visibility** | Included | Google AIO, ChatGPT |
+| **Peec AI** | Mid-tier | Sentiment + visibility |
+| **Scrunch AI** | Varies | Brand tracking, citations |
+
+### AI Visibility Features to Look For
+
+- Citation tracking across AI platforms
+- Prompt-level insights
+- Source attribution
+- Sentiment analysis
+- Competitive benchmarking
+- Actionable recommendations
+
+---
+
+## APIs for Automation
+
+### Google APIs
+
+| API | Purpose | Docs |
+|-----|---------|------|
+| **Search Console API** | Indexing status, search data | developers.google.com/webmaster-tools |
+| **PageSpeed API** | Core Web Vitals data | developers.google.com/speed/docs/insights/v5/get-started |
+| **Indexing API** | Request indexing | developers.google.com/search/apis/indexing-api |
+| **Custom Search API** | Programmatic search | developers.google.com/custom-search |
+
+### SEO Data APIs
+
+| API | Purpose | Pricing |
+|-----|---------|---------|
+| **DataForSEO** | Comprehensive SEO data | Pay-per-use |
+| **Moz API** | DA, PA, link data | Included with Moz |
+| **Ahrefs API** | Backlinks, keywords | Included with Ahrefs |
+| **SE Ranking API** | Rankings, audits | Included with SE Ranking |
+| **SEO Review Tools API** | Various SEO checks | Free tier available |
+
+### Schema/Metadata APIs
+
+| API | Purpose | Pricing |
+|-----|---------|---------|
+| **Apify Metadata Extractor** | Extract meta, sitemap, robots | $12/mo+ |
+| **Firecrawl** | Website crawling for SEO | Pay-per-use |
+
+---
+
+## Browser Extensions
+
+### SEO Analysis
+
+| Extension | Browser | Features |
+|-----------|---------|----------|
+| **SEOquake** | Chrome/Firefox | Quick SEO metrics |
+| **MozBar** | Chrome | DA, PA, link data |
+| **Ahrefs SEO Toolbar** | Chrome | Backlinks, keywords |
+| **Detailed SEO Extension** | Chrome | Technical SEO checks |
+
+### Schema Testing
+
+| Extension | Browser | Features |
+|-----------|---------|----------|
+| **Structured Data Testing Tool** | Chrome | View page schema |
+| **Schema Builder** | Chrome | Generate schema |
+
+---
+
+## Command Line Tools
+
+### curl Commands for SEO Checks
+
+```bash
+# Check meta tags
+curl -sL "https://example.com" | grep -E "<title>|<meta"
+
+# Check robots.txt
+curl -s "https://example.com/robots.txt"
+
+# Check sitemap
+curl -s "https://example.com/sitemap.xml"
+
+# Check HTTP headers
+curl -I "https://example.com"
+
+# Check redirect chain
+curl -sIL "https://example.com" | grep -E "HTTP|Location"
+
+# Check page size
+curl -sL "https://example.com" | wc -c
+
+# Check load time
+curl -o /dev/null -s -w "Total: %{time_total}s\n" "https://example.com"
+```
+
+### Using Google APIs via curl
+
+```bash
+# PageSpeed Insights (no API key needed for basic)
+curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://example.com"
+
+# With API key (more requests allowed)
+curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://example.com&key=YOUR_API_KEY"
+```
+
+---
+
+## Robots.txt Template for AI Bots
+
+```
+# Search Engines
+User-agent: Googlebot
+Allow: /
+
+User-agent: Bingbot
+Allow: /
+
+# AI Bots
+User-agent: GPTBot
+Allow: /
+
+User-agent: ChatGPT-User
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+User-agent: ClaudeBot
+Allow: /
+
+User-agent: anthropic-ai
+Allow: /
+
+User-agent: Applebot-Extended
+Allow: /
+
+# Sitemap
+Sitemap: https://example.com/sitemap.xml
+```
+
+---
+
+## Scripts
+
+Ready-to-use Python scripts in `scripts/` folder.
+
+### Setup (DataForSEO scripts)
+
+```bash
+export DATAFORSEO_LOGIN=your_login
+export DATAFORSEO_PASSWORD=your_password
+```
+
+### seo_audit.py
+
+Full SEO audit - meta tags, robots.txt, sitemap, load time, schema, AI bot access. No API required.
+
+```bash
+python3 scripts/seo_audit.py "https://example.com"
+```
+
+### keyword_research.py
+
+Get keyword ideas, search volume, difficulty.
+
+```bash
+python3 scripts/keyword_research.py "seo tools" --limit 20
+python3 scripts/keyword_research.py "seo tools" --location 2826  # UK
+```
+
+### serp_analysis.py
+
+Analyze top 20 Google results for a keyword.
+
+```bash
+python3 scripts/serp_analysis.py "best seo tools" --depth 20
+```
+
+### backlinks.py
+
+Get backlink profile for a domain.
+
+```bash
+python3 scripts/backlinks.py "example.com" --limit 20
+```
+
+### domain_overview.py
+
+Get domain metrics - traffic, keywords, rankings.
+
+```bash
+python3 scripts/domain_overview.py "example.com"
+```
+
+---
+
+## Workflow Integration
+
+### Using with OPC Skills
+
+```bash
+# Use twitter skill to find SEO tips
+python3 scripts/search_tweets.py "SEO tips 2026" --limit 20
+
+# Use reddit skill to find discussions
+python3 scripts/search_posts.py "GEO optimization" --subreddit SEO --limit 10
+
+# Use WebSearch for keyword research
+# (Built into agent)
+```
+
+### Automation Ideas
+
+1. **Weekly SEO audit** - Crawl site with curl, check for errors
+2. **Schema monitoring** - Validate schema after deploys with Rich Results Test API
+3. **Ranking tracking** - Monitor AI visibility with Otterly.ai or Profound
+4. **Content freshness** - Flag outdated content based on dateModified
+5. **Competitor monitoring** - Track competitor changes with DataForSEO API
+
+---
+
+## Resources
+
+### Learning
+
+| Resource | URL | Type |
+|----------|-----|------|
+| **Google SEO Guide** | developers.google.com/search/docs | Official |
+| **Moz Beginner's Guide** | moz.com/beginners-guide-to-seo | Tutorial |
+| **Backlinko** | backlinko.com/hub/seo | Advanced |
+| **Search Engine Journal** | searchenginejournal.com | News |
+
+### GEO Research
+
+| Resource | URL | Type |
+|----------|-----|------|
+| **Princeton GEO Paper** | arxiv.org/abs/2311.09735 | Research |
+| **GEO Guide (SingleGrain)** | singlegrain.com/geo | Guide |
+| **AI Search Optimization (Semrush)** | semrush.com/blog/ai-search-optimization | Tutorial |
+
+### Communities
+
+| Community | Platform | Focus |
+|-----------|----------|-------|
+| **r/SEO** | Reddit | General SEO |
+| **r/bigseo** | Reddit | Advanced SEO |
+| **r/TechSEO** | Reddit | Technical SEO |
+| **SEO Twitter** | Twitter | News, tips |

package/.agents/skills/seo-geo/scripts/autocomplete_ideas.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""
+Google Autocomplete keyword suggestions using DataForSEO API
+Get real-time search suggestions from Google Autocomplete
+
+Usage: python3 scripts/autocomplete_ideas.py "Claude Code"
+"""
+import argparse
+from dataforseo_api import api_post, get_result
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Google Autocomplete keyword suggestions")
+    parser.add_argument("keyword", help="Seed keyword for autocomplete")
+    parser.add_argument("--location", "-loc", type=int, default=2840,
+                        help="Location code (default: 2840 = US)")
+    args = parser.parse_args()
+
+    data = [{
+        "keyword": args.keyword,
+        "location_code": args.location,
+        "language_code": "en"
+    }]
+    
+    response = api_post("serp/google/autocomplete/live/advanced", data)
+    results = get_result(response)
+    
+    print(f"keyword: {args.keyword}")
+    print(f"location: {args.location}")
+    print()
+    
+    if results:
+        suggestions = []
+        for result in results:
+            items = result.get("items", [])
+            
+            # Try different possible field names if items is empty
+            if not items:
+                items = result.get("autocomplete", [])
+                if not items:
+                    items = result.get("suggestions", [])
+            
+            for item in items:
+                # Handle different response formats
+                suggestion = None
+                if isinstance(item, dict):
+                    if item.get("type") == "autocomplete_item":
+                        suggestion = item.get("title", "").strip()
+                    elif "value" in item:
+                        suggestion = item.get("value", "").strip()
+                elif isinstance(item, str):
+                    suggestion = item.strip()
+                
+                if suggestion:
+                    suggestions.append(suggestion)
+        
+        if suggestions:
+            print(f"autocomplete_suggestions[{len(suggestions)}]:")
+            for i, suggestion in enumerate(suggestions, 1):
+                print(f"  {i}. {suggestion}")
+        else:
+            print("No suggestions found")
+    else:
+        print("No results found")
+    
+    print()
+    print("Tip: These are real user searches. Use them to:")
+    print("  - Create content matching user intent")
+    print("  - Optimize page titles and meta descriptions")
+    print("  - Discover long-tail keyword opportunities")
+
+
+if __name__ == "__main__":
+    main()

package/.agents/skills/seo-geo/scripts/backlinks.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python3
+"""
+Backlinks analysis using DataForSEO API
+Usage: python3 scripts/backlinks.py "example.com" --limit 20
+"""
+import argparse
+from dataforseo_api import api_post, get_result, print_backlinks_list, format_count
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Backlinks analysis")
+    parser.add_argument("target", help="Target domain")
+    parser.add_argument("--limit", "-l", type=int, default=20, help="Max results")
+    args = parser.parse_args()
+
+    data = [{
+        "target": args.target,
+        "limit": args.limit,
+        "order_by": ["rank,desc"]
+    }]
+    
+    response = api_post("backlinks/backlinks/live", data)
+    results = get_result(response)
+    
+    print(f"target: {args.target}")
+    
+    if results:
+        result = results[0]
+        print(f"total_backlinks: {format_count(result.get('total_count'))}")
+        items = result.get("items", [])
+        print_backlinks_list(items[:args.limit])
+    else:
+        print("No results found")
+
+
+if __name__ == "__main__":
+    main()