dottide

dotTide

dotTide 是一款只读 MCP 服务和命令行工具，可为 Claude、Cursor、Codex 和其他 AI Agent 提供你运营的所有网站的数据。它可以跨多个 Google 账号读取 Google Search Console 和 Google Analytics 4（GA4），还可读取 WordPress.org、Firefox Add-ons 和 GitHub 统计数据，并写入每周快照，供脚本和 Agent 使用。

不会对你的网站进行任何更改。dotTide 只读取你已有的数据，你的密钥也会保存在自己的电脑上。

为什么使用 dotTide

如果你的网站分属不同的 Google 账号，查看数据就意味着要反复登录和退出。每周检查会拖到每月才做，而你请来帮忙的任何 AI Agent 都只能依据过时的数据工作。插件、扩展和代码仓库的商店数据则散落在更多地方。

dotTide 用一个只读密钥读取所有数据，并在 Claude、命令行和每周 JSON 文件中提供一致的答复。

功能

• **sites：**列出所有已配置的网站、每个网站对应的密钥，以及 Search Console、GA4 和 Bing 的访问是否正常（在你发起请求时检查）。
• **search_queries：**按查询词或页面查看任意日期范围内的点击次数、展示次数、点击率和平均排名，可选择与上一时段对比，并按国家/地区、设备和搜索类型筛选。
• **traffic：**按来源和媒介查看 GA4 会话，并单独统计 AI 助手引荐流量（ChatGPT、Perplexity、Copilot、Gemini、Claude 等）。仅适用于接入 GA4 的网站。
• **store_stats：**无需密钥即可获取实时公开数据：WordPress.org 插件、Firefox Add-ons 和 GitHub 星标数。
• **opportunities：**提供下一步工作建议：排名即将进入首页的查询词、点击次数下降的页面和查询词，以及排名在首页但点击率偏低的查询词。
• **page_queries：**查看为某个页面带来访客的查询词，以及 Google 因匿名查询而隐藏了该页面多少流量。
• **competing_pages：**查看有两个或更多页面争夺同一查询词展示次数的情况，优先列出重叠最多的页面。
• **index_health：**查看每个站点地图的状态，以及主要页面是否已编入 Google 索引，并以清晰列表列出需要修复的问题。
• **core_web_vitals：**当数据足够时，查看真实用户的 LCP、INP 和 CLS 及 Google 评级；还可通过 PageSpeed Insights 获取实验室测试结果。
• **bing_queries：**按查询词查看 Bing Webmaster Tools 的点击次数、展示次数和排名。Bing 为 Copilot 提供数据。
• **discover：**查找密钥可读取的所有 Search Console 属性和 GA4 属性，并自动为你写入配置文件条目。
• **现成提示词：**每周回顾、下一步工作建议和索引检查；在 Claude 和其他 MCP 客户端中以命令形式显示。
• **每周快照：**对比最近一个完整周与前一周的数据，为每个配置文件生成一个 JSON 文件，供读取文件的脚本和 Agent 使用。

访问方式

无需将任何网站迁移到新的 Google 账号。创建一个 Google 服务账号，然后由拥有网站的 Google 账号邀请该服务账号的邮箱：

• **Search Console：**设为受限用户。
• **GA4：**设为查看者。

该服务账号只能读取数据，你只需点击一次即可将其从任何网站移除。Bing 为可选项，使用一个来自 Bing Webmaster Tools 的 API 密钥，即可访问你在那里拥有的所有网站。该密钥保存在系统的密钥存储中：macOS 钥匙串、Windows 凭据管理器或 Linux Secret Service。

快速开始

你需要 macOS、Windows 或 Linux，以及 uv。无需克隆任何内容：首次运行时，uvx 会下载 dotTide。

1. 编写一个初始配置文件，然后在其中的 [stores] 下添加插件标识、附加组件标识或 GitHub 用户：

uvx dottide init

2. 检查是否能正常运行。商店数据无需设置 Google 即可获取：

uvx dottide store_stats

3. 按照 Google 设置配置 Google 访问权限。整个过程大约需要十分钟，每个网站还需额外一分钟。

4. 保存密钥，让 dotTide 查找你的网站，并检查访问权限：

uvx dottide import-key dottide-main ~/Downloads/<downloaded-key>.json
uvx dottide discover --write
uvx dottide sites

5. 可选：按照 Bing 设置添加 Bing 数据。大约需要五分钟。

6. 将其连接到 Claude Code：

claude mcp add --scope user dottide -- uvx dottide

之后如需更新，运行一次 uvx dottide@latest sites；此后 uvx dottide 就会使用新版本。

文档

• Google 设置：服务账号的创建步骤，以及如何逐个分享网站。
• Bing 设置：使用一个 API 密钥获取可选的 Bing Webmaster Tools 数据。
• 配置：配置文件、所有字段、密钥和环境变量。
• 使用 dotTide：各项工具及其选项、MCP 客户端、每周快照及其格式，以及常见错误的解决方法。
• 向 AI Agent 查询数据：每周检查、需要更新的内容、AI 引荐和商店数据的提示词示例，以及保存的 Claude Code 命令。
• 连接 AI 客户端：Claude Code、Claude Desktop、Cursor、Windsurf、VS Code、Codex、Gemini CLI、Grok，以及不支持 MCP 的 Agent。

注意事项

• Search Console 数据通常会延迟约三天才稳定，因此默认时间范围截至三天前。
• dotTide 请求的所有 Google 权限范围均为只读，任何工具都无法更改数据。
• GitHub 对每个 IP 每小时允许 60 次匿名请求。如果达到限制，请设置 DOTTIDE_GITHUB_TOKEN 为只读令牌。

贡献

请参阅 CONTRIBUTING.md。安全问题请通过 SECURITY.md 报告。

许可证

代码采用 MIT License 发布。dotTide 名称和图标不在许可证涵盖范围内，因此，如果你发布副本，请使用自己的名称和图标。