dottide

dotTide

dotTide は読み取り専用の MCP サーバー兼コマンドラインツールで、Claude、Cursor、Codex などの AI エージェントに、運営するすべてのサイトの数値を提供します。複数の Google アカウントにまたがる Google Search Console と Google Analytics 4（GA4）に加え、WordPress.org、Firefox Add-ons、GitHub の統計を読み取り、スクリプトやエージェント向けに週次スナップショットを作成します。

サイトに何かを追加することはありません。dotTide は、すでにある数値を読み取るだけで、キーはお使いのコンピューター内に保管されます。

理由

サイトが複数の Google アカウントに分かれている場合、確認するにはアカウントごとにログインとログアウトを繰り返す必要があります。週次の確認は月次になり、依頼した AI エージェントが扱う数値は古いままです。プラグイン、拡張機能、リポジトリのストアの数値も、さらに別の場所にあります。

dotTide は読み取り専用キーひとつですべてを読み取り、Claude、コマンドライン、週次の JSON ファイルで同じように情報を返します。

できること

• sites: 設定済みのすべてのサイト、各サイトで使用するキー、確認時点での Search Console、GA4、Bing へのアクセス状況。
• search_queries: 任意の期間について、クエリまたはページごとのクリック数、表示回数、CTR、平均掲載順位。前の期間との比較や、国、デバイス、検索タイプによる絞り込みもできます。
• traffic: ソースとメディア別の GA4 セッション数。AI アシスタントからの流入（ChatGPT、Perplexity、Copilot、Gemini、Claude など）は個別に集計します。GA4 を設定しているサイトのみが対象です。
• store_stats: キー不要で取得できる、公開中の数値：WordPress.org のプラグイン、Firefox Add-ons、GitHub のスター数。
• opportunities: 次に取り組むべきこと：上位表示に近いクエリ、クリック数が減少しているページとクエリ、掲載順位のわりにクリック率が低い検索結果の1ページ目のクエリ。
• page_queries: 1つのページにユーザーを誘導するクエリと、匿名化されたクエリのために Google が隠している、そのページのトラフィックの割合。
• competing_pages: 2つ以上のページで表示回数を分け合っているクエリ。重複が大きいものから表示します。
• 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 クライアントでコマンドとして表示されます。
• 週次スナップショット： 直近の完了した1週間とその前の週を比較し、プロファイルごとに1つの JSON ファイルを作成します。ファイルを読み取るスクリプトやエージェント向けです。

アクセスの仕組み

サイトを新しい Google アカウントに移す必要はありません。Google サービスアカウントを 1 つ作成し、サイトを所有する Google アカウントから、そのサービスアカウントのメールアドレスを招待します。

• Search Console： 制限付きユーザーとして招待します。
• GA4： 閲覧者として招待します。

サービスアカウントは読み取り専用で、どのサイトからでもワンクリックで削除できます。Bing は任意で、Bing Webmaster Tools の API キーを 1 つ使用すれば、そこで管理しているすべてのサイトを利用できます。キーはシステムのシークレットストア（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 へのアクセスを設定します。所要時間は約 10 分で、サイトごとにさらに 1 分ほどかかります。

4. キーを保存し、dotTide にサイトを検出させて、アクセスを確認します。

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

5. 任意： Bing の設定に従って Bing の数値を追加します。所要時間は約 5 分です。

6. Claude Code に接続します。

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

後で更新するには、uvx dottide@latest sites を一度実行してください。その後は uvx dottide で新しいバージョンが使われます。

ドキュメント

• Google の設定：サービスアカウントの作成方法を、クリックする手順ごとに説明します。また、各サイトの共有方法も説明します。
• Bing の設定：API キー 1 つで取得できる、任意の Bing Webmaster Tools の数値について説明します。
• 設定：プロファイル、すべてのフィールド、キー、環境変数について説明します。
• dotTide の使い方：各ツールとそのオプション、MCP クライアント、週次スナップショットとその形式、一般的なエラーの解決方法について説明します。
• AI エージェントに数値を尋ねる：週次チェック、更新するコンテンツ、AI 経由の流入、ストアの数値を尋ねるプロンプト例と、保存済みの Claude Code コマンドを紹介します。
• AI クライアントの接続：Claude Code、Claude Desktop、Cursor、Windsurf、VS Code、Codex、Gemini CLI、Grok、および MCP を使わないエージェントについて説明します。

知っておくと便利なこと

• Search Console のデータが確定するのは約 3 日後のため、デフォルトの期間は 3 日前までです。
• dotTide が要求する Google スコープはすべて読み取り専用で、どのツールからも変更はできません。
• GitHub では、1 つの IP アドレスにつき 1 時間あたり 60 件まで匿名でリクエストできます。上限に達した場合は、読み取り専用トークンを DOTTIDE_GITHUB_TOKEN に設定してください。

コントリビューション

CONTRIBUTING.md をご覧ください。セキュリティに関する報告は SECURITY.md からお送りください。

ライセンス

コードは MIT License のもとで公開されています。dotTide の名称とアイコンはライセンスの対象外です。そのため、コピーを配布する場合は独自の名称とアイコンを使用してください。