seo-monster

Google Search Console（18）

常用工具

• gsc_list_properties - 凭据可查看的资源，包含权限级别和派生出的 writable 标志（siteOwner / siteFullUser 时为 true）。
• gsc_search_analytics - 常用工具：按维度、日期范围、筛选条件和 data_state 查询点击次数 / 展示次数 / 点击率 / 排名。
• gsc_top_queries / gsc_top_pages - 便于获取排名前 N 项的封装工具。
• gsc_compare_periods - 对比当前时段与之前时段，并提供各项差异。 v0.2.0 新增了 sort_by、sort_dir、min_delta_clicks / _impressions / _position、anomalies_only + sigma_threshold，以及用于一次调用报告上升项 / 下降项 / 异常值的 top。
• gsc_inspect_url - URL 检查（索引判定、覆盖范围、规范网址）。
• gsc_batch_inspect_urls - 检查最多 25 个 URL，并收集各 URL 的失败信息。
• gsc_list_sitemaps - 已注册的站点地图及其状态。
• gsc_submit_sitemap - 提交站点地图（写入，不受限制；需要可写作用域）。接受 sitemap_url（便捷字段）或 feedpath（原始 API 字段）。
• gsc_request_indexing - 通过 Indexing API 请求重新抓取（写入，不受限制）。接受单个 url 或多个 urls。 查询智能（v0.2.0）
• gsc_query_opportunities - 已排名在前 N 位、但点击率低于目标的查询。可作为标题和元描述优化的候选项。
• gsc_query_gaps - 有展示但几乎没有点击的查询。内容机会信号。
• gsc_new_queries - 当前时间段出现、此前没有展示的查询。新兴主题。
• gsc_top_pages_by_query - 针对特定查询排名的页面。用于蚕食审查的输入。

多属性 + 生命周期（v0.5.0）

• gsc_portfolio_summary(days, include?, exclude?) - 多属性全局视图。提供最近 N 天每个属性的一行摘要（点击、展示、点击率、排名），以及整个组合的汇总数据。支持可选的 include / exclude 筛选条件。在代理机构或多品牌设置中，这是回答“整个组合表现如何？”最快的方式。
• gsc_trending_pages(days, limit) - 与前 N 天相比，最近 N 天展示量增长最多的页面。对 gsc_compare_periods 的封装，参数为 dimensions=["page"], sort_by="delta_impressions", sort_dir="desc"。
• gsc_decaying_pages(days, limit) - 同一封装，按升序排序。需要挽救的页面。
• gsc_coverage_audit(urls, site_url?) - 启发式覆盖率审计。GSC 的索引覆盖率报告未通过 API 提供；此工具接收用户提供的 URL 列表（通常从站点地图中提取），批量检查每个 URL，然后汇总判定结果（PASS / PARTIAL / FAIL）和 coverage_state 的频次。 内容智能（4）
• content_opportunities(site_url?, days?, count?, impressions_min?) - 基于你自己的 Search Console 数据，为内容主题排序：融合 CTR 与预期值之间的差距（根据你自己的各排名位置 CTR 自动校准曲线）、有望提升的排名位置、需求和趋势，计算出透明的机会评分；并标记关键词蚕食。如果已配置 GA4 媒体资源，还会根据每个主题的排名最高页面已带来的自然转化量进行加权（最高 +50%），因此能带来转化的主题排名更高；filters_applied.ga4_value_status 会报告是否已执行加权及原因（applied / no_ga4_property / ga4_unreachable / no_conversions）。优先挖掘你已有的需求；不进行从零开始的关键词研究，也不撰写内容。可与下方的内容工作流提示词搭配使用。（GA4 加权 v0.7.3）v0.9.0 为每个候选项新增一个附加的 winnability 区块（分档：有望提升的排名位置 + 主题相关度、GSC 个性化层级）；现有字段保持不变。
• content_brief_data(target_query, competitor_urls?, topic?, site_url?, days?) - 为内容简报提供数据支持：抓取竞争对手页面（或在无竞争对手页面时，回退到你自己的 GSC 排名页面），并返回标题集合、最低中位字数、Schema 类型和实体覆盖情况，以及 2026 年 GEO 写作指引和验证规则。宿主负责撰写文案；SEOMonster 提供规则和证据。为 content_brief 提示词提供支持。（v0.9.0）
• topic_cluster_map(cluster_path | pillar_url, site_url?, days?, impressions_min?)
  • 根据你自己的 GSC 数据绘制内容主题集群图，并显示缺失的子主题。根据需求和最佳排名位置，将每个集群查询分类为 defend / optimize / create / monitor；create 象限即为缺失子主题列表。标记关键词蚕食。仅使用 GSC 数据；如实说明约 47% 的查询会被匿名化。（v0.9.0）
