用途
本技能用于指导如何有效使用 seo-mcp 的 MCP 工具。它明确说明自身不教授 SEO 概念，相关概念请参考其他技能。其定位是工具使用指南，帮助使用者了解每个工具的用途、速度、参数与调用顺序。
主要能力
工具被划分为若干类别。
A. 页面分析（10 个工具，始终可用，无需 API 密钥）
- analyze_page：综合页面 SEO 分析，含 Flesch-Kincaid 可读性、文本与 HTML 比例、当 includeContent=true 时的薄内容检测，速度 2-5 秒。
- analyze_headings：标题结构校验，1-3 秒。
- analyze_images：图片 alt 文本、尺寸、格式审计，2-10 秒。
- analyze_internal_links：链接映射、锚文本、失效链接，2-15 秒。
- extract_schema：结构化数据提取与校验，2-5 秒。
- analyze_robots_txt：robots.txt 解析与分析，1-2 秒。
- analyze_sitemap：XML 站点地图校验，2-10 秒。
- audit_security_headers：检测 HSTS、CSP、X-Frame-Options、X-Content-Type-Options、Referrer-Policy、Permissions-Policy 及混合内容，2-5 秒。
- analyze_url_structure：URL 长度、深度、HTTPS、大写、下划线、参数、文件扩展名，小于 1 秒。
- validate_hreflang：hreflang 语言代码、x-default、自引用、返回链接校验，5-30 秒。
B. 性能（2 个工具，免费，可选 API 密钥提高限额）
- check_core_web_vitals：LCP、INP、CLS 及 Lighthouse 分数，10-30 秒。
- check_mobile_friendly：移动端可用性评估，10-20 秒。
C. 调研（4 个工具，需 DataForSEO 或 Moz API 密钥）
- research_keywords：搜索量、难度、相关关键词，3-10 秒。
- analyze_serp：SERP 特性、顶部结果，3-10 秒。
- analyze_backlinks：外链概况、引用域，3-10 秒。
- analyze_domain_authority：DA/DR 指标，2-5 秒。
D. Google Search Console（3 个工具，需 OAuth2 配置）
- gsc_performance：点击、展示、CTR、排名，2-5 秒。
- gsc_index_coverage：索引状态、错误、警告，2-5 秒。
- gsc_sitemaps：已提交站点地图状态，1-3 秒。
E. 生成（3 个工具，始终可用）
- generate_schema：创建 JSON-LD 标记，小于 1 秒。
- generate_robots_txt：创建 robots.txt 文件，小于 1 秒。
- generate_meta_suggestions：建议改进的 meta 标签，2-5 秒。
F. 站点爬虫（3 个工具，始终可用，无需 API 密钥）
- crawl_site：启动 BFS 站点爬取，返回 crawl ID（异步任务模式），立即返回。
- crawl_status：检查爬取进度，立即返回。
- crawl_results：聚合问题、重复项、重定向链、逐页详情，立即返回。
系统（1 个工具）
- seo_tools_documentation：工具文档与快速参考。
使用方式
常见工作流
工作流 1：完整页面审计，适用于用户要求审计某页面时。步骤为首选 analyze_page(url, { includeContent: true, followRedirects: true }) 获取总体分数与主要问题，随后仅在发现问题时依次深入 analyze_headings、analyze_images、check_core_web_vitals、extract_schema、generate_meta_suggestions。关键原则是从范围最广的 analyze_page 开始，仅当发现问题才用具体工具深入。
工作流 2：整站爬取，先 crawl_site(url, { maxPages: 100, maxDepth: 10 }) 立即返回 crawl ID，再轮询 crawl_status 直至完成，最后用 crawl_results 搭配不同 filter 获取摘要、高严重度问题、重复项与重定向链。
工作流 3：技术站点审计，依次使用 analyze_robots_txt、analyze_sitemap、analyze_page（首页）、audit_security_headers、check_core_web_vitals、check_mobile_friendly，若具备 GSC 则调用 gsc_index_coverage。
工作流 3：内容优化，使用 analyze_page、analyze_headings（带 targetKeyword）、generate_meta_suggestions，若可用 API 则补充 research_keywords 与 analyze_serp。
工作流 4：竞品分析，对每个竞品调用 analyze_page，若可用 API 则调用 analyze_domain_authority、analyze_backlinks、analyze_serp。
工作流 5：Schema 实施，先 extract_schema 检查现有结构化数据，再用 generate_schema 生成正确 JSON-LD，实施后再次 extract_schema 验证。
工具参数参考
文档列出各主要工具的参数、类型、默认值与说明，例如 analyze_page 的 url（必填）、includeContent（默认 false）、followRedirects（默认 true）、userAgent（默认 SEO-MCP-Bot/1.0）、renderJs（默认 false）；check_core_web_vitals 的 strategy（默认 mobile）、categories（默认 performance 与 seo）；research_keywords 的 keywords（必填，最多 100 个）、location（默认 United States）、language（默认 en）、includeRelated（默认 true）；crawl_site 的 maxPages、maxDepth、concurrency、respectRobotsTxt、includePatterns、excludePatterns 等。此外还记录了 detect_orphan_pages、compare_crawls、list_crawls、audit_accessibility 等工具的参数。
API 密钥配置
无需密钥的始终可用工具合计 23 个：11 个分析工具、2 个性能工具、3 个生成工具、6 个爬虫工具、1 个文档工具。可选配置包括 PageSpeed API 密钥（将限额从每 100 秒 25 次提升到 400 次，设置 PAGESPEED_API_KEY）、DataForSEO（设置 DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD）、Moz（设置 MOZ_ACCESS_ID 与 MOZ_SECRET_KEY）、Google Search Console（设置 GSC_CLIENT_ID、GSC_CLIENT_SECRET、GSC_REFRESH_TOKEN）。
适用场景
适用于需要对网页执行页面分析、整站爬取审计、技术审计、内容优化、竞品分析与 Schema 实施的场景，尤其适合以工具调用为核心的操作指导。
限制与常见错误
不要跳过 analyze_page 直接调用具体工具；调研类工具需要 API 密钥，未配置时会返回错误，可建议用户使用手动调研或 Google Keyword Planner 等免费替代；check_core_web_vitals 默认移动优先；analyze_headings 的 targetKeyword 为可选但建议先向用户确认目标关键词；renderJs 需要 puppeteer 且更慢，仅对客户端渲染的 SPA 使用。资料中未提供收费标准、价格或具体效果保证等信息。