Botfusions - AI Automation & Data Extraction Platform

About

Botfusions, Istanbul merkezli premium AI destekli veri cikarma ve otomasyon cozumleri sunan bir platformdur. Modern isletmeler icin akilli otomasyon araclari gelistiriyoruz.

"Precision in every byte."

Services

Service	Description
AI Automation	Yapay zeka destekli surec otomasyonu ve akilli is akislari
Data Extraction	Web sitelerinden ve dijital kaynaklardan akilli veri cikarma
SEO/GEO Optimization	Geleneksel arama motoru + AI arama motorlari (ChatGPT, Claude, Perplexity) optimizasyonu
Chatbot Development	n8n, Make.com ve ozel platformlarda AI chatbot gelistirme
Process Automation	Tekrarlayan is sureclerinin akilli otomasyonu
Custom Solutions	Isletmenize ozel yapay zeka cozumleri

Features

• 3D Galaxy Landing Page - Three.js ile interaktif galaksi gorsellestirme
• Multi-language - Turkce/Ingilizce (varsayilan: EN)
• Flexible Pricing - Growth, Pro ve Enterprise paketleri ve guncel fiyatlandirmalar
• Blog System - JSON tabanli dinamik blog yonetimi (Dedicated /blog sayfasi)
• AI ChatBot - RAG pipeline (OpenAI embeddings + Supabase vector search + OpenRouter LLM) ile akilli sohbet botu
• GEO Analysis v2.0 - Netlify Functions + OpenRouter + Resend ile AI destekli premium GEO hazirlik analizi. Koyu tema (Dark Mode), Web Report Viewer entegrasyonu ve blur-free net raporlama.
• Info Page - Kurumsal belgelerin (Faaliyet Belgesi, Vergi Levhası) sunuldugu premium sayfa
• Corporate Branding - Alt markalarin yasal aidiyetini belirten dinamik gorsel/metin ibareleri
• Chat History - Supabase'de konusma gecmisi kaydi (n8n uyumlu)
• Contact Form - Netlify Functions + Resend entegrasyonu (Arıza giderme ve stabilite odaklı)
• FAQ Section - Accordion animasyonlu SSS bolumu
• Responsive Design - Tum cihazlarda mukemmel gorunum
• Dark Mode - Modern koyu tema ve glass morphism efektleri
• SEO & GEO - Kapsamlı Schema.org (JSON-LD) entegrasyonu (WebSite, SoftwareApplication, AboutPage, FAQPage, BlogPosting), Open Graph, AI arama motoru optimizasyonu
• Robots.txt & Sitemap - Kapsamlı AI arama motoru tarayıcı izinleri (ChatGPT, Claude, Perplexity, GPTBot vb.)
• Security - OWASP 2025 uyumlu, DOMPurify XSS korumasi (detaylar)

Tech Stack

Category	Technologies
Core	React 19, TypeScript 5.8, Vite 6
3D	Three.js, @react-three/fiber, @react-three/drei
UI	TailwindCSS, Framer Motion, Lucide Icons
Security	DOMPurify, CSP Headers
Backend	Netlify Functions (Serverless API)
AI/ML	OpenRouter (Claude Haiku 4.5), OpenAI Embeddings
Database	Supabase (Postgres + pgvector)
Services	Resend (Email), EmailJS
Routing	React Router DOM 7

Getting Started

Prerequisites

• Node.js >= 16.x
• npm >= 8.x

Installation

# Clone the repository
git clone https://github.com/botfusions/botfusions.v3.git
cd botfusions.v3

# Install dependencies
npm install

# Create environment file
cp .env.example .env.local

# Start full stack (frontend + Netlify Functions)
 npx netlify dev

Tarayicinizda http://localhost:8888 adresine gidin.

Environment Variables

.env dosyasini olusturun ve degerleri doldurun:

# Frontend (Vite tarafindan okunur)
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