• rank_change_attribution(url | urls, change_date, query?, site_url?, pre_days?, post_days?, gap_days?, control_scope?)
  • 通过与匹配的对照组进行双重差分，估算网站变更是否影响了页面点击量（绝不只做简单的前后对比）。返回估算的提升幅度及 95% 置信区间、三态判定（likely_positive / likely_negative / inconclusive），以及一个混杂因素区块，用于自动检测 2025 年 GSC 数据机制的中断（展示次数错误、num=100），并降低排名可靠性。此方法基于观察而非因果关系——服务器端拆分测试才是真正的因果测试。仅使用 GSC 数据。（v0.9.0） AI / GEO 引用（3，v0.9.0） - 查看 AI 答案是否会触达并引用你。
• ai_citation_readiness(url) - 页面是否采用适合大模型答案引擎提取和引用的结构？首先检查渲染盲区（GPTBot / ClaudeBot / PerplexityBot 会抓取页面，但不会运行 JS，因此对它们来说，客户端渲染的 SPA 不可见），然后根据有证据支撑的信号评分（统计数据、引述、引用来源、不堆砌关键词）。schema.org / FAQ / llms.txt 仅作为信息报告——2026 年的证据并不支持它们是 AI 引用的驱动因素，因此不纳入评分。免费，仅使用 HTTP。
• ai_referral_overview(property_id?, site_url?, days?) - 第一方 AI 流量： 来自 AI 应用的 GA4 引荐会话（包括原生 ai-assistant 渠道和可配置的来源主机正则表达式），以及 AI 爬虫 robots 覆盖情况（GPTBot、 ClaudeBot、PerplexityBot 等）。展示约 70% 的暗流量低估情况，并将 AI Overview 点击（计入自然流量）单独统计。免费。
• ai_citation_track(prompts, brand, brand_domains?, competitors?, engines?, samples?)
  • 针对一组托管提示词，抽样统计品牌提及率和引用声量份额，并与竞争对手对比，覆盖多个 AI 引擎 （Perplexity / OpenAI / Anthropic / Gemini API，以及通过 DataForSEO 获取的 Google AI Overviews）。每个提示词抽取 N 个样本（默认为 7），提供 95% 置信区间、声量份额和运行间波动性——不是“AI 排名” （单次运行在统计上毫无意义）。说明开发者 API 的输出与登录后的消费者 UI 不同，且 AIO 没有 API。付费 + 非确定性。至少需要一个引擎密钥和/或 DataForSEO。

关键词发现（3，v0.9.0） - 查找你尚未获得排名的词。

• gsc_keyword_expand(candidates, site_url?, days?, impressions_min?) - 你 （主机）根据表现最佳的查询构思候选词；此工具会用你自己的 Search Console 数据验证每个词（覆盖 / 较少 / 无），并提供同类词强度置信区间。“无”表示没有可见的覆盖情况（GSC 会隐藏约 75% 的展示次数），因此全新词项的评分属于假设。免费。
• serp_adjacency_expand(seeds, include_paa?) - 将种子词扩展为相关词。免费核心功能：Google Autocomplete（无需密钥）。可通过 DataForSEO 获取 People-Also-Ask + 相关搜索。返回每个种子的建议，以及汇总后的全新词项；没有密钥也能正常提供有限功能。
• keyword_universe(target_domain?, competitors?, keywords?, limit?) - 可选，付费。核心价值：竞争对手关键词差距（DataForSEO Domain Intersection；Google 没有对应功能）。可选通过供应商链获取搜索量 / 难度 / 意图（DataForSEO，否则仅通过 Google Ads 获取搜索量）。外部搜索量是精度较低的方向性信号——仅用于平局时决胜，绝不作为门槛。

Google Analytics 4（7）

