seo-geo logo

seo-geov1.0.093 installs

SEO & GEO (Generative Engine Optimization) for websites. Optimize for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) and traditional search (Google, Bing). Includes Princeton GEO research methods for +40% AI visibility.

DATAFORSEO_LOGINdataforseo.com(optional)
DATAFORSEO_PASSWORDdataforseo.com(optional)
TWITTERAPI_API_KEYtwitterapi.io(from twitter)
Depends on: twitterreddit
SEOGEOsearch optimizationschema markupJSON-LDmeta tagskeyword researchAI visibilityChatGPT rankingPerplexity

Quick Install

npx skills add ReScienceLab/opc-skills --skill twitter --skill reddit --skill seo-geo

Case Study: OPC Skills Website SEO/GEO Optimization

Real-world example of applying SEO and GEO optimization to opc.dev.


Background

Website: opc.dev
Product: AI Agent Skills for Solopreneurs
Platforms: Claude Code, Cursor, Codex, Factory Droid, OpenCode
Date: January 2026

Initial Status

Metric Status
Google Indexed ❌ No
Bing Indexed ❌ No
Schema Markup ❌ None
FAQ Section ❌ None
Meta Tags ⚠️ Basic
AI Bot Access ⚠️ Not configured

Problem Analysis

1. Keyword Conflict

The term "OPC" has different meanings in different markets:

Market "OPC" Meaning
English (Industrial) OPC UA - Industrial automation protocol
Chinese 一人公司 (One Person Company)
Solopreneur One Person Company (intended meaning)

Decision: Focus on long-tail keywords for English market:

  • "AI agent skills for solopreneurs"
  • "Claude Code skills"
  • "indie hacker tools"

2. Missing Schema Markup

No structured data meant:

  • No rich results in Google
  • Poor AI visibility
  • No FAQ display

3. No GEO Optimization

Content lacked:

  • Statistics and data points
  • Expert citations
  • FAQ format
  • Answer-first structure

Implementation

Phase 1: Meta Tags Optimization

Before:

<title>OPC Skills</title>
<meta name="description" content="Skills for one person companies">

After:

<title>OPC Skills - AI Agent Skills for Solopreneurs & Indie Hackers | Claude Code, Cursor, Codex</title>
<meta name="description" content="10+ AI agent skills for solopreneurs. Domain hunting, social media research, logo creation. Works with Claude Code, Cursor, Codex, Factory Droid. One-click install, 100% open source.">

Keywords targeted:

  • solopreneur (high intent, low competition)
  • indie hacker (community term)
  • Claude Code skills (specific platform)
  • AI agent skills (emerging category)

Phase 2: Schema Markup Implementation

Added comprehensive JSON-LD:

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "WebPage",
      "name": "OPC Skills - AI Agent Skills for Solopreneurs",
      "description": "10+ agent skills for Claude Code, Cursor, Codex...",
      "dateModified": "2026-01-20",
      "speakable": {
        "@type": "SpeakableSpecification",
        "cssSelector": ["h1", ".hero-description", ".faq-answer"]
      }
    },
    {
      "@type": "SoftwareApplication",
      "name": "OPC Skills",
      "applicationCategory": "DeveloperApplication",
      "operatingSystem": "Cross-platform",
      "offers": {
        "@type": "Offer",
        "price": "0",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "What is OPC Skills?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "OPC Skills is a collection of 10+ AI agent skills..."
          }
        }
        // 12 total FAQ items
      ]
    }
  ]
}

Phase 3: GEO Optimization (Princeton Methods)

Statistics Addition (+37%)

Before:

"Skills for one person companies"

After:

"10+ Skills | 5 Platforms | One-Click Install | 100% Open Source"

FAQ Section (+40% AI Visibility)

Added 12 FAQ questions targeting high-search queries:

  1. What is OPC Skills?
  2. What platforms does OPC Skills support?
  3. How do I install OPC Skills?
  4. Is OPC Skills free?
  5. What skills are included in OPC Skills?
  6. How does the domain-hunter skill work?
  7. Can I use OPC Skills with Claude Code?
  8. What is the twitter skill used for?
  9. How do I create a logo with OPC Skills?
  10. Is OPC Skills open source?
  11. How do I contribute to OPC Skills?
  12. What is a solopreneur?

Authoritative Tone (+25%)

Before:

"Some tools for solo workers"

After:

"AI Agent Skills for Solopreneurs - The definitive skill library for 
one-person companies. Trusted by indie hackers worldwide."

Citations (+40%)

Added references to:

  • Anthropic (Claude Code official documentation)
  • Industry statistics on solopreneur growth
  • Sam Altman's "billion-dollar one-person company" prediction

Phase 4: AI Bot Configuration

Updated robots.txt considerations:

# Allow AI bots for GEO visibility
User-agent: GPTBot
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: ClaudeBot
Allow: /