# Backend-only (Netlify Functions - DO NOT use VITE_ prefix)
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_KEY=your_supabase_service_role_key
OPENROUTER_API_KEY=your_openrouter_api_key
RESEND_API_KEY=your_resend_api_key
OPENROUTER_MODEL=anthropic/claude-haiku-4.5  # Opsiyonel

Onemli: VITE_ prefix'i client-side'da gorunur. Backend API key'leri icin ASLA VITE_ kullanmayin. Her iki prefix formatinda da (VITE_SUPABASE_URL ve SUPABASE_URL) tanimlanmasi gerekir — Vite ve Netlify Functions farkli env yukleme mekanizmalari kullanir.

Email Bildirimi: Iletisim formu gonderilen mailler RESEND_API_KEY ile contact-notify Netlify Function uzerinden info@botfusions.com adresine iletilir. EmailJS artik kullanilmamaktadir.

Pages

Route	Page	Description
/	Galaxy Viewer	Interaktif 3D galaksi landing page
/home	Main Page	Hero, Ozellikler, 3 Blog preview
/blog	Blog Page	Tum blog yazilarinin listesi
/info	Info Page	Kurumsal belgeler ve yasal bilgiler
/blog/:id	Blog Detail	Tam icerikli blog makaleleri
/report/:id	Report Viewer	AI destekli GEO/SEO analiz raporu

ChatBot Architecture

AI destekli sohbet botu RAG (Retrieval-Augmented Generation) mimarisi kullanir:

User Message
     ↓
1. OpenAI Embeddings (text-embedding-ada-002)
     ↓
2. Supabase Vector Search (pgvector, cosine similarity)
     ↓
3. OpenRouter LLM (Claude Haiku 4.5)
     ↓
4. Chat History Save (Supabase - n8n uyumlu)
     ↓
Response

Ozellikler

• Strict Scope: Sadece Botfusions bilgi tabanindaki sorulari yanitlar
• Knowledge Base: Supabase botfusions_sss tablosunda vektorize edilmis dokuman arama
• Smart Responses: Fiyat sorularinda otomatik iletisim bilgisi yonlendirmesi
• Chat History: n8n chat_histories formatiyla uyumlu Postgres kaydi
• Serverless: Netlify Functions ile tamamen sunucusuz mimari

Dosyalar

• netlify/functions/chat.mjs - Serverless chatbot endpoint (/api/chat)
• supabase/match_documents.sql - Vector similarity search fonksiyonu
• components/ChatBot.tsx - Frontend UI komponenti

GEO: Generative Engine Optimization (v2.0)

GEO (Generative Engine Optimization), web iceriginizi AI arama motorlarinda (ChatGPT, Claude, Perplexity, Google SGE, Bing Chat) gorunur kilmak icin optimize eder. Mart 2026 guncellemesi ile (v2.0) raporlama arayuzu tamamen yenilenmistir:

v2.0 Yenilikleri

• Premium Dark Mode: Koyu tema ve modern glass-morphism tasarimi.
• Web Report Viewer: /report/:id rotası üzerinden erişilebilen, tamamen izole edilmiş (iframe srcDoc) profesyonel raporlama sayfası.
• Blur-Free Analytics: Eskiden kilitli olan bölümlerdeki "buzlanma" (blur) efekti kaldırılarak raporun tamamı şeffaf ve net hale getirildi.
• Supabase Integration: Raporlar artık BFW_geo_leads tablosunda report_html olarak saklanıyor ve Row-Level Security (RLS) politikaları ile güvenli bir şekilde sunuluyor.
• Premium Email: Resend üzerinden gönderilen, butonlu ve yedek linkli kurumsal e-posta tasarımları.
• Cost Efficiency: Analiz başı maliyet ~$0.0003 (yaklaşık 0.01 ₺) seviyesine indirildi.
• Direct Contact: Rapor içerisinden doğrudan "Hepsini Gör" butonu ile uzman desteğine erişim.

