Dokumentacja

Większość wdrożeń zajmuje mniej niż 2 minuty. Wybierz metodę pasującą do Twojej platformy:

Potrzebujesz powiadomień w czasie rzeczywistym? Webhooki są dostępne po uruchomieniu śledzenia (plany Business i Enterprise).

Oficjalna wtyczka HumanKey instaluje się bezpośrednio z katalogu wtyczek WordPress.

1. 1Przejdź do panelu WordPress Admin → Wtyczki → Dodaj nową
2. 2Wyszukaj „HumanKey" i kliknij Zainstaluj teraz
3. 3Aktywuj wtyczkę
4. 4Przejdź do Ustawienia → HumanKey
5. 5Wklej swój Publiczny Klucz Witryny (dostępny w Panelu → Witryny)
6. 6Zapisz — fragment śledzący jest teraz aktywny na wszystkich stronach

Działa na każdej platformie obsługującej własny HTML: Shopify, Webflow, Squarespace, strony statyczne i aplikacje własne.

Zamień TWÓJ_KLUCZ_PUBLICZNY na klucz publiczny Twojej witryny ze strony Panel → Witryny.

Użyj REST API z serwera, aby wykrywać boty i crawlery AI przed serwowaniem treści. Idealne dla middleware Next.js, Laravel, Django lub dowolnego frameworka serwerowego.

POST https://humankey-production.up.railway.app/api/detect
Content-Type: application/json

{
  "siteKey": "pk_...",
  "url": "https://twojawitryna.pl/artykul",
  "referrer": "https://google.com"
}

{
  "isHuman": false,
  "confidence": 0.99,
  "action": "block",
  "bot": {
    "name": "GPTBot",
    "company": "OpenAI",
    "purpose": "training"
  }
}

// middleware.ts
import { NextRequest, NextResponse } from 'next/server';

export async function middleware(req: NextRequest) {
  const res = await fetch('https://humankey-production.up.railway.app/api/detect', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      siteKey: process.env.HK_PUBLIC_KEY,
      url: req.url,
      referrer: req.headers.get('referer') ?? undefined,
    }),
  });

  const { action } = await res.json();

  if (action === 'block') {
    return new NextResponse('Too Many Requests', { status: 429 });
  }

  return NextResponse.next();
}

Konfiguruj reguły dla poszczególnych crawlerów w Panelu → Witryny → Reguły crawlerów AI.

HumanKey generuje również własny fragment robots.txt na podstawie Twoich reguł. Zainstaluj go przez wtyczkę WordPress jednym kliknięciem lub skopiuj i wklej ręcznie.

Otrzymuj powiadomienia w czasie rzeczywistym o wykrytych botach. Dostępne w planach Business i Enterprise.

POST https://twoj-endpoint.pl/webhook
X-HumanKey-Signature: sha256=...

{
  "event": "bot.detected",
  "data": {
    "domain": "twojawitryna.pl",
    "botName": "GPTBot",
    "confidence": 0.99,
    "url": "/artykul/trendy-ai-2026"
  }
}

Podpisy używają HMAC-SHA256. Weryfikuj za pomocą swojego sekretu podpisywania webhooka z Panelu → Webhooki.

Wyświetl odznakę „HumanKey Verified" na swojej stronie, aby pokazać odwiedzającym, że monitorujesz ruch AI.

<img
  src="https://humankey-production.up.railway.app/api/badge?siteKey=TWÓJ_KLUCZ_PUBLICZNY"
  alt="HumanKey AI Verified"
  width="180"
  height="20"
/>

Odznaka to obraz SVG serwowany z 1-godzinnym cache. JavaScript nie jest wymagany.