EdGEO

EdGEO

一款免费的本地优先 MCP 工具包，用于开展基于证据的 SEO、GEO 和 Google AI 搜索审计。

EdGEO 为兼容的 AI Agent 提供工具，用于检查公开网站页面、抓取网站的有限范围、分析 AI 回答，以及读取用户自己的 Google Search Console 数据。这是一个独立的开源项目。无需 EdGEO 账户、EdGEO 托管服务、遥测数据收集或订阅。

API 回答不等同于用户在 ChatGPT、Gemini、Google AI Overviews 或其他面向消费者的产品中看到的内容。EdGEO 会报告每项观察结果的来源和条件，但不承诺排名。

EdGEO 的功能

• 审计页面： 检查 HTTP 状态和重定向、标题和描述、规范链接和 robots 指令、标题、语言、视口、链接、图片替代文本、Open Graph/Twitter 元数据、hreflang，以及可解析的 JSON-LD。
• 抓取有限范围的网站样本： 最多尝试获取 50 个同主机 URL，从请求的 URL 和同主机站点地图 URL 开始。EdGEO 在请求 URL 时保留末尾斜杠，遵循 robots.txt 和抓取延迟，将非 HTML 资源单独列出，并对最终解析到相同 URL 的页面去重。队列中剩余的 URL 不代表全站覆盖率估算。
• 收集 AI 回答： 查询回环地址上的 Ollama 服务，或在明确同意后查询 Gemini API。返回的观察结果包括提供方、模型、提示词类型、区域设置、时间戳和限制。
• 分析和比较 AI 回答： 分析提供或收集的回答，查找品牌的原文提及和域名引用。只有在提示词和记录的条件一致时，才比较回答。
• 连接 Google Search Console： 使用只读 OAuth 权限范围授权用户账户、列出可用资源，并查询所选日期、维度和搜索类型。
• 导入导出数据： 在本地解析 Search Console CSV/TSV 文件，包括常见的英文和印尼语表头，或汇总结构化行数据。

在 AI Agent 中安装

使用以下方式在选定的客户端中安装本地 MCP 服务：

npx -y edgeo-mcp install --agent claude,codex,cursor,gemini

如需安装原生 Gemini CLI 扩展，请使用：

gemini extensions install https://github.com/edgarcia-id/edgeo

该扩展会将 MCP 提示词注册为 /edgeo。只有在使用 EdGEO 的 Gemini 提供方时，才需要设置可选的 Gemini API 密钥；该密钥保存在 Gemini CLI 的敏感扩展设置中。

如需安装 Claude Code marketplace 插件，请添加 EdGEO marketplace 并安装其插件：

claude plugin marketplace add edgarcia-id/edgeo
claude plugin install edgeo@edgeo-marketplace

该插件提供 MCP 工具和带命名空间的 /edgeo:edgeo 命令。下方的独立安装程序还会安装不带限定名称的 /edgeo 技能。

安装程序会合并用户级设置，在编辑 JSON 配置文件前先备份，并保留无关的服务条目。Claude Code 和 Codex 使用其原生 CLI 命令；Cursor 和 Gemini CLI 使用各自的用户 MCP 配置。Claude Code 和 Codex 还会安装 EdGEO 技能。安装后，请重启或重新加载选定的客户端。

npx -y edgeo-mcp doctor
npx -y edgeo-mcp uninstall --agent claude,codex,cursor,gemini

MCP 服务会注册名为 edgeo 的提示词。会将 MCP 提示词显示为斜杠命令的宿主可能会显示 /edgeo；其他宿主则使用其技能选择器、提示词界面或常规工具调用。MCP 并未为所有 Agent 规定统一的斜杠命令语法。

有关直接/手动设置和受支持的宿主行为，请阅读安装和分发 EdGEO和 Agent 安装说明。

Search Console 设置

