Dokümantasyon

HitBot kurulum, yapılandırma ve kullanım kılavuzu.

Başlangıç

HitBot, gerçekçi organik arama trafiği oluşturmak için tasarlanmış gelişmiş bir SEO trafik simülasyon aracıdır. 70+ özellik, GA4/GTM entegrasyonu, gelişmiş parmak izi ve dağıtık mimari desteği ile çalışmaktadır.

Sistem Gereksinimleri

  • Windows 10/11 (64-bit)
  • .NET 8.0 Runtime veya üstü
  • Minimum 4 GB RAM
  • Chrome veya Chromium tarayıcı
  • Stabil internet bağlantısı

Kurulum

HitBot kurulumu birden fazla yöntemle yapılabilir. Aşağıdaki adımları izleyerek hızlıca başlayabilirsiniz.

GitHub Üzerinden

bash
# Repository klonlama
git clone https://github.com/eros1sh/eros-hitbot.git
cd eros-hitbot

# Bağımlılıkları yükleme
dotnet restore

# Derleme
dotnet build --configuration Release

Hazır Paket

GitHub Releases sayfasından en güncel sürümü indirip doğrudan çalıştırabilirsiniz. Ek bir kurulum adımı gerekmemektedir.

bash
# İndirilen ZIP dosyasını çıkartın
unzip hitbot-v2.5.2-win64.zip -d hitbot

# Çalıştırın
cd hitbot
./HitBot.exe

Yapılandırma

HitBot, JSON tabanlı yapılandırma dosyaları kullanır. Ayarlar config.json dosyasında tutulur.

json
{
  "targetUrl": "https://example.com",
  "searchEngine": "google",
  "keywords": ["example keyword", "seo tool"],
  "dailyVisits": 500,
  "sessionDuration": {
    "min": 30,
    "max": 120
  },
  "bounceRate": 0.35,
  "geoTargeting": {
    "country": "TR",
    "city": "Istanbul"
  },
  "fingerprint": {
    "randomize": true,
    "platforms": ["Windows", "macOS", "Linux"]
  }
}

Tüm yapılandırma seçeneklerini CLI üzerinden --config parametresi ile geçersiz kılabilirsiniz.

Proxy Ayarları

HitBot, HTTP/HTTPS ve SOCKS5 proxy desteği sağlar. Proxy rotasyonu otomatik olarak yönetilir ve bağlantı havuzu optimizasyonu yapar.

json
{
  "proxy": {
    "enabled": true,
    "rotationStrategy": "round-robin",
    "timeout": 10000,
    "retryCount": 3,
    "sources": [
      {
        "type": "file",
        "path": "./proxies.txt",
        "format": "ip:port:user:pass"
      },
      {
        "type": "api",
        "url": "https://api.proxyservice.com/list",
        "refreshInterval": 300
      }
    ],
    "healthCheck": {
      "enabled": true,
      "interval": 60,
      "timeout": 5000
    }
  }
}

İpucu: Premium kullanıcılar için otomatik proxy sağlayıcı entegrasyonu mevcuttur. Detaylar için Telegram kanalımızı ziyaret edin.

CLI Kullanımı

HitBot komut satırı arayüzü ile tüm işlemleri terminal üzerinden gerçekleştirebilirsiniz.

bash
# Temel kullanım
hitbot start --config config.json

# Belirli anahtar kelimelerle
hitbot start --url https://example.com --keywords "seo,trafik"

# Proxy dosyasıyla
hitbot start --config config.json --proxy proxies.txt

# Durum kontrolü
hitbot status

# Oturumu durdur
hitbot stop --graceful

# Log İzleme
hitbot logs --follow --level info

Kullanılabilir Komutlar

CLIKullanılabilir Komutlar
startTrafik simülasyonunu başlatır
stopAktif oturumu durdurur
statusMevcut durum bilgisini gösterir
configYapılandırma ayarlarını yönetir
logsLogları görüntüle ve filtrele
updateEn son sürüme güncelle

API Referansı

HitBot, REST API üzerinden uzaktan yönetim desteği sunar. Tüm istekler JWT tabanlı kimlik doğrulama gerektirir.

Kimlik Doğrulama

bash
POST /api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "your-secure-password"
}

# Response
{
  "token": "eyJhbGciOiJSUzI1NiIs...",
  "expiresIn": 900
}

Oturum Yönetimi

bash
# Start new session
POST /api/sessions
Authorization: Bearer <token>

# Session status
GET /api/sessions/:id
Authorization: Bearer <token>

# Stop session
DELETE /api/sessions/:id
Authorization: Bearer <token>

İstatistikler

bash
# Statistics
GET /api/stats
Authorization: Bearer <token>

# Date range
GET /api/stats?from=2025-01-01&to=2025-01-31
Authorization: Bearer <token>

Dağıtık Mimari

HitBot, birden fazla makine üzerinde dağıtık olarak çalıştırılabilir. Master-Worker mimarisi ile yüksek ölçeklendirilebilirlik sağlar.

Master Düğümü

bash
# Start master node
hitbot master --port 5000 --auth-token YOUR_SECRET_TOKEN

# Dashboard access
# http://localhost:5000/dashboard

Worker Düğümü

bash
# Connect worker to master
hitbot worker --master http://master-ip:5000 \
  --auth-token YOUR_SECRET_TOKEN \
  --threads 4 \
  --name "worker-01"

Mimari Diyagram

[Master Node]
    |
    +-- /api (REST endpoint)
    +-- /dashboard (Web UI)
    +-- /ws (WebSocket)
    |
    +--- [Worker 1] (4 threads)
    +--- [Worker 2] (4 threads)
    +--- [Worker N] (4 threads)

Sıkça Sorulan Sorular

HitBot ücretsiz mi?

Evet, HitBot temel sürümü tamamen ücretsiz ve açık kaynaklıdır. Premium özellikler için ayrı bir lisans gerekmektedir.

Hangi arama motorları desteklenir?

Google, Bing, Yandex ve DuckDuckGo desteklenmektedir. Her arama motoru için özel simülasyon profilleri mevcuttur.

Proxy kullanmak zorunlu mu?

Zorunlu değildir ancak gerçekçi trafik simülasyonu için proxy kullanımı kesinlikle önerilir. Farklı IP adreslerinden gelen trafik daha doğal görünür.

Kaç aynı anda oturum çalıştırabilirim?

Bu, sisteminizin RAM ve CPU kapasitesine bağlıdır. Genel olarak her oturum için ~500MB RAM ve 1 CPU çekirdeği ayırmanız önerilir.

GA4 entegrasyonu nasıl çalışır?

HitBot, gerçekçi GA4 ölçüm protokolü istekleri oluşturur. Page view, session, engagement ve özel etkinlik verileri otomatik olarak gönderilir.

Güncellemeleri nasıl takip edebilirim?

GitHub repository'yi takip ederek veya Telegram kanalımıza katılarak en son güncellemelerden haberdar olabilirsiniz.