Phase 5: Hero Section Rewrite

Before:

OPC Skills
Skills for OPCs

After:

AI Agent Skills for Solopreneurs

The skill library for one-person companies. 
Install once, use everywhere.

10+ Skills | 5 Platforms | One-Click Install | 100% Open Source

Results

Technical Improvements

Metric Before After
Meta Title "OPC Skills" Full keyword-rich title
Meta Description 20 chars 155 chars
Schema Types 0 4 (WebPage, Software, FAQ, Org)
FAQ Items 0 12
Statistics 0 4 key metrics

SEO Improvements

Factor Before After
Title keyword match
Description keyword match
Structured data
Rich results eligible

GEO Improvements

Princeton Method Applied Expected Boost
Cite Sources +40%
Statistics +37%
FAQ Schema +40%
Authoritative Tone +25%
Easy Language +20%

Estimated total GEO visibility boost: 40-60%


Lessons Learned

1. Keyword Research is Critical

The "OPC" keyword conflict could have hurt visibility. Long-tail keywords solved this:

  • "solopreneur tools" > "OPC tools"
  • "Claude Code skills" > "AI skills"

2. FAQPage Schema is High-Impact

Adding 12 FAQ items with proper schema:

  • Enables rich results
  • Provides AI-extractable content
  • Targets specific search queries

3. Statistics Make Content Quotable

"10+ Skills | 5 Platforms | One-Click Install | 100% Open Source"

These specific numbers are:

  • Easy for AI to extract
  • Memorable for users
  • Differentiated from competitors

4. Answer-First Structure

Each FAQ answer starts with a direct answer:

  • "OPC Skills is a collection of..." (not "Well, it depends...")
  • This matches AI response patterns

Next Steps

Short-term (1 month)

  • Submit sitemap to Google Search Console
  • Submit to Bing Webmaster Tools
  • Monitor indexing progress
  • Track FAQ rich results

Medium-term (3 months)

  • Monitor AI citation rate
  • A/B test different FAQ questions
  • Build backlinks from dev communities
  • Create content for Reddit/HN

Long-term (6 months)

  • Establish "OPC Skills = Solopreneur tools" brand
  • Rank for "Claude Code skills" in AI search
  • Get cited in AI responses about solopreneur tools

Replication Guide

To replicate this optimization for your own site:

  1. Audit current state using seo-geo skill checklist
  2. Research keywords - find long-tail opportunities
  3. Write meta tags - include primary keyword in title/description
  4. Add Schema markup - start with FAQPage and WebPage
  5. Apply Princeton methods - statistics, citations, structure
  6. Configure AI bot access - robots.txt
  7. Validate schema - Google Rich Results Test
  8. Submit to search engines - Search Console, Bing Webmaster
  9. Monitor and iterate - track visibility, adjust content

Files Changed

File Changes
website/worker.js Meta tags, Schema, Hero section, FAQ section, Stats bar
README.md Badges, navigation links, updated tagline
docs/MARKETING_SPEC.md Comprehensive marketing plan (new)

SEO/GEO Optimization Skill

Comprehensive SEO and GEO (Generative Engine Optimization) for websites. Optimize for both traditional search engines (Google, Bing) and AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude).

Quick Reference

GEO = Generative Engine Optimization - Optimizing content to be cited by AI search engines.

Key Insight: AI search engines don't rank pages - they cite sources. Being cited is the new "ranking #1".

Workflow

Step 1: Website Audit

Get the target URL and analyze current SEO/GEO status.

Basic SEO Audit (Free):

python3 scripts/seo_audit.py "https://example.com"

Use this for: Quick technical SEO check (title, meta, H1, robots, sitemap, load time). No API needed.


Check Meta Tags:

curl -sL "https://example.com" | grep -E "<title>|<meta name=\"description\"|<meta property=\"og:|application/ld\+json" | head -20

Use this for: Quick check of essential meta tags and schema markup on any webpage.


Check robots.txt:

curl -s "https://example.com/robots.txt"

Use this for: Verify which bots are allowed/blocked. Critical for ensuring AI search engines can crawl your site.


Check sitemap:

curl -s "https://example.com/sitemap.xml" | head -50

Use this for: Verify sitemap structure and ensure all important pages are included for search engine discovery.

Verify AI Bot Access:

# These bots should be allowed in robots.txt:
- Googlebot (Google)
- Bingbot (Bing/Copilot)
- PerplexityBot (Perplexity)
- ChatGPT-User (ChatGPT with browsing)
- ClaudeBot / anthropic-ai (Claude)
- GPTBot (OpenAI)

Step 2: Keyword Research

Use WebSearch to research target keywords:

WebSearch: "{keyword} keyword difficulty site:ahrefs.com OR site:semrush.com"
WebSearch: "{keyword} search volume 2026"
WebSearch: "site:{competitor.com} {keyword}"

