出海助手-SEO审计 / SEO Audit
> 本技能改造自开源技能 seo-audit（来源：TerminalSkills/skills，TerminalSkills 开源技能库）。已完整保留原始运行文件（scripts/references/assets 与 LICENSE），并新增中文出海使用说明。原始英文说明见文末「English (Original)」与同目录 SKILL.original.md。
功能说明 / Functional Overview
对网站做 SEO 审计：技术、内容、外链与体验，给出可执行的优化清单。
适用场景 / Use Cases
- 出海网站 SEO 体检
- 关键词与内容差距
- 技术 SEO 修复
使用方法 / How to Use
- 给出站点 URL 与目标，技能产出审计结果与优先级。
示例 / Examples
- 「出海网站 SEO 体检」——用自然语言把任务交给本技能即可。
限制说明 / Limitations
- 需要外部服务/凭证的技能，请先完成授权配置后使用。
- 本技能为开源技能的中文本地化版本，核心逻辑与原技能一致；如遇专业术语，正文保留英文原词（如 Shopify、SEO、GA4 等）。
English (Original) / 英文原文（完整保留）
> The section below is the original skill definition, preserved verbatim for traceability and full functionality.
SEO Audit
Overview
You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance.
Check for product marketing context first:
If .claude/product-marketing-context.md exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Instructions
Initial Assessment
Before auditing, understand:
- Site Context - What type of site (SaaS, e-commerce, blog)? Primary business goal for SEO? Priority keywords/topics?
- Current State - Known issues or concerns? Current organic traffic level? Recent changes or migrations?
- Scope - Full site or specific pages? Technical + on-page, or one focus area? Access to Search Console / analytics?
Audit Priority Order
- Crawlability & Indexation (can Google find and index it?)
- Technical Foundations (is the site fast and functional?)
- On-Page Optimization (is content optimized?)
- Content Quality (does it deserve to rank?)
- Authority & Links (does it have credibility?)
Technical SEO Audit
Crawlability:
- Robots.txt: Check for unintentional blocks, verify important pages allowed, check sitemap reference
- XML Sitemap: Exists and accessible, submitted to Search Console, contains only canonical indexable URLs
- Site Architecture: Important pages within 3 clicks of homepage, logical hierarchy, no orphan pages
- Crawl Budget (large sites): Parameterized URLs controlled, faceted navigation handled, no session IDs in URLs
Indexation:
- Run site:domain.com check, review Search Console coverage, compare indexed vs. expected page count
- Check for: noindex on important pages, canonicals pointing wrong, redirect chains/loops, soft 404s, duplicate content
- Canonicalization: All pages have canonical tags, HTTP to HTTPS, www vs. non-www consistency, trailing slash consistency
Core Web Vitals:
- LCP (Largest Contentful Paint): < 2.5s
- INP (Interaction to Next Paint): < 200ms
- CLS (Cumulative Layout Shift): < 0.1
- Speed factors: TTFB, image optimization, JavaScript execution, CSS delivery, caching, CDN, font loading
Mobile & Security:
- Responsive design, proper tap targets, viewport configured, no horizontal scroll, same content as desktop
- HTTPS everywhere, valid SSL, no mixed content, HTTP to HTTPS redirects
On-Page SEO Audit
Title Tags: Unique per page, primary keyword near beginning, 50-60 characters, compelling and click-worthy. Watch for duplicates, truncation, keyword stuffing, or missing titles.
Meta Descriptions: Unique per page, 150-160 characters, includes primary keyword, clear value proposition with call to action.
Heading Structure: One H1 per page containing primary keyword, logical hierarchy (H1 > H2 > H3), headings describe content not just styling.
Content Optimization: Keyword in first 100 words, related keywords naturally used, sufficient depth for topic, answers search intent, better than competitors. Flag thin content, doorway pages, and duplicate content.
Image Optimization: Descriptive file names, alt text on all images, compressed sizes, modern formats (WebP), lazy loading, responsive images.
Internal Linking: Important pages well-linked, descriptive anchor text, no broken links, no orphan pages.
Content Quality Assessment
E-E-A-T Signals:
- Experience: First-hand experience, original data, real examples
- Expertise: Author credentials visible, accurate detailed information
- Authoritativeness: Recognized in space, cited by others
- Trustworthiness: Accurate info, transparent about business, contact info, privacy policy, HTTPS
Common Issues by Site Type
SaaS: Product pages lack depth, blog not integrated with product pages, missing comparison pages, thin feature pages.
E-commerce: Thin category pages, duplicate product descriptions, missing product schema, faceted navigation creating duplicates.
Content/Blog: Outdated content, keyword cannibalization, no topical clustering, poor internal linking.
Output Format
Structure the audit report as:
1. Executive Summary - Overall health, top 3-5 priority issues, quick wins
2. Technical SEO Findings - Each issue with: Issue, Impact (High/Medium/Low), Evidence, Fix, Priority
3. On-Page SEO Findings - Same format
4. Content Findings - Same format
5. Prioritized Action Plan - Critical fixes, high-impact improvements, quick wins, long-term recommendations
References
- AI Writing Detection: Common AI writing patterns to avoid
- AEO & GEO Patterns: Content patterns optimized for answer engines and AI citation
Tools Referenced
Free: Google Search Console, PageSpeed Insights, Bing Webmaster Tools, Rich Results Test, Schema Validator
Paid (if available): Screaming Frog, Ahrefs / Semrush, Sitebulb, ContentKing
Examples
Example 1: Technical SEO Audit for a B2B SaaS Marketing Site
User prompt: "Our website acmeanalytics.com dropped 35% in organic traffic after a Next.js migration last month. Can you audit what went wrong?"
The agent will check for product marketing context, then systematically audit the migration:
- Review robots.txt and XML sitemap for blocking issues introduced during migration
- Check for broken redirect chains from old URLs to new URL structure
- Verify canonical tags are correctly self-referencing and not pointing to old domain paths
- Audit Core Web Vitals since JS-heavy frameworks often introduce LCP and CLS regressions
- Check that server-side rendering is working (view source vs. rendered DOM)
- Verify meta tags, H1s, and structured data survived the migration intact
- Deliver a prioritized report: critical indexation fixes first, then technical performance, then on-page recovery items
Example 2: On-Page SEO Review for an E-commerce Category Page
User prompt: "Our 'wireless earbuds' category page on techgearshop.com ranks on page 3. Competitors are on page 1. What's wrong with our page and how do we fix it?"
The agent will perform a focused on-page audit comparing the page against top-ranking competitors:
- Audit the title tag, meta description, and H1 for keyword placement and compelling copy
- Assess content depth: top-ranking pages for "wireless earbuds" typically have 1,500+ words with buying guides, comparison tables, and FAQ sections
- Check for proper product schema markup on individual listings and category-level BreadcrumbList schema
- Review internal linking: is the category page linked from the homepage nav, related categories, and blog content?
- Flag thin content issues: if the page is just a product grid with no editorial content, recommend adding a buying guide intro, comparison chart, and FAQ section
- Provide a content brief with specific sections to add, target word count, and internal linking opportunities
Guidelines
- Always check
.claude/product-marketing-context.mdbefore asking discovery questions - Start every audit with crawlability and indexation before moving to on-page issues, since nothing else matters if Google cannot find the pages
- Provide specific, actionable fixes rather than vague recommendations like "improve your content"
- Prioritize findings by impact: critical indexation blockers first, then high-impact performance issues, then incremental on-page improvements
- Always compare against top-ranking competitors for target keywords to identify content gaps
- Flag quick wins separately so the user can get early results while working on larger fixes
- Include evidence for every finding: show the specific URL, the specific issue, and how you identified it
- For site migrations, always check redirect mapping completeness as the first diagnostic step
- Reference free tools (Search Console, PageSpeed Insights) before paid tools since not every user has Ahrefs or Semrush access
