mcpField
S
seo-geo-optimizer

seo-geo-optimizer

github.com/199-biotechnologiesMarketing & growth5084 installsUpdated 23w ago
Repository

About seo-geo-optimizer

seo-geo-optimizer is a content auditing skill for SEO, GEO, and AEO visibility, intended for people maintaining web content. Its scripts analyze content and metadata, generate schema markup, and produce reports in several formats.

Key features

  1. 01Full audits with reports
  2. 02Content and metadata analysis
  3. 03Keyword and entity extraction
  4. 04Schema markup generation
  5. 05AI platform content optimization
  6. 06Citation and voice search improvements

Use cases

  1. 01Auditing HTML or Markdown pages
  2. 02Checking HTML metadata
  3. 03Preparing structured data markup
  4. 04Improving content for AI platforms

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/199-biotechnologies/claude-skill-seo-geo-optimizer --skill seo-geo-optimizer

After installing, type/seo-geo-optimizerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
PHASE2-PLAN.md
LICENSE
README.md
PLAN.md
PHASE3-PLAN.md
examples/consulting-firm/
README.md
examples/medical-clinic/
README.md
before.html
after.html
examples/saas-landing-page/
README.md
profiles/
chatgpt_authority.json
voice_optimized.json
perplexity_fresh.json
multi_platform.json
reference/
entity-seo-guide.md
citation-optimization-guide.md
platform-strategies.md
schema-library.md
scripts-reference.md
social-preview-guide.md
troubleshooting.md
statistics-2026.md
voice-search-guide.md
scripts/
auto_implementer.py
entity_extractor.py
analyze_content.py
content_optimizer.py
citation_enhancer.py
freshness_monitor.py

Details

From the project README

SEO/GEO/AEO Optimizer

Audit content for search engine and AI platform visibility. Generates schema markup, validates metadata, extracts keywords, and produces actionable reports.

When NOT to Use

  • Creating new content from scratch (use content generation tools)
  • Image optimization (use image-specific tools)
  • Server-side performance (use web performance tools)

Decision Matrix

Pick the right script based on user intent:

User WantsScriptInput
Full audit with reportscripts/audit_report.py <file> --format allHTML/MD/JSX
Content structure analysisscripts/analyze_content.py <file>HTML/MD/JSX
Meta tag validationscripts/metadata_validator.py <file>HTML
Keyword extractionscripts/keyword_analyzer.py <file>Any text
Entity extractionscripts/entity_extractor.py <file>Any text
Schema markup generationscripts/schema_generator.py <type> [args]CLI args
AI platform optimizationscripts/auto_implementer.py <file> <platform>HTML + platform
Content optimizationscripts/content_optimizer.py <file>HTML/MD
Citation enhancementscripts/citation_enhancer.py <file>HTML/MD
Voice search optimizationscripts/voice_optimizer.py <file>HTML/MD
Freshness monitoringscripts/freshness_monitor.py <file>HTML
IndexNow submissionscripts/indexnow_submit.py <url>URL

Platforms for auto_implementer: chatgpt, perplexity, claude, gemini, grokipedia

Schema types: faq, article, howto, organization, person

Preflight

Before running any script, verify:

  1. File exists and is a supported type (.html, .md, .mdx, .jsx, .tsx)
  2. Python 3.7+ available (scripts use stdlib only, no external deps)

Error Handling

  • FileNotFoundError: Check the path. Scripts accept absolute or relative paths.
  • JSON decode errors: The input file may have malformed schema markup. Run metadata_validator.py first to identify issues.
  • Low scores (< 50): Not an error. Run audit_report.py --format all for detailed recommendations, then apply fixes with auto_implementer.py.
  • Script import errors: All scripts share scripts/shared/ utilities. Ensure the full scripts directory is intact.

Output

Reports saved to ~/Documents/SEO_Audit_YYYY-MM-DD_HH-MM-SS/ in three formats:

  • JSON: Raw audit data for programmatic use
  • Markdown: Readable report with recommendations
  • HTML: Visual dashboard with scores and charts

References

FileWhen to Read
reference/scripts-reference.mdDetailed script flags and options
reference/troubleshooting.mdCommon issues and solutions
reference/platform-strategies.mdPlatform-specific optimization strategies
reference/citation-optimization-guide.mdAI citation and GEO strategies
reference/schema-library.mdComplete JSON-LD schema reference
reference/entity-seo-guide.mdKnowledge Graph optimization
reference/voice-search-guide.mdVoice search and AEO optimization
reference/social-preview-guide.mdOpen Graph and Twitter Card setup
reference/statistics-2026.mdMay 2026 review — what shifted, what survived, what to drop

Comments

Markdown supported