GSC + WP + SEO · 产品使用与部署手册

版本：4.8.9 ｜工具集：GSC + WP + SEO（22 工具） ｜远程托管 + 本地部署

GSC + WP + SEO 提供 Google Search Console 搜索数据、WordPress 内容读取与 SEO 机会分析，全部只读。

一、产品概述

22 个只读工具：Google Search Console（8）、WordPress（11）、SEO（3）。
端点（同一 Token 通用）：
GSC：https://mcpweb.wjjnew.cn/gsc/mcp
WordPress：https://mcpweb.wjjnew.cn/wp/mcp
SEO：https://mcpweb.wjjnew.cn/seo/mcp
聚合（22 工具）：https://mcpweb.wjjnew.cn/gsc-wp/mcp
鉴权：Authorization: Bearer mcp_sk_xxx。
需要自配 GSC / WordPress 凭据（控制台「数据源」，加密存储、仅本人可用）。
控制台：https://mcpweb.wjjnew.cn/。

二、工具清单（22）

Google Search Console（8，只读） gsc_list_sites、gsc_search_analytics、gsc_top_queries、gsc_page_performance、gsc_query_page_pairs、gsc_compare_periods、gsc_url_inspection、gsc_list_sitemaps

WordPress（11，只读） wp_get_posts、wp_get_pages、wp_get_post_by_url、wp_get_post、wp_search、wp_get_categories、wp_get_tags、wp_get_media、wp_get_site_info、wp_get_cpt、wp_get_woo_products

SEO（3） seo_find_opportunities、seo_audit_url、seo_ctr_benchmark

约定

日期 YYYY-MM-DD，默认近 28 天（GSC 数据有延迟）；ctr 为小数（0.05=5%）；position 越小越靠前。
全部只读；开启写入后 WordPress 另有写入工具（默认关闭，由用户在「数据源」开启）。

三、第一步：配置数据源

Google Search Console

在 GCP 创建服务账号，下载 JSON 密钥。
在 GSC 后台把该服务账号邮箱加为站点用户（只读权限）。
控制台「数据源」：上传/粘贴服务账号 JSON + 填站点属性 + 可选代理。

站点属性两种格式：sc-domain:example.com（域属性）或 https://example.com/（URL 前缀）。

WordPress

WP 后台「用户 → 个人资料 → 应用密码」生成应用密码（建议用只读账号）。
控制台「数据源」：填站点地址 + 用户名 + 应用密码；写入默认关闭。

SEO

需要同时配置 GSC 与 WordPress。

隐私：凭据经 AES-256-GCM 加密存储，仅用于你本人的调用；明文不回显、不入日志；每用户独立隔离实例；可随时删除。

四、第二步：创建 Token 并接入

控制台「API Token」创建 Token（mcp_sk_xxx，与 MCP Web 通用）。

按需连接（同一 Token）：

{
  "mcpServers": {
    "gsc": { "type": "http", "url": "https://mcpweb.wjjnew.cn/gsc/mcp", "headers": { "Authorization": "Bearer mcp_sk_你的Token" } },
    "wp":  { "type": "http", "url": "https://mcpweb.wjjnew.cn/wp/mcp",  "headers": { "Authorization": "Bearer mcp_sk_你的Token" } },
    "seo": { "type": "http", "url": "https://mcpweb.wjjnew.cn/seo/mcp", "headers": { "Authorization": "Bearer mcp_sk_你的Token" } }
  }
}

想一个连接就用聚合：https://mcpweb.wjjnew.cn/gsc-wp/mcp（22 工具）。客户端（Claude Desktop / Cursor / Trae / OpenClaw）：填 URL + 认证方式 API Key / Token。

五、第三步：部署与接入

A. 远程托管（推荐）

已在第三节完成数据源配置、第四节完成 Token 与地址即可。无需本地安装。
首次调用会自动为该用户拉起隔离实例（仅本人凭据），随后可直接调用工具。

B. 本地部署（凭据不出本机）

在自有机器运行本工具源码（先 npm install）：

node src/serve-http.js      # 或分别：node src/mcp-gsc-server.js / mcp-wp-server.js / mcp-seo-server.js

客户端 stdio 配置（各自带环境变量）：

{
  "mcpServers": {
    "gsc": { "command": "node", "args": ["/path/MCP-GSC-WP/src/mcp-gsc-server.js"],
      "env": { "GSC_KEY_FILE": "/path/sa.json", "GSC_SITE_URL": "sc-domain:example.com" } },
    "wordpress": { "command": "node", "args": ["/path/MCP-GSC-WP/src/mcp-wp-server.js"],
      "env": { "WP_SITE_URL": "https://example.com", "WP_USERNAME": "user", "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx" } }
  }
}

本地模式不经过平台计费；适合对隐私要求高或内网场景。

六、计费与积分

统一积分：与 MCP Web 工具集共用一份余额；用量按工具分开统计。
充值：控制台「充值」用兑换码兑换；注册验证邮箱送 500 分。

七、安全与合规

使用免责声明：本服务仅供个人学习研究，或企业在其自有 / 已获授权的网站与系统内部使用；严禁爬取、抓取、批量下载任何未获授权的第三方网站内容。使用者须自行符合目标网站 ToS、robots 协议及当地法律，后果自负。

凭据 AES-256-GCM 加密存储，明文不回显、不入日志；每用户隔离实例；可随时删除。
建议 GSC 用只读服务账号、WordPress 用只读应用密码。

八、常见问题与排障

现象	原因	处理
`/gsc/mcp` 等返回 428	未配置数据源	到控制台「数据源」配置 GSC / WordPress
`/gsc/mcp` 返回 404	工具名/路径不对	用 `/gsc/mcp`、`/wp/mcp`、`/seo/mcp` 或聚合 `/gsc-wp/mcp`
GSC 报 invalid_grant / 403	服务账号未加为站点用户 / 密钥无效	在 GSC 后台把服务账号邮箱加为站点用户
WordPress 报 401 / 403	用户名或应用密码错误 / 权限不足	重新生成应用密码；确认账号有 read 权限
SEO 工具报缺少数据源	只配了 GSC 或只配了 WP	SEO 需同时配置 GSC 与 WordPress
401 Unauthorized	Token 缺失/错误	检查 `Authorization: Bearer mcp_sk_xxx`
结果为空/日期无数据	GSC 数据有延迟	默认区间为近 28 天（截止 3 天前），可显式指定日期
积分不足	余额 ≤0	控制台「充值」用兑换码兑换