mcpField
G
geo-seo-claude

geo-seo-claude

github.com/infrasity-labsMarketing & growth15090 installsUpdated 17w ago
Repository

About geo-seo-claude

geo-seo-claude is a skill for auditing and optimizing content for search engines and AI platforms. It provides separate scripts for audits, metadata, keywords, entities, schema, citations, and platform-specific optimization, with reports in JSON, Markdown, and HTML.

Key features

  1. 01Full audits with actionable reports
  2. 02Content and metadata analysis
  3. 03Keyword and entity extraction
  4. 04Schema markup generation
  5. 05Platform-specific AI optimization
  6. 06JSON, Markdown, and HTML reports

Use cases

  1. 01Auditing HTML or Markdown content
  2. 02Validating page metadata
  3. 03Generating structured schema markup
  4. 04Improving content for AI platform visibility

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill geo-seo-claude

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

Bundled files

References and scripts installed along with SKILL.md.

reference/
citation-optimization-guide.md
entity-seo-guide.md
platform-strategies.md
schema-library.md
scripts-reference.md
social-preview-guide.md
statistics-2026.md
troubleshooting.md
voice-search-guide.md
scripts/
analyze_content.py
audit_report.py
auto_implementer.py
citation_enhancer.py
content_optimizer.py
entity_extractor.py
freshness_monitor.py
indexnow_submit.py
keyword_analyzer.py
metadata_validator.py
platform_optimizer.py
schema_generator.py
voice_optimizer.py
scripts/shared/
__init__.py
config.py
schema_utils.py
text_utils.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