튜토리얼
구독 클라이언트 생성
가시성 감사 예약된 감사 대시보드
클라이언트 포털 쇼케이스 페이지 화이트 라벨
MCP 가이드 REST API AI 추적
트래킹 플러그인

AI Labs Audit GEO 트래킹 플러그인 설치

사이트에서 AI 가시성을 추적하세요: 15개 이상 카테고리의 256개 봇 시그니처, 환각 URL 탐지 및 AI 리퍼럴 트래픽. 6가지 설치 방법: WordPress, PHP, Node.js, Python, Cloudflare Worker 또는 JavaScript 픽셀.

목차

  1. 사전 요구사항
  2. WordPress 플러그인
  3. 범용 PHP
  4. Node.js
  5. Python
  6. Cloudflare Worker
  7. JavaScript 픽셀
  8. 확인

사전 요구사항

트래킹 플러그인을 설치하기 전에 AI Labs Audit 대시보드에서 트래킹 키를 생성해야 합니다. 이를 통해 4개의 자격증명을 받게 됩니다:

1

API & Integrations로 이동

AI Labs Audit 계정에 로그인하여 API & Integrations 페이지로 이동합니다.

2

트래킹 키 생성

키 생성을 클릭하고 Client 역할을 선택한 후 클라이언트를 선택하고 Tracking IA (trk_live_...) 키 유형을 선택한 후 확인합니다.

3

4개의 자격증명 복사

창에 자격증명이 표시됩니다. HMAC Secret은 다시 표시되지 않으므로 모두 즉시 복사하세요:

  • API Key — 고유한 트래킹 키(형식: trk_live_...)
  • HMAC Secret — 페이로드 서명을 위한 비밀 키(클라이언트 측에 노출 금지)
  • Client ID — 데이터를 계정에 연결하는 클라이언트 식별자
  • API URL — 엔드포인트: https://ailabsaudit.com/api/v1

중요

HMAC Secret은 생성 시 한 번만 표시됩니다. 분실하면 새 트래킹 키를 생성해야 합니다.

RGPD 준수

트래커는 개인 데이터를 수집하지 않습니다. AI 봇의 user-agent와 AI 리퍼럴 도메인만 탐지합니다. 쿠키 없음, IP 추적 없음, 핑거프린팅 없음.

WordPress 플러그인

WordPress 플러그인은 시작하기 가장 간단한 방법입니다. AI 봇 탐지, 이벤트 버퍼링 및 예약 전송을 모두 자동으로 처리합니다.

설치

플러그인을 설치하는 두 가지 옵션이 있습니다:

1

옵션 A: FTP / 파일 관리자를 통한 업로드

GitHub에서 플러그인을 다운로드하고 ailabsaudit-tracker 폴더를 /wp-content/plugins/에 업로드합니다.

2

옵션 B: WordPress 관리자에서 설치

플러그인 > 새로 추가 > 플러그인 업로드로 이동하여 ZIP 파일을 선택하고 지금 설치를 클릭합니다.

구성

3

플러그인 활성화

WordPress 관리자의 플러그인으로 이동하여 AI Labs Audit Tracker를 찾아 활성화를 클릭합니다.

4

자격증명 입력

설정 > AI Labs Audit로 이동하여 API Key, HMAC Secret, Client ID 및 API URL을 입력합니다.

5

연결 테스트

"Test Connection" 버튼을 클릭하여 자격증명이 올바른지, 이벤트를 전송할 수 있는지 확인합니다.

작동 방식

< 1ms 탐지

봇 탐지는 페이지 로드당 1밀리초 미만을 추가합니다.

버퍼링

이벤트는 WP transient에 저장되고 WP-Cron을 통해 5분마다 전송됩니다.

일일 갱신

봇 시그니처 및 리퍼러 도메인 목록은 API에서 매일 갱신됩니다.

객체 캐시 호환

Redis, Memcached 및 기타 객체 캐시 솔루션과 완벽하게 작동합니다.