Analyze:

  • Search volume and difficulty
  • Competitor keyword strategies
  • Long-tail keyword opportunities
  • International keyword conflicts (e.g., "OPC" = industrial automation in English markets)

Step 3: GEO Optimization (AI Search Engines)

Apply the 9 Princeton GEO Methods (see references/geo-research.md):

Method Visibility Boost How to Apply
Cite Sources +40% Add authoritative citations and references
Statistics Addition +37% Include specific numbers and data points
Quotation Addition +30% Add expert quotes with attribution
Authoritative Tone +25% Use confident, expert language
Easy-to-understand +20% Simplify complex concepts
Technical Terms +18% Include domain-specific terminology
Unique Words +15% Increase vocabulary diversity
Fluency Optimization +15-30% Improve readability and flow
Keyword Stuffing -10% AVOID - hurts visibility

Best Combination: Fluency + Statistics = Maximum boost

Generate FAQPage Schema (+40% AI visibility):

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "What is [topic]?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "According to [source], [answer with statistics]."
    }
  }]
}

Optimize Content Structure:

  • Use "answer-first" format (direct answer at top)
  • Clear H1 > H2 > H3 hierarchy
  • Bullet points and numbered lists
  • Tables for comparison data
  • Short paragraphs (2-3 sentences max)

Step 4: Traditional SEO Optimization

Meta Tags Template:

<title>{Primary Keyword} - {Brand} | {Secondary Keyword}</title>
<meta name="description" content="{Compelling description with keyword, 150-160 chars}">
<meta name="keywords" content="{keyword1}, {keyword2}, {keyword3}">

<!-- Open Graph -->
<meta property="og:title" content="{Title}">
<meta property="og:description" content="{Description}">
<meta property="og:image" content="{Image URL 1200x630}">
<meta property="og:url" content="{Canonical URL}">
<meta property="og:type" content="website">

<!-- Twitter Cards -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="{Title}">
<meta name="twitter:description" content="{Description}">
<meta name="twitter:image" content="{Image URL}">

JSON-LD Schema (see references/schema-templates.md):

  • WebPage / Article for content pages
  • FAQPage for FAQ sections
  • Product for product pages
  • Organization for about pages
  • SoftwareApplication for tools/apps

Check Content:

  • H1 contains primary keyword
  • Images have descriptive alt text
  • Internal links to related content
  • External links have rel="noopener noreferrer"
  • Content is mobile-friendly
  • Page loads in < 3 seconds

Step 5: Validate & Monitor

Schema Validation:

# Open Google Rich Results Test
open "https://search.google.com/test/rich-results?url={encoded_url}"

# Open Schema.org Validator
open "https://validator.schema.org/?url={encoded_url}"

Check Indexing Status:

# Google (use Search Console API or manual check)
open "https://www.google.com/search?q=site:{domain}"

# Bing
open "https://www.bing.com/search?q=site:{domain}"

Generate Report:

## SEO/GEO Optimization Report

### Current Status
- Meta Tags: ✅/❌
- Schema Markup: ✅/❌
- AI Bot Access: ✅/❌
- Mobile Friendly: ✅/❌
- Page Speed: X seconds

### Recommendations
1. [Priority 1 action]
2. [Priority 2 action]
3. [Priority 3 action]

### GEO Optimizations Applied
- [ ] FAQPage schema added
- [ ] Statistics included
- [ ] Citations added
- [ ] Answer-first structure

Platform-Specific Optimization

See references/platform-algorithms.md for detailed ranking factors.

ChatGPT

  • Focus on branded domain authority (cited 11% more than third-party)
  • Update content within 30 days (3.2x more citations)
  • Build backlinks (>350K referring domains = 8.4 avg citations)
  • Match content style to ChatGPT's response format

Perplexity

  • Allow PerplexityBot in robots.txt
  • Use FAQ Schema (higher citation rate)
  • Host PDF documents (prioritized for citation)
  • Focus on semantic relevance over keywords

Google AI Overview (SGE)

  • Optimize for E-E-A-T (Experience, Expertise, Authority, Trust)
  • Use structured data (Schema markup)
  • Build topical authority (content clusters + internal linking)
  • Include authoritative citations (+132% visibility)

Microsoft Copilot / Bing

  • Ensure Bing indexing (required for citation)
  • Optimize for Microsoft ecosystem (LinkedIn, GitHub mentions help)
  • Page speed < 2 seconds
  • Clear entity definitions

Claude AI

  • Ensure Brave Search indexing (Claude uses Brave, not Google)
  • High factual density (data-rich content preferred)
  • Clear structural clarity (easy to extract)

Skill Dependencies

This skill works best with:

  • twitter skill - Search SEO experts for latest tips
  • reddit skill - Search r/SEO, r/bigseo for discussions
  • WebSearch - Keyword research and competitor analysis

References

← Back to all skills