Google Search Console API 可免费使用，但受 Google 配额限制。每位用户连接自己的 Google 账号；EdGEO 仅请求 Search Console 只读权限范围。要连接，请创建类型为 桌面应用 的 Google OAuth 客户端，在该 Google Cloud 项目中启用 Search Console API，然后运行：

npx -y edgeo-mcp search-console connect --client-id YOUR_DESKTOP_OAUTH_CLIENT_ID

浏览器会打开 Google 的授权页面，并返回同一台计算机上的环回回调地址。刷新令牌存储在用户的本地 EdGEO 数据目录中；设置 EDGEO_DATA_DIR 可选择其他目录。edgeo-mcp search-console status 会检查本地设置，edgeo-mcp search-console disconnect 会撤销已保存的授权并将其删除。

请参阅 Google Search Console 连接详情，了解 OAuth 设置和数据处理。

模型连接

• **Ollama：**本地 API 请求发送至 127.0.0.1:11434；EdGEO 不会因此增加模型 API 费用。需要本地硬件。由云端提供支持的 Ollama 模型仍可能向外部传输提示词。
• **Gemini API：**在 MCP 进程环境中配置 GEMINI_API_KEY。发送提示词前，工具要求设置 consentToExternalRequest: true。部分模型层级提供免费配额；费率、可用性和数据条款各不相同。除非服务提供商的条款和设置符合要求，否则请勿发送机密数据。

这两个连接器都不会自动执行消费级应用测试或网络搜索。返回的答案不假定包含引用。请参阅模型连接详情。

要求和本地开发

• Node.js 20.18.1 或更高版本
• 支持供 Agent 使用的本地 stdio MCP 的 Agent

npm ci
npm test
npm run typecheck
npm start

npm start 会运行本地 stdio MCP 服务。服务将诊断消息写入 stderr，并将 stdout 保留用于 MCP 消息。npm test 会构建 TypeScript，并测试 CSV 解析、可见性分析、API 请求构造、OAuth 令牌刷新、安装程序配置合并、SSRF 拒绝，以及 MCP 初始化和工具发现。

方法限制

• 页面审计会检查服务器返回的 HTML 和标头。它们不会渲染 JavaScript、测量 Core Web Vitals、验证索引状态或观察搜索排名。
• 爬取范围限定为完全匹配的主机名，并遵守适用的 robots.txt 规则；若无法读取 robots.txt，则会停止。
• Search Console 仅报告 Google 返回的字段和外观标签。EdGEO 不会根据普通网络搜索结果推断 AI Overviews、AI Mode 或 SGE。
• 品牌匹配采用字面匹配，可能需要人工审核实体。提及不代表正面描述或推荐；引用不能证明其支持附近的说法。
• 比较结果仅作描述，不表示因果关系。差异可能反映抽样、模型更新、检索、账号状态或未记录的条件。
• Search Console 导出和 API 响应可能省略匿名化查询，或被截断。点击、引用或展示都不代表收入，也不能证明 GEO 效果。

隐私与安全

页面和爬取请求会直接发送至用户选定的公开网站。EdGEO 会阻止指向本地／私有 IP 的目标，并固定已验证的 DNS 地址。提供的数据和 API 结果会在本地处理，并返回给已连接的 Agent；Agent 主机可能根据其自身政策保留对话或工具数据。只有在明确设置工具同意标记后，Gemini 提示词才会离开计算机。请参阅隐私与数据处理和安全政策。

许可证

Apache-2.0。允许商业使用和再分发，但须遵守许可证并保留随附的归属声明。请参阅 LICENSE 和 NOTICE。

项目状态

edgeo-mcp 软件包和 EdGEO 服务元数据已发布到 npm 和 Official MCP Registry。版本 0.1.2 改进了爬取 URL 处理、重定向分类、站点地图链接观察和标题提示。版本 0.1.1 新增了原生 Gemini CLI 扩展支持；Gemini gallery 会通过每日爬虫发现符合条件且带有相应标签的代码仓库。