RGPD 준수

플러그인은 개인 데이터를 수집하지 않습니다. AI 봇의 user-agent 문자열과 AI 리퍼럴 도메인만 탐지합니다. 쿠키 없음, IP 주소 없음, 실제 방문자 추적 없음.

PHP 제네릭

WordPress 외 PHP 사이트의 경우, 자동 감지 기능이 내장된 독립형 PHP 트래커를 사용하십시오. Composer를 통해 설치하거나 단일 파일을 복사하여 설치할 수 있습니다.

설치

Composer 
composer require ailabsaudit/tracker

또는 GitHub 저장소에서 AilabsTracker.php를 다운로드하여 직접 포함시킬 수 있습니다.

사용 예시

PHP 
use AilabsAudit\Tracker\AilabsTracker;

$tracker = new AilabsTracker(
    apiKey: 'your-api-key',
    apiSecret: 'your-hmac-secret',
    clientId: 'your-client-id',
    apiUrl: 'https://ailabsaudit.com/api/v1',
    enableDetection: true,
    bufferStorage: '/tmp/ailabs_buffer.json'
);

// 프론트 컨트롤러 상단에서 호출
$tracker->detect();

작동 방식

  • 자동 감지는 하위 호환성을 위해 옵트인 방식입니다(enableDetection: false가 기본값). 활성화되면 detect()가 현재 요청에서 AI 봇과 리퍼러를 자동으로 식별합니다.
  • 버퍼: 이벤트는 JSON 파일에 저장되며(LOCK_EX로 동시성 처리), 일괄 전송됩니다.
  • API 갱신: 봇 시그니처와 리퍼러 도메인 목록은 API에서 자동으로 갱신됩니다(TTL 24시간, ETag 지원).

요구 사항

PHP 7.4+, ext-curl, ext-json.

Node.js

Node.js 백엔드(Express, Fastify, Next.js 등)의 경우, Express 미들웨어와 자동 감지 기능이 통합된 공식 npm 패키지를 사용하십시오.

설치

npm 
npm install @ailabsaudit/tracker-node

또는 GitHub 저장소에서 src/index.js를 복사할 수 있습니다.

사용 예시

JavaScript 
const { AilabsTracker, createMiddleware } = require('@ailabsaudit/tracker-node');

const tracker = new AilabsTracker({
  apiKey: 'your-api-key',
  apiSecret: 'your-hmac-secret',
  clientId: 'your-client-id',
  apiUrl: 'https://ailabsaudit.com/api/v1',
  enableDetection: true,
});

// Express 미들웨어 — 봇과 리퍼럴을 자동으로 감지
app.use(createMiddleware(tracker));

// 정상 종료 — 남은 버퍼 플러시
process.on('SIGTERM', () => tracker.shutdown());

작동 방식

  • 자동 감지는 하위 호환성을 위해 옵트인 방식입니다(enableDetection: false가 기본값). 활성화되면 미들웨어가 각 요청에서 AI 봇과 리퍼러를 자동으로 감지합니다.
  • 버퍼: 메모리 내(최대 500개 이벤트), 5분마다 플러시, 30초 디바운스. 5xx/429 오류 시 3회 재시도.
  • API 갱신: 봇 시그니처와 리퍼러 목록은 API에서 갱신됩니다(TTL 24시간, ETag 지원).

정상 종료

tracker.shutdown()은 남은 버퍼링된 이벤트를 전송하고 모든 타이머를 중지합니다. 프로세스 종료 시 이벤트 손실을 방지하기 위해 필수입니다.

요구 사항

Node.js 14+. 외부 종속성 없음.

Python

Python 백엔드(Django, Flask, FastAPI 등)의 경우, WSGI/ASGI 미들웨어와 자동 감지 기능이 포함된 pip 패키지를 사용하십시오.

설치

pip 
pip install ailabsaudit-tracker