• ga4_run_report - 核心工具：支持任意维度 / 指标 / 日期范围，以及可选的维度筛选和排序。
• ga4_top_landing_pages - 热门着陆页，默认仅包含自然流量。
• ga4_traffic_by_channel - 按渠道组统计会话 / 互动 / 转化。
• ga4_organic_search_overview - 自然流量总计以及逐日趋势。
• ga4_setup_audit(property_id?) - 只读的 SEO 衡量就绪情况审计： Web 数据流、关键事件、数据保留期限、内容组维度，以及 （v0.7.4）增强型衡量、站内搜索和 Google Signals。 按严重程度分级，并为每个发现提供合理的例外情况。通过 REST 调用 GA4 Admin API （analytics.readonly；无需额外依赖）。（v0.7.0）
• ga4_site_search(days?, limit?) - 站内搜索查询报告（直接反映内容缺口的信号）；没有真实搜索词时会如实返回空结果。（v0.7.1）
• ga4_landing_page_conversions(days?, organic_only?, limit?) - 按转化次数排名的自然流量 着陆页。（v0.7.1） PageSpeed Insights（2 项）
• psi_analyze - 针对 URL 的 Lighthouse 评分、实验室 Core Web Vitals 和现场（CrUX）Core Web Vitals。默认采用移动设备策略。现场数据附带 field_data_note：Google 正在弃用 PSI 现场数据，因此请使用 crux_snapshot / crux_history 获取持久的现场指标。
• psi_opportunities(url, strategy?) - 可执行的 Lighthouse“机会”审计（含预估收益），以及按严重程度分级的 SEO 类别审计。仅限实验室数据。这是一份页面基础检查清单，不是排名预测工具。（v0.7.1） Cloudflare（13）
• cf_list_zones - 列出令牌可查看的区域。
• cf_zone_info - 查看区域的状态、套餐和名称服务器。
• cf_list_dns - DNS 记录（只读）；在迁移期间可用于验证规范主机和 TXT 验证记录。
• cf_web_analytics - 只读边缘 Web Analytics（RUM），可与 GA4 对比。对于某些站点，Cloudflare 返回的 host: null；传入 site_tag 可显式查找这些站点。
• cf_purge_cache - 清除指定 URL 的缓存（受限）。
• cf_purge_cache_all - 清除整个区域的缓存（受限 + 确认令牌）。
• cf_settings_audit(zone?) - 只读审计与 SEO 相关的 Cloudflare 区域设置（SSL 模式、Always-Use-HTTPS、HSTS、Automatic HTTPS Rewrites、Brotli、缓存 TTL）。按严重程度分级，并遵循“验证而非判定失败”的原则，因为 CF 无法查看源站；HSTS 永远不会被判定为硬性失败。令牌需要具有 Zone Settings Read 权限。每条发现都附带机器可读的 fix 提示（准确的 cf_settings_update 设置 + 推荐值），以便串联审计 -> 修复。（v0.7.1）
• cf_settings_update(settings, zone?, confirm?, acknowledge_hsts_risk?, dry_run?)
  • 写入审计评级涉及的 SEO/爬取/安全设置（SSL 模式、Always-Use-HTTPS、Automatic HTTPS Rewrites、Brotli、浏览器缓存 TTL、HSTS），形成审计 -> 修复闭环。受限。ssl_mode 或任何提高 HSTS 的操作都需要 confirm=<zone>（提高 HSTS 还需要 acknowledge_hsts_risk=true）；会在本地验证，支持 dry_run，并重新运行审计，以便查看发现是否已消除。需要 Zone Settings:Edit 权限（而审计只需 Read）。（v0.7.10）
