AIアクセス解析（ktrackgeo）＋ VWork教材

このアプリについて

## AIに読まれているか、測れていますか

Google Analytics は**ボットを除外します**。つまり GPTBot・ClaudeBot・PerplexityBot が
自社サイトをどれだけ読んでいるかが、GA4 では**まったく見えません**。Search Console も
Google検索の実績だけです。

AI検索経由の流入を気にしていても、測る道具がない。そこを埋めるための道具です。

## 3つの機能

### ① 診断 — AIに読まれる状態になっているか

robots.txt でAIクローラーを拒否していないか、llms.txt があるか、構造化データが
揃っているか。**8つの観点で点を付け、直すべきことを効果の大きい順に示します。**

**生成AIを使いません。**判定は事実の確認だけで済むうえ、生成AIを挟むと結果が
実行ごとにぶれて「直したのに点が下がった」が起きます。同じページなら何度実行しても
同じ結果になります。前回との差も出るので、直した効果がそのまま数字になります。

### ② 実測 — 実際にAIが来たか

どのAIが、いつ、どのページを読んだか。GPTBot / OAI-SearchBot / ClaudeBot /
PerplexityBot / Google-Extended / CCBot など主要なものを個別に判別します。

検索エンジン（Googlebot・Bingbot）とも分けて集計するので、
**AI検索と従来の検索、どちらから見つけられているか**が分かります。

### ③ 解析 — 人のアクセス

ページビュー・訪問者数・訪問回数、よく見られたページ、外から見つけてもらった流入元、
使われた端末。前の期間との増減も出ます。

参照元は**訪問の入口だけ**を数えます。ページを開くたびに数えると、再読み込みのぶん
流入が水増しされるためです。サイト内の移動も分けて表示するので、本当に新しく
見つけてもらった経路が埋もれません。

## AIエージェント向けのスキルを同梱

`skills/` に2つ入っています。Claude Code や Codex に読ませてお使いください。

- **設置用** — 置き場所、設定、タグの貼り方、AIクローラー計測の入れ方、動作確認
- **考察用** — **GA4・Search Console と突き合わせて、食い違いの理由を説明します**

3つの数字は必ず食い違います。差には理由があり、理由ごとに打つ手が違います。
たとえば Google は参照元としてドメインしか渡さないため、自然検索・Discover・広告の
区別は原理的につきません。この手の落とし穴を知らないと、素朴に比べて誤った結論を出します。
考察用スキルには、実際に突き合わせて判明した読み方が入っています。

## 自社サーバーで完結します

- **データベース不要**（月ごとのテキストログに追記するだけ）
- **外部ライブラリ不要**（グラフは自前のSVG。CDNも読みません）
- **外部APIを呼びません**（相手が落ちても画面は止まりません）
- **IPを保存しません**（訪問者の区別はソルト付きハッシュ）
- 古いログは指定した月数で自動的に消えます

アクセスの記録が外部の事業者に渡らないので、外部送信に関する説明が要りません。

## 大切なお知らせ

**AIクローラーを測るには、PHPページの先頭に1行入れる必要があります。**

```php
<?php require_once __DIR__ . '/ktrackgeo.php'; ?>
```

クローラーは JavaScript を実行しないため、**タグを貼るだけでは原理的に拾えません**。
**静的HTMLだけのサイトでは、AIクローラーは測れません。**人のアクセスとGEO診断は
そのままお使いいただけます。

## 動作要件

- PHP 7.4 以上（8.x で確認済み）
- データベース・Composer・npm は不要
- cron は不要

## 同梱物

ソースコード一式（約1,300行）、設置手順書、AIエージェント向けスキル2種、
実際に踏んだ罠の記録、VWork の教材。**MIT License** で、商用利用・改変・再配布・再販が自由です。