SEO Master Skill
piyushsoni-ai/seo-master-skill
Auditor SEO sênior para agentes Claude, Cursor e MCP servers
Ver no GitHubSkill de SEO avançado para agentes de IA que realiza auditorias técnicas, pesquisa de concorrentes, análise de backlinks, SEO local e AEO/GEO. Integrado nativamente com Apify como camada de dados, oferece relatórios prontos para clientes e planos de crescimento SEO estruturados em 30/60/90 dias.
Instalação
npx convez-ai piyushsoni-ai/seo-master-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Auditorias técnicas de websites (crawlability, schema, JavaScript rendering)
- Pesquisa de concorrentes e mapeamento de oportunidades de keywords
- Avaliação de perfil de backlinks e estratégias de construção de autoridade
- Otimização para Answer Engines e busca por IA (AEO/GEO)
- Planejamento estratégico de SEO com cronograma cliente-ready
Veredito

Ferramenta madura e bem-estruturada para equipes que precisam de SEO profissional integrado em agentes. A arquitetura modular em arquivos e o foco em dados reais (via Apify) a diferenciam de prompts genéricos; exige conhecimento técnico de SEO para máximo aproveitamento.
README
A tradução para o português deste README ainda está na fila.
Apify-First Release Note
SEO Master 1.0.2 uses Apify as the primary data layer. The skill should ask for only APIFY_API_TOKEN by default, then use Apify actors for crawling, SERP, competitors, Maps/local, reviews, Trends, PageSpeed/Lighthouse, GSC/GA4-style connector or export workflows, and backlink/authority checks where available.
Other APIs should not be requested up front. They are only optional later if Apify cannot fetch the needed data or if a private authenticated account/export is required.
SEO Master
Universal Agent Compatibility
This release is designed to be portable across Codex, Claude Projects, OpenClaw, Cursor, MCP-enabled agents, and custom file-based AI agents.
For Codex-style skill loading, SKILL.md now includes YAML frontmatter at the top. For Claude/OpenClaw/custom agents, load the full folder and instruct the agent to read SKILL.md first, then use the supporting modules as needed.
Release Maturity Note
This is a complete structure release with deep core modules and several concise specialist modules. Shorter modules are intentional lightweight playbooks that define the workflow and should be expanded later only when a project needs deeper industry-specific SOPs.
SEO Master is a portable AI-agent skill for serious SEO, AEO/GEO, local SEO, competitor research, backlink evaluation, and client-ready SEO growth planning.
This skill is designed to work across different AI-agent environments, including Codex, Claude Projects, OpenClaw, Cursor, MCP-style agents, and custom local agents.
It is intentionally built as a file-based operating system rather than a single prompt. Each file teaches the agent how to think, what to check, how to use available tools, how to fall back when tools are missing, and how to produce practical, evidence-based outputs.
What SEO Master Is
SEO Master is a senior SEO strategist inside an agent.
It should be able to:
- audit a website technically;
- inspect page architecture and crawlability;
- identify thin pages, missing headings, duplicate metadata, schema gaps, and JavaScript-rendering issues;
- check current keyword opportunities when data is available;
- compare competitors;
- map keywords to service pages, course pages, product pages, or supporting articles;
- create 30/60/90-day SEO plans;
- evaluate backlinks and authority gaps;
- suggest safe free and paid backlink strategies;
- audit local SEO and Google Business Profile opportunities;
- evaluate AEO/GEO readiness for answer engines and AI search;
- create client-ready reports and developer briefs.
What SEO Master Is Not
SEO Master is not:
- a generic SEO checklist;
- a keyword stuffing prompt;
- a backlink spam system;
- a fake guarantee machine;
- a “write more blogs” assistant;
- a high-DA worshipper;
- a tool that invents rankings or search volume.
If data is missing, SEO Master must say the data is missing.
Phase 1 Files
Phase 1 creates the core brain and operating rules.
seo-master/
├── SKILL.md
├── _meta.json
├── README.md
├── setup.md
├── onboarding.md
├── capability-detection.md
└── audit-modes.md
SKILL.md
The master instruction file. Defines the role, rules, audit workflow, no-fluff behavior, data quality standards, SEO/AEO/backlink/local logic, and required reporting structure.
_meta.json
Machine-readable metadata for agent systems. Includes skill name, version, supported environments, optional environment variables, and quality rules.
README.md
Human-facing overview. Explains what the skill does and how the file structure works.
setup.md
Installation and configuration instructions for Codex, Claude Projects, OpenClaw, Cursor, and custom agent systems.
onboarding.md
The standard opening process the agent uses when a user requests an SEO task. It explains what information to request, what not to over-ask, and how to proceed with limited data.
capability-detection.md
The logic for detecting available tools, APIs, exports, and files before choosing an audit mode.
audit-modes.md
Defines the five audit modes:
- Full Intelligence Mode
- Apify Intelligence Mode
- Native Agent Scraping Mode
- File Analysis Mode
- Advisory Mode
Recommended Optional Inputs
For the strongest audit, provide:
Website URL
Target country/city
Business type
Main services/products/courses
Competitor URLs
Google Search Console export
Google Analytics export
Google Business Profile export/access
Ahrefs/Semrush/Moz exports or screenshots
Screaming Frog/Sitebulb crawl export
Apify API token
But the skill must still work without these, using the best available mode.
Primary Environment Variable
APIFY_API_TOKEN
SEO Master is Apify-first because Apify can act as a flexible SEO data layer for crawling, SERP scraping, maps/local checks, trends, authority-style scrapers, and competitor research.
If Apify is not available, SEO Master falls back to native browsing/scraping/search tools, uploaded files, or advisory workflows.
Standard Output Philosophy
Every useful SEO Master output must tell the user:
What was checked
What was found
Why it matters
What to do next
What priority it has
What data is missing
Every recommendation must connect to at least one of:
Ranking
Qualified traffic
Crawlability
Indexability
Topical authority
Local visibility
Backlink authority
AEO/GEO visibility
Conversion
Measurement
Risk reduction
Build Roadmap
Phase 1: Core Brain
Complete.
Phase 2: Apify + Scraping Engine
Included files:
integrations/apify.md
integrations/apify-actor-registry.md
integrations/apify-workflows.md
integrations/native-agent-scraping.md
integrations/fallback-without-apis.md
Phase 3: Audit Engine
Included files:
audit/full-site-audit.md
audit/technical-seo-audit.md
audit/on-page-seo-audit.md
audit/content-quality-audit.md
audit/schema-audit.md
audit/conversion-seo-audit.md
Phase 4: Keyword + Competitor Engine
Complete files:
keyword-research/keyword-discovery.md
keyword-research/keyword-clustering.md
keyword-research/keyword-to-page-map.md
competitor-research/competitor-discovery.md
competitor-research/serp-gap-analysis.md
competitor-research/content-gap-analysis.md
Phase 5: AEO/GEO Engine
Complete files:
aeo-geo/ai-search-readiness.md
aeo-geo/answer-engine-optimization.md
aeo-geo/entity-seo.md
aeo-geo/topical-authority.md
Phase 6: Local + Backlink Engine
Complete files:
local-seo/google-business-profile.md
local-seo/map-pack-audit.md
backlink-system/backlink-audit.md
backlink-system/free-backlink-posting.md
backlink-system/paid-backlink-evaluation.md
backlink-system/backlink-quality-scoring.md
backlink-system/backlink-outreach-prompts.md
Phase 7: Reporting + Templates
Included files:
strategy/30-day-plan.md
strategy/60-day-plan.md
strategy/90-day-plan.md
strategy/500-query-growth-model.md
reporting/client-audit-report.md
reporting/proposal-style-report.md
templates/seo-audit-report-template.md
templates/keyword-map-template.csv
templates/backlink-prospect-template.csv
examples/sample-final-audit-output.md
Non-Negotiables
SEO Master must never:
- guarantee rankings;
- invent keyword/search/backlink data;
- recommend spam links;
- treat DA/DR as the only backlink quality signal;
- ignore conversion when lead goals are mentioned;
- ignore local SEO for local businesses;
- ignore E-E-A-T for YMYL niches;
- call AEO/GEO a strategy without explaining exact actions;
- give 100 tasks with no priority.
Good SEO is not activity. Good SEO is a system that increases qualified visibility and turns that visibility into business outcomes.
Backlink Source Library Seed
A Phase 6 seed file has been added early at backlink-system/free-paid-backlink-source-library.md so the skill remembers the user's backlink document categories and free/paid backlink evaluation rules.
AI-Friendly SEO Expansion — 1.0.3
SEO Master now includes a dedicated AI-friendly SEO workflow.
When a user asks for AI-friendly SEO, the skill audits:
Traditional SEO
AEO: answer readiness
GEO: AI citation/source-worthiness
Entity SEO: knowledge graph clarity
Reputation SEO: proof stack
Conversation SEO: full human question coverage
Use Apify first for crawling, SERP/PAA, competitors, Maps/local, reviews, Trends, PageSpeed/Lighthouse, third-party mentions, and authority/backlink checks.