seo-geo Skill for Claude: Optimize a Site for Google and AI Search
seo-geo makes Claude audit a website and improve it for Google, Bing and for being cited by AI search such as ChatGPT and Perplexity.
- Installs
- 55K
- on skills.sh
- Stars
- 1.9K
- on GitHub
- Files
- 18
- besides SKILL.md
- Updated
- Nov 2026
- last repo commit
This skill, from ReScienceLab's opc-skills collection, treats AI search as a citation game: engines cite sources rather than rank pages. Claude audits the site, researches keywords, applies a set of nine GEO methods drawn from a Princeton paper, writes meta tags and JSON-LD schema, then validates the result and writes a report.
The bundled seo_audit.py script needs no key. Seven other scripts call DataForSEO for keyword, SERP, backlink and domain data and need a paid DataForSEO login. The percentage boosts in its tables are the skill's own summary of that research, not a promise for your site.
Good for
- Site owners who want to be cited by AI search as well as ranked in Google
- Marketers doing keyword research, schema markup and meta tags
- Developers who want a quick technical SEO audit script
Install seo-geo
Claude Code
- 1
Copy this prompt.
Install the seo-geo skill in Claude Code. Run this command: npx skills add ReScienceLab/opc-skills --skill seo-geo Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Pick one route, not both. The plugin route installs only seo-geo; its plugin.json lists the SKILL.md and the scripts folder as commands and no hooks or MCP servers. The audit script runs with python3 (the SKILL.md calls python3 scripts/seo_audit.py). The SKILL.md says it works best with the twitter and reddit skills; they are optional and can be added with --skill twitter --skill reddit.
From the project README. Source.
What's in the skill
When it loads
SEO & GEO (Generative Engine Optimization) for websites. Analyze keywords, generate schema markup, optimize for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) and traditional search (Google, Bing). Use when user wants to improve search visibility, search optimization, search ranking, AI visibility, ChatGPT ranking, Google AI Overview, indexing, JSON-LD, meta tags, or keyword research.
Sections in SKILL.md
- Quick Reference
- Workflow
- Step 1: Website Audit
- Step 2: Keyword Research
- Step 3: GEO Optimization (AI Search Engines)
- Step 4: Traditional SEO Optimization
- Step 5: Validate & Monitor
- SEO/GEO Optimization Report
- Current Status
- Recommendations
- GEO Optimizations Applied
- Platform-Specific Optimization
- ChatGPT
- Perplexity
- Google AI Overview (SGE)
- Microsoft Copilot / Bing
Key facts
- Installs on skills.sh
- 55,008 as of 2026-11-02
- GitHub stars (repo)
- 1,888 as of 2026-11-02
- Last repo commit
- 2026-11-01
- skills.sh audits
- Gen Agent Trust Hub pass, Socket pass, Snyk warn
What it includes
seo_audit.py plus curl checks
Runs `scripts/seo_audit.py` on a URL for title, meta, H1, robots, sitemap and load time. Also checks robots.txt for AI bots such as GPTBot, PerplexityBot and ClaudeBot.
Runs code ·
Step 1: Website auditWebSearch for volume, difficulty and competitors
Searches the web for keyword difficulty, volume and competitor terms.
Network ·
Step 2: Keyword researchNine methods and FAQPage schema
Cite sources, add statistics and quotations, plain language, and answer-first structure. Keyword stuffing is marked as harmful.
Write ·
Step 3: GEO optimizationMeta tags, Open Graph, JSON-LD
Templates for title, description, Open Graph and Twitter cards, plus schema types for pages, articles, products and apps.
Write ·
Step 4: Traditional SEORich Results test, schema validator, indexing
Opens Google's Rich Results Test and the Schema.org validator, checks indexing with site: searches, and writes a report.
Runs code ·
Step 5: Validate and monitorChatGPT, Perplexity, Google AI Overview, Copilot, Claude
Per-engine notes such as allowing PerplexityBot, getting indexed by Bing and by Brave Search.
Platform-specific tipsSeven scripts for keywords, SERP, backlinks and domains
keyword_research, related_keywords, autocomplete_ideas, serp_analysis, backlinks, domain_overview and competitor_gap. They need DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD.
Runs code ·
DataForSEO scripts
From the official docs
Permissions
Low risk
The audit script fetches the page you give it, and the keyword, SERP and backlink scripts call a paid DataForSEO account with your login. Use a dedicated login and check usage.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
DataForSEO scripts use a paid account
They send your keywords and domains to api.dataforseo.com with Basic auth from your environment variables, and the references call it pay-per-use. Check your usage and use a dedicated login.
The audit script fetches the URL you give it
seo_audit.py requests the page, and reads its HTML and headers. Only point it at sites you are allowed to scan.
It tells Claude to open browser pages
Step 5 uses open commands for Google's Rich Results Test, the Schema.org validator and site: searches. These send the URL you are checking to those services.
Technical details
| Talks to | The site you audit. api.dataforseo.com (DataForSEO scripts). Google and Schema.org validator pages opened in your browser |
|---|---|
| Sign-in and keys | The DataForSEO scripts read the login and password from environment variables. |
| Scopes |
|
Questions
What does seo-geo do?
It makes Claude work on both classic SEO and GEO, meaning being cited by AI search. Claude audits the site, researches keywords, applies the skill's GEO methods, writes meta tags and schema, and checks the result.
How do I install it?
Use the install box above. The README gives npx skills add ReScienceLab/opc-skills --skill seo-geo, and a Claude Code plugin route with /plugin marketplace add ReScienceLab/opc-skills then /plugin install seo-geo@opc-skills.
Does it need an API key?
Not for the basic audit. seo_audit.py needs no API. The keyword, SERP, backlink and domain scripts need DataForSEO credentials set as the environment variables DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD, and the references list DataForSEO as pay-per-use.
Are the AI visibility percentages proven?
They are the skill's table, attributed to the Princeton GEO paper (arXiv:2311.09735). Treat them as the author's summary of one study, not a guarantee for your site.
Does it work in Cursor or Codex?
The README says one command installs the collection into Claude Code, Cursor, Windsurf, Droid and 12+ other tools. The README's tagline also names Codex, but gives no Codex-specific steps.
Does it need the twitter and reddit skills?
Not required. The SKILL.md says it works best with the twitter and reddit skills for SEO tips and discussions, and with WebSearch. The README's list of skills that require others names domain-hunter, logo-creator and banner-creator, not seo-geo.
Is it safe to use?
The audit script only fetches the page you give it. The DataForSEO scripts send your keywords and domains to a paid API with your login, and Claude opens validator pages in your browser. Keep DataForSEO credentials out of your repo and review your account usage.
Information
updated Nov 2, 2026
- Repository
- resciencelab/opc-skills
- Folder
skills/seo-geo
Sources
Docs, issue trackers and discussions this page is built from.
Show all 8Hide
- resciencelab/opc-skills README · github.com
- seo-geo plugin.json · github.com
- seo-geo SKILL.md · github.com
- seo-geo references/geo-research.md · github.com
- seo-geo references/tools-and-apis.md · github.com
- opc-skills LICENSE · github.com
- seo-geo scripts/seo_audit.py · github.com
- seo-geo scripts/dataforseo_api.py · github.com