• cf_list_redirects(zone?) - 列出区域的单条（动态）重定向规则，以及账户的 Bulk Redirect 列表（只读）。进行任何重定向写入前请先调用，以免覆盖现有内容。（v0.7.8；v0.7.9 添加了 Bulk 列表）
• cf_create_redirect(source, target, status_code?, ...) - 创建一条边缘重定向（例如，为更名后的 URL 创建 301 重定向）。受限。会预先检查目标（不会重定向到失效 URL），拒绝循环/重复项，支持 dry_run。（v0.7.8）
• cf_delete_redirect(rule_id, zone?) - 按 id 删除单条重定向规则（用于回滚 cf_create_redirect）。受限。（v0.7.8）
• cf_bulk_redirect_upsert(items, list_name, confirm, ...) - 通过账户级 Bulk Redirect List 一次创建/追加多条重定向（用于迁移）。 受限 + 需要与 list_name 相同的确认令牌。会先在本地验证每一项，任何项目无效都会拒绝整个批次（绝不会只应用一部分）；支持 dry_run。（v0.7.9）
• cf_managed_robots(action, zone?, ...) - 获取 / 配置 / 禁用 Cloudflare 托管的 robots.txt 和 Content-Signals 策略（这些功能依托于区域的 Bot Management 配置）。action="get" 会读取当前状态（只读、不受限）。action="configure" 会设置托管 robots.txt（managed_robots）、Content-Signals 变体（cf_robots_variant：off / policy_only）以及 AI 爬虫屏蔽开关（ai_bots_protection、content_bots_protection、crawler_protection）。action="disable" 会关闭托管 robots.txt 和策略。在 Cloudflare 中，托管 robots.txt 和 Content-Signals 策略互斥，因此有效组合为 managed_robots=true + cf_robots_variant="off"（托管 robots.txt）或 managed_robots=false + cf_robots_variant="policy_only"（策略）；工具会在本地拒绝无效组合，并返回 INVALID_INPUT。自定义 Content-Signal 行（例如来自 robots_ai_posture）不是托管选项，应将其写入源站 robots.txt。写入操作受限，需要 confirm=<zone>，并支持 dry_run；读取操作是安全的（GET -> overlay -> PUT，因此不会覆盖配置中的其他内容）。每个响应都会附带说明，区分声明偏好的信号（Content-Signals，仅被选择遵循的爬虫采纳，Googlebot 会忽略）与实际在边缘执行管控的开关。写入需要 Bot Management:Edit 权限（get 需要 Read）。（v0.8.2） IndexNow（2，v0.2.0）
• indexnow_submit(url) - 向 Bing、Yandex、Naver、Seznam、Yep 提交单个 URL。它与 gsc_request_indexing 互为补充（而非替代），后者只与 Google 通信。需要设置 SEO_MCP_INDEXNOW_KEY，并在 https://<your-host>/<key>.txt 提供验证文件（完整密钥、文件格式和同主机规则请参阅 IndexNow 设置）。
• indexnow_bulk_submit(urls) - 通过单个 POST 提交最多 10,000 个属于同一主机的 URL。客户端会在任何网络调用发生前拒绝混合主机的批次，并返回 INVALID_INPUT。如果 CDN 会重写 /key.txt 路径，环境变量 SEO_MCP_INDEXNOW_KEY_LOCATION 可覆盖默认的验证文件 URL。

技术 SEO（8，v0.3.0） - 无需凭据；内置 HTTP 客户端。

• inspect_meta(url) - 一次调用检查页面表层信息：标题、meta 描述、meta robots、canonical、Open Graph 和 Twitter Card 标签、hreflang、H1 数量。
• check_canonical(url) - canonical 链接审计：自引用／跨主机／协议不匹配／尾部斜杠不一致／canonical 目标是否可访问。
• mixed_content_check(url) - 解析 HTTPS 页面并标记所有 http:// 引用（img／script／iframe／表单 action／srcset）。对 http:// 不执行任何操作。
• redirect_chain_audit(url, max_redirects=10) - 逐跳遍历重定向链。标记过长的链、协议降级、循环和非 2xx 终点。
• robots_txt_validate(site_url, probes?) - 解析 robots.txt（按组划分的规则、站点地图和 Content-Signals）；可选地根据 RFC 9309 最长匹配规则判定（user_agent、url）探测项（与 Google 和 Bing 的实际行为一致，而非标准库的首匹配规则）。还会检测边缘缓存过期的 robots.txt（通过缓存破坏进行比较，并从最新内容重新解析），以及覆盖源站策略的 Cloudflare 托管 robots.txt／Content-Signals，从而发现迁移站点或由 Cloudflare 前置的站点上看似正常的 robots。（v0.8.0）
• sitemap_validate(sitemap_url) - 验证站点地图或站点地图索引 XML，统计条目数，并标记超大文件、跨主机条目和缺少 lastmod 的情况。自动处理 .gz。
• sitemap_health(sitemap_url, sample_size=25) - 对抽样 URL 进行 HEAD 审计。提供状态码直方图和首批非 2xx 示例。
• robots_ai_posture(goal?, sitemap_url?) - 针对 Content-Signals 调节项（search／ai-input／ai-train）提供确定性的离线建议工具。接受业务目标（默认为 content_authority，也可选 maximize_visibility／protect_ip），推荐一种策略并给出通俗易懂的理由，列出权衡后的备选方案，并生成可直接应用的产物：Content-Signal: 指令行及完整的建议 robots.txt。不访问网络，也不写入任何内容。每个响应都包含强制说明：只有采用该机制的爬虫才会遵循 Content-Signal；Googlebot 会忽略它；它也不是排名因素。（v0.8.1）