Recent Updates (March 2026)

• AI Crawler & EEAT Reinforcement: Expanded the AI Terminology Glossary to 56+ terms with DefinedTerm schema and semantic interlinking from the GEO Landing Page. Added off-page authority signals (G2, Capterra badges), ROI Case Studies, and a comprehensive llms.txt file (akses) to guide AI crawlers (GPTBot, PerplexityBot, Google-Extended).
• AI Search Growth Statistics: Integrated market-leading data showing a %527 increase in AI search traffic (Feb/March 2026) to reinforce authority and signal high EEAT to generative engines.
• Visual Quality & Premium Re-design: Completely removed "low-quality" purple/orange glows and "backlight" effects across the site. Implemented a sharp, matte, and professional premium dark mode aesthetic (LeadForm, PricingCard, GeoLandingPage).
• Analytics & Conversion Finalization: Integrated GA4 and Google Ads tracking for all critical CTAs, lead form submissions, and newly added WhatsApp & Phone Call interactions (G-DFGR4GS0P7 & AW-18013035508). Implemented strict TypeScript typings globally for gtag.js.
• GEO v2.0 UI & UX Finalized: Integrated premium AI-generated hero visuals, a dedicated Knowledge Hub (Wiki/Glossary), and high-end processing animations for the lead form.
• Advanced Marketing Features: Deployed a non-intrusive Exit-Intent Popup and a Floating WhatsApp Support button with conversion tracking.
• Pricing & Trust Refinement: Updated Pricing sections with "Success Green" checkmarks and subtle white/20 borders for better psychological trust and visual balance.
• Lead Form Processing Logic: Implemented sophisticated "AI Engine Scanning" and "Analysis Started" states with Framer Motion.
• System Reorganization: Separated marketing and advertisement tools into a standalone botfusions-reklam-v3 directory.
• GEO Analyze Stability: Verified the integrated GEO analysis engine with successful live tests.

Neden GEO Onemli?

Geleneksel arama motorlari link listesi sunarken, Generative Engines (GE) birden fazla kaynaktan bilgi sentezleyerek dogrudan yanit uretir:

• Kullanicilar artik web sitelerine gitmeden yanit aliyor
• Icerik olusturucularin organik trafigi azaliyor
• Inline citation'lar ile gorunurluk karmasik ve cok boyutlu

GEO vs SEO

Metrik	Geleneksel SEO	GEO
Gorunurluk Olcumu	Ranking (1-10)	Word Count + Position + Subjective Impression
Optimizasyon Hedefi	Keyword matching	Icerik kalitesi + Credibility + Alintilama
Etkili Stratejiler	Backlinks, Keywords	Citations, Statistics, Quotes, Authoritative tone

GEO Stratejileri (Kanıtlanmış Yöntemler)

Strateji	Gorunurluk Artisi	Aciklama
Quotation Addition	+40%	Guvenilir kaynaklardan alintilar ekle
Statistics Addition	+35%	Nicel istatistikler ekle
Cite Sources	+30%	Guvenilir kaynaklara atifta bulun
Fluency Optimization	+28%	Metin akiciligini iyilestir
Authoritative Tone	+15%	Ikna edici ve otoriter ton kullan
AI Growth Signal	+527% Traffic	Mart 2026 guncel AI arama buyumesi

Specialized GEO Subpages (March 2026)

Page	Topic	Optimization Goal
B2B SaaS GEO	High-intent B2B	ChatGPT/Gemini SaaS recommendations
LLM SEO USA	Global Market	USA 2025 LLM Search Trends
AI Content	Semantic Strategy	AI-First Content Architecture

Perplexity Visibility & Freshness Strategy (2026)

Botfusions, Perplexity ve diger AI arama motorlarinda maksimum gorunurluk elde etmek icin Freshness-First (Tazelik Oncelikli) bir strateji uygulamaktadir.

Temel Hedefler