또는 GitHub 저장소에서 tracker.py를 복사할 수 있습니다.

사용 예시

Python (Flask) 
from ailabsaudit_tracker import AilabsTracker, WsgiMiddleware

tracker = AilabsTracker(
    api_key="your-api-key",
    api_secret="your-hmac-secret",
    client_id="your-client-id",
    api_url="https://ailabsaudit.com/api/v1",
    enable_detection=True,
)

# WSGI 미들웨어 — 봇과 리퍼럴을 자동으로 감지
app.wsgi_app = WsgiMiddleware(app.wsgi_app, tracker)

# 정상 종료 — 남은 버퍼 플러시
import atexit
atexit.register(tracker.shutdown)

작동 방식

  • 자동 감지는 하위 호환성을 위해 옵트인 방식입니다(enable_detection=False가 기본값). 활성화되면 미들웨어가 각 요청에서 AI 봇과 리퍼러를 자동으로 감지합니다.
  • 버퍼: 스레드 안전 메모리 내(최대 500개 이벤트), 데몬 스레드 타이머를 통해 5분마다 플러시. 5xx/429 오류 시 3회 재시도.
  • API 갱신: 봇 시그니처와 리퍼러 목록은 백그라운드 스레드에서 API로부터 갱신됩니다(TTL 24시간, ETag 지원).

정상 종료

tracker.shutdown()은 남은 버퍼링된 이벤트를 전송하고 모든 타이머 스레드를 중지합니다. 프로세스 종료 시(Gunicorn, uWSGI 등) 이벤트 손실을 방지하기 위해 필수입니다.

요구 사항

Python 3.8+. 외부 종속성 없음. WSGI(Flask, Django) 및 ASGI(FastAPI, Starlette) 호환.

Cloudflare Worker

트래커를 Cloudflare Worker로 배포하여 원본 서버에 영향을 주지 않고 엣지에서 요청을 가로채고 분석합니다.

설치

1

Wrangler 설치

아직 Wrangler가 설치되지 않은 경우:

터미널 
npm install -g wrangler
2

wrangler.toml 구성

GitHub 저장소를 클론하고 wrangler.toml을 편집하여 API_URL 변수를 정의합니다.

wrangler.toml 
[vars]
API_URL = "https://ailabsaudit.com/api/v1"
3

시크릿 구성

자격 증명을 Cloudflare Worker 시크릿으로 추가합니다(코드에 노출되지 않음):

터미널 
wrangler secret put API_KEY
wrangler secret put API_SECRET
wrangler secret put CLIENT_ID
4

배포

Worker를 Cloudflare 엣지 네트워크에 배포합니다:

터미널 
wrangler deploy

작동 방식

엣지 감지

원본 서버에 도달하기 전에 Cloudflare 엣지에서 GET 요청을 가로챕니다.

256개 봇 시그니처

GPTBot, ClaudeBot, Bingbot AI, PerplexityBot 등 15개 이상 카테고리의 256개 AI 봇 user-agent 시그니처를 감지합니다.

30개 이상 AI 리퍼러

ChatGPT, Perplexity, You.com 등 30개 이상의 AI 리퍼러 도메인에서 발생한 트래픽을 식별합니다.

Fire-and-forget

이벤트는 ctx.waitUntil()을 통해 비동기적으로 전송되어 지연 시간에 영향을 주지 않습니다.

동적 갱신

봇 시그니처와 AI 리퍼러 목록은 Cloudflare Cache API를 통해 API에서 동적으로 갱신됩니다(TTL 24시간). API에 접근할 수 없는 경우, Worker는 배포 시 포함된 하드코딩된 목록으로 대체됩니다.

JavaScript 픽셀

간단한 스크립트 태그로 추가할 수 있는 경량(< 2 KB) 클라이언트 트래커입니다. 정적 사이트, 랜딩 페이지 또는 서버 액세스 권한이 없는 경우에 이상적입니다.

설치

HTML의 </body> 닫는 태그 바로 앞에 다음 스크립트 태그를 추가하십시오:

HTML 
<script src="/path/to/tracker.js"
  data-tracker-id="YOUR_TRACKER_ID"
  data-api-url="https://ailabsaudit.com/api/v1/collect">
</script>

추적 항목

page_view

URL 및 리퍼러 정보와 함께 각 페이지 뷰를 자동으로 추적합니다.

page_leave

체류 시간 및 스크롤 깊이와 함께 페이지 이탈 이벤트를 캡처합니다.

click

링크 및 인터랙티브 요소의 클릭 이벤트를 추적합니다.

보안 참고사항

클라이언트 측 페이로드는 서명되지 않습니다(HMAC 시크릿은 브라우저에 노출될 수 없음). 페이로드는 원본 도메인으로 서버 측에서 검증됩니다. AI Labs Audit 설정에 도메인이 등록되어 있는지 확인하십시오.

검증

트래커 배포 후 AI Labs Audit 대시보드에서 모든 것이 올바르게 작동하는지 확인하십시오.

1

대시보드 열기

AI Labs Audit 계정에 로그인하고 클라이언트의 Tracking 페이지로 이동합니다.

2

봇 크롤 확인

AI 봇 크롤은 배포 후 몇 분 내에 나타나기 시작합니다. GPTBot, ClaudeBot, Bingbot 및 기타 AI 크롤러의 항목을 확인하십시오.

3

AI 리퍼럴 확인

AI 플랫폼(ChatGPT, Perplexity, Copilot 등)에서 발생한 트래픽도 시간이 지남에 따라 대시보드에 표시됩니다.

4

이벤트 세부정보 검토

이벤트를 클릭하여 전체 세부정보를 확인하십시오: user-agent, 크롤된 URL, 타임스탬프, 상태 코드 및 응답 크기.

팁

몇 분 후에도 데이터가 표시되지 않으면 플러그인 설정에서 자격 증명을 확인하고 서버가 https://ailabsaudit.com/api/v1에 접근할 수 있는지 확인하십시오. WordPress의 경우 WP-Cron이 올바르게 작동하는지 확인하십시오.

GEO 추적 고급 기능

환각 URL 감지

트래커는 환각 URL을 자동으로 감지합니다 -- AI 모델이 인용하거나 링크하지만 사이트에 존재하지 않는 페이지(AI 봇 크롤에 대한 404 응답). 이러한 URL은 추적되어 대시보드에 보고되므로, 누락된 콘텐츠를 생성하거나 리디렉션을 설정하여 AI가 생성한 트래픽을 포착할 수 있습니다.

AI 리퍼럴 트래픽 추적

봇 크롤 외에도 트래커는 AI 리퍼럴 트래픽을 모니터링합니다 -- ChatGPT, Perplexity, Copilot, You.com 및 기타 AI 플랫폼에서 발생한 실제 사용자 방문. 이 데이터는 AI 가시성이 사이트의 실제 트래픽으로 어떻게 전환되는지 이해하는 데 도움이 됩니다.

봇 크롤 / 감사 점수 상관관계

추적된 봇 활동은 웹 지식 지표 역할을 합니다: AI 봇이 페이지를 더 자주 크롤할수록 콘텐츠가 지식 베이스에 인덱싱될 가능성이 높습니다. 이는 네이티브 대 웹 GEO 점수와 상관관계가 있어 크롤 활동과 AI 가시성 성능 간의 직접적인 연결을 제공합니다.

GEO/AEO 가시성 추적을 시작할 준비가 되셨습니까?

몇 분 안에 트래커를 설치하고 귀하의 사이트에서 AI 봇 활동 모니터링을 시작하십시오.

GitHub에서 보기 인증 정보 받기

AI 가시성 감사를 시작할 준비가 되셨습니까?

무료 계정을 생성하고 500 보너스 크레딧을 받으세요.

무료 계정 생성