Chrome UX Report（2）

• crux_history(url? | origin?, form_factor?, metrics?) - 通过 CrUX History API 获取 25 周的 p75 Core Web Vitals。复用 PSI_API_KEY；未配置密钥时可匿名使用，但速率限制更严格。
• crux_snapshot(url? | origin?, form_factor?) - 获取当前的 p75 Core Web Vitals（时间点快照，与历史数据相对）。每项指标都会报告一个类别（GOOD／NEEDS_IMPROVEMENT／POOR）；汇总评分为 overall_category。时间指标使用 p75_ms；无单位的 CLS 使用 p75。数据量较少的来源会返回 no_data 封装对象。（v0.7.1） 结构化数据 + 跨站点 + 页面内（7）——无需新凭据（v0.9 的 SERP 自动获取为可选项）。
• inspect_schema(url)——提取页面中的所有 JSON-LD 块；报告各 schema.org @type 的数量及每种类型的一个示例实体。
• validate_schema(url, types?)——根据 Google Rich Results 必需字段集，对每个 JSON-LD 实体给出判定。涵盖 Article、NewsArticle、BlogPosting、Product、FAQPage、BreadcrumbList、Organization、LocalBusiness、Event、Review、Recipe。提供每个实体的判定，以及 missing_required 和 missing_recommended 列表。
• hreflang_consistency_check(urls)——对用户提供的一组 URL 进行跨页面 hreflang 审核。标记缺少互相指向、hreflang 目标失效、单个页面上的 hreflang 重复、缺少自链接，以及有 3 种以上语言变体时缺少 x-default 的情况。
• internal_link_graph(start_url, max_depth=2, max_pages=50)——在同一主机内进行小规模 BFS 抓取。提供每个页面的入度和出度、孤立页面、失效的站内链接及深度分布。设有硬性上限（max_depth <= 4、max_pages <= 200），确保误用时不会压垮主机。
• lighthouse_budget(url, budget)——封装 psi_analyze，并根据预算字典对结果作出判定，例如 {performance: 80, LCP_ms: 2500, CLS: 0.1}。提供各项指标的通过/失败结果及总体判定。适用于 LLM 会话中的 CI / 部署前检查。复用 PSI_API_KEY。
• internal_link_recommend(start_url, site_url?, days?, position_min?, position_max?, relevance_floor?, limit?)
  • 根据高入度页面，向 GSC 中排名接近首页的页面（默认排名 8-20 且有实际展示量）推荐具体的来源页面 -> 目标页面站内链接，并提供锚文本。按词汇相关性 + 站内权威性对来源页面排序，跳过已链接到目标页面的页面，平衡锚文本，且绝不推荐 nofollow 链接。基于 internal_link_graph + GSC 构建。免费。（v0.9.0）
• onpage_serp_gap(target_url, query?, competitor_urls?, max_competitors?)——找出顶级 SERP 结果中存在、而目标页面缺少的标题、实体和结构化数据，并将其转化为页面内优化操作。调用方提供 competitor_urls 时可免费使用；也可通过 query 选择 DataForSEO SERP 自动获取，该模式还会返回可争取排名的信号（serp_composition 中的 AI-Overview / UGC 零点击风险），并在搭配 Open PageRank 时返回竞争对手域名权威度。突出信息增益，而不只是达到同等水平。会过滤掉模板/导航标题（基于模式的页面框架过滤器）。（v0.9.0；v0.9.1 修复 F6，v0.9.2 泛化 F1）

每个工具的 tools/list 条目都包含 MCP 标准注解 （readOnlyHint、destructiveHint、idempotentHint、openWorldHint），方便 MCP 宿主决定自动批准哪些操作，以及哪些操作需要确认。