• Visibility Boost: 4 ay icinde %5 olan gorunurluk puanini %30-35 bandina cikarmak.
• Freshness Control: Perplexity alintilarinin %50'sinin son 3 gunluk iceriklerden gelmesi nedeniyle uygulanan haftalik icerik donguleri.
• Social Validation: Reddit (alintilarin %46.7'si) ve YouTube (sosyal sinyallerin %73.1'i) odakli topluluk etkilesimi.

Dil Stratejisi

• Global Visibility: İngilizce Reddit ve blog icerikleri (Perplexity tetikleyicileri).
• Market Focus: Turkce LinkedIn ve yerel Reddit etkilesimi (TR pazari liderligi).

Dosyalar ve Kaynaklar

• doc/how-to-increase-ai-visibility-2026-tr.md - Guncel strateji rehberi.
• brain/weekly_action_plan_w1.md - Haftalik operasyonel plan.

Uygulama Ornekleri

Ornek 1 - Citation Ekleme (+132%):

Oncesi: "Swiss cikolata tuketimi kisibasi yilda 11-12 kilo"
Sonrasi: "Swiss cikolata tuketimi kisibasi yilda 11-12 kilo
(Uluslararasi Cikolata Arastirma Grubu [1] anketi)"

Ornek 2 - Istatistik Ekleme (+65%):

"Son 10 yilda robot kullanimi %70 artti"

Kaynaklar

• Arastirma Makalesi: GEO: Generative Engine Optimization (KDD '24)
• Veri Seti: GEO-bench - 10,000 sorgu, 9 farkli kaynak
• Domain-Specific: Debate → Authoritative, Facts → Citations, Opinion → Statistics

Project Structure

botfusions.v3/
├── components/
│   ├── galaxy/          # 3D Galaxy viewer
│   ├── HomePage.tsx     # Ana sayfa
│   ├── InfoPage.tsx     # Kurumsal bilgiler sayfasi
│   ├── Footer.tsx       # Guncel navigasyon ve Link entegrasyonu
│   ├── BlogDetailPage.tsx
│   ├── ChatBot.tsx      # AI sohbet botu UI
│   ├── ContactSection.tsx
│   ├── LanguageContext.tsx  # i18n
│   └── ...
├── netlify/
│   └── functions/
│       ├── chat.mjs           # Serverless chatbot endpoint
│       ├── geo-analyze.mjs    # Website analysis & PDF reporting
│       └── contact-notify.mjs # Contact form processing via Resend
├── supabase/
│   └── match_documents.sql  # Vector search function
├── public/data/         # Blog JSON verileri
├── dist/                # Uretilen production build (git'e commit edilmez)
├── App.tsx              # Router setup
├── index.html           # HTML + security headers
├── netlify.toml         # Netlify build & functions configuration
├── vite.config.ts
└── package.json

Deployment (Netlify)

Otomatik Deploy (Onerilen)

1. Netlify hesabiniza girin
2. Add new site > Import an existing project > GitHub repo secin
3. Build ayarlari netlify.toml tarafindan otomatik algilanir:
   • Build command: npm run build
   • Publish directory: dist
4. Environment variables ekleyin (Site settings > Environment variables):
   • VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY
   • SUPABASE_URL, SUPABASE_SERVICE_KEY
   • OPENROUTER_API_KEY
   • RESEND_API_KEY
   • OPENROUTER_MODEL (opsiyonel, varsayilan: anthropic/claude-haiku-4.5)
5. Supabase Setup (ChatBot icin):
   • Supabase projenizde supabase/match_documents.sql dosyasini calistirin
   • botfusions_sss tablosunu olusturun ve bilgi tabaninizi yukleyin
6. Deploy site

Kritik: Netlify deploy basarisiz olursa, dist/ klasorundeki dosyalarin yerelde npm run build ile uretildiginden emin olun. Eski veya baska bir aracla uretilmis dist/ klasoru blog guncellemelerini yansitmaz.

Manuel Deploy

npm run build
npx netlify deploy --prod --dir=dist

Scripts

npx netlify dev  # Tam stack gelistirme sunucusu (port 8888) - ONERILEN
npm run dev      # Sadece Vite frontend (port 5173, Netlify Functions olmadan)
npm run build    # Production build (dist/ klasorunu gunceller)
npm run preview  # Build onizleme (port 4173)

Not: Blog degisikliklerinin Netlify'a yansiması icin her zaman npm run build calistirin. Yerel gelistirme ortaminda npx netlify dev Vite HMR ile anlik guncelleme saglar, ayri build gerekmez.

Security

Bu proje OWASP Top 10:2025 standartlarina uygun guvenlik onlemleri icerir. Detayli guvenlik raporu icin: SECURITY.md

Guvenlik acigi bildirimi icin: info@botfusions.com

Contributing

1. Fork yapin
2. Feature branch olusturun (git checkout -b feature/AmazingFeature)
3. Degisikliklerinizi commit edin (git commit -m 'Add some AmazingFeature')
4. Branch'inizi push edin (git push origin feature/AmazingFeature)
5. Pull Request acin

Development & Git Commands

Proje üzerinde calisirken takip edilmesi gereken standart is akisi ve sik kullanilan Git komutlari asagidaki gibidir. Tum commit mesajlarinda Conventional Commits standartlarina uyulmalidir.

Yeni Bir Ozellik Gelistirme

# 1. Main branch'e gecin ve guncelleyin
git checkout main
git pull origin main

# 2. Yeni bir feature branch olusturun
git checkout -b feature/AmazingFeature

# 3. Degisikliklerinizi commit edin
git add .
git commit -m "feat(scope): add description"

# 4. Branch'inizi push edin
git push origin feature/AmazingFeature

Git Komut Referansi

Komut	Aciklama
git status	Degistirilmis dosyalari listeler
git diff	Dosyalardaki satır bazlı degisiklikleri gosterir
git log --oneline	Commit gecmisini ozet olarak listeler
git checkout -b <name>	Yeni branch olusturur ve ona gecer
git branch -D <name>	Yerel branch'i zorla siler
git push origin --delete <name>	Uzak sunucudaki branch'i siler

Commit Mesaj Standartlari (Conventional Commits)

• feat: Yeni bir ozellik
• fix: Bir hata duzeltmesi
• docs: Dokumantasyon degisikligi
• style: Formata dayali degisiklikler (CSS, bosluklar vb.)
• refactor: Ne hata duzelten ne de ozellik ekleyen kod degisikligi
• perf: Performans iyilestirmesi
• test: Test ekleme veya guncelleme
• chore: Build sistemi veya bagimliliklardaki degisiklikler

Guvenli Push & Operasyonel Kurallar

Note

OPERASYONEL KURAL: Degisiklikler yerel build (npm run build) uzerinden doğrulanmali ve Git commit mesajlari standartlara uygun olmalidir.

1. Build Kontrolü: Her push oncesi npm run build hatasiz tamamlanmalidir.
2. Lint & Type Check: npx tsc --noEmit ve npx eslint . komutlari ile kod kalitesi doğrulanmalidir.
3. Branch Politikası: Direkt main branch'e push yapilmamali, her zaman PR (Pull Request) sureci isletilmelidir.
4. Görsel Yönetimi: Yeni eklenen blog görselleri public/images/blogs dizininde, uygun isimlendirme (kebap-case) ile tutulmalidir.

License

Bu proje MIT License altinda lisanslanmistir.

Contact

Botfusions - AI Automation & Data Extraction

• Email: info@botfusions.com
• Phone: +90 850 302 74 60
• Website: botfusions.com
• Address: Istanbul, Turkey

---

Visioned and Crafted by Botfusions Team

Botfusions - Automate Smarter, Optimize Faster, and Grow Stronger.