aiskillstore/marketplace / skills/aaron-he-zhu/technical-seo-checker
technical-seo-checker
VerifiedUse when the user asks to "check technical SEO"; audits crawlability, indexing, Core Web Vitals, robots.txt, sitemaps, canonicals, redirects, and migrations. Not for on-page tags or content — use on-page-seo-auditor. 技术SEO/网站速度
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.1 KB |
| references/bulk-audit-playbook.md | markdown | 4.2 KB |
| references/ecommerce-platform-patterns.md | markdown | 3.7 KB |
| references/http-status-codes.md | markdown | 2.5 KB |
| references/llm-crawler-handling.md | markdown | 4.5 KB |
| references/pre-migration-playbook.md | markdown | 6.0 KB |
| references/robots-txt-reference.md | markdown | 3.1 KB |
| references/technical-audit-example.md | markdown | 4.1 KB |
| references/technical-audit-templates.md | markdown | 6.2 KB |
| skill-report.json | config | 64.6 KB |
references/bulk-audit-playbook.md
View on GitHub# Technical SEO — Site-Wide / Bulk Audit Playbook
Referenced from [SKILL.md](../SKILL.md). Use this when the user has >5 URLs to audit (e.g., all 50 Shopify product pages are not indexed).
---
## When to use bulk mode
- User reports "X of Y pages are not indexed" (ratio problem)
- User pastes a sitemap URL or a CSV/list of URLs
- User references GSC Coverage / Indexing report exports
- E-commerce sites with facet / pagination / variant patterns
## Inputs accepted
Bulk mode accepts **any one** of the following:
1. **Sitemap URL** — `https://example.com/sitemap.xml` (or `sitemap_index.xml`)
2. **GSC Coverage export** — CSV from Search Console with columns `URL | Issue | Last crawled`
3. **URL list** — plain text, one URL per line (user paste)
4. **Crawl data** — Screaming Frog export, Sitebulb export, or `~~web crawler` MCP output
## Workflow
### Step 1 — Inventory + group
Parse input into a URL inventory. Group by content type, template (detected via URL path / meta signals / sampling 3 pages per cluster), and known issue (if GSC: indexed / excluded / crawl error / duplicate / soft 404).
```
| Group | Count | Template | Known Issue |
|--------------------|-------|----------|--------------------|
| /product/[slug] | 32 | product | Excluded by noindex |
| /collection/[slug] | 12 | category | Duplicate canonical |
| /blog/[slug] | 4 | blog | OK |
| /pages/[slug] | 2 | landing | OK |
```
### Step 2 — Sample deep, summarize shallow
Run single-URL audit on **2 representative URLs per group** (most and least recently indexed). Report pattern-level findings.
```
### Group: /product/[slug] — 32 pages
- **Pattern issue**: `<meta name="robots" content="noindex">` injected by theme on all product pages with <5 variants
- **Root cause**: Shopify theme setting "Hide products with low stock"
- **Verified on**: /product/shoes-red, /product/shoes-blue (2/32 sampled)
- **Estimated affected**: 32 pages
- **Fix**: disable the theme option OR add `variant_count > 0` override in theme.liquid L247
- **Priority**: P0
```
### Step 3 — Portfolio-level prioritization
Produce a single prioritized list across all groups:
```
P0 (fix affects 10+ pages):
1. Remove noindex from low-stock products (32 pages) — theme.liquid
2. Fix canonical conflict on collection pages (12 pages) — collection.liquid
P1 (fix affects 3-9 pages):
3. Add self-referential canonical on /blog/* (4 pages)
P2 (single-page):
4. /pages/about has meta description length 170 chars — trim
```
### Step 4 — Deliver
**Handoff Summary** adapts to bulk mode:
- **Status**: DONE | DONE_WITH_CONCERNS
- **Objective**: "Bulk audit of <inventory_size> URLs across <group_count> groups"
- **Key Findings / Output**: pattern-level issues + portfolio priority list
- **Evidence**: "Sampled N of M pages (deep audit); inferred group issues from URL structure + meta signals"
- **Open Loops**: un-sampled groups; access blockers; data freshness caveats
- **Recommended Next Skill**: `content-writer` (if content issues dominate) OR `serp-markup-builder` (if structured data issues)
## Minimum viable bulk input
```
Paste or describe your site's URL patterns:
1. Domain: [example.com]
2. How many total pages roughly? [50 / 500 / 5000]
3. Page types with approximate counts:
- Products: [~32]
- Categories: [~12]
- Blog posts: [~4]
- Pages: [~2]
4. What issue started the audit? (e.g., "40 of 50 products not indexed")
5. Any template/theme you know the issue is scoped to?
```
Then proceed from Step 1.
## E-commerce pattern reference
| Symptom | Usual root cause | Check file |
|---------|------------------|-----------|
| Variants not indexed | Canonical pointing to parent | `product.liquid` |
| Facet/filter URLs indexed | Missing `rel="noindex,follow"` on filter links | `collection.liquid` |
| Duplicate pages on `?utm=*` | No canonical to clean URL | `theme.liquid` head |
| Old products return 404 | No 301 redirect after removal | platform redirect map |
| Pagination loop | `rel="prev/next"` wrong or missing self-canonical per page | `collection.liquid` |
| Robots.txt blocks all facets (aggressive) | `Disallow: /*?*` too broad | `/robots.txt` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |