Harvey: Claude aboneliğinle çalışan ücretsiz satış ajanı
Harvey işletmeleri haritadan buluyor, sitelerini okuyup puanlıyor, her birine ayrı mail yazıp cevapları yürütüyor. Kurulum ve Türkiye notları burada.
HARVEYInstagram'da HARVEY yazıp geldiysen doğru yerdesin. Linkler ve kurulum adımları bu sayfada.
Harvey, Claude Code ya da Codex aboneliğinle çalışan açık kaynak (MIT) bir satış ajanı. Haritadan işletme bulup sitelerini okuyor, sana uygunluklarını puanlıyor, her birine ayrı soğuk mail yazıyor ve cevapları takip ediyor. Ayrı bir model API faturası yok; varsayılan ayarda hiçbir mail sen onaylamadan gitmiyor.
Harvey, ethanplusai ekibinin yazdığı açık kaynak bir satış ajanı. Ne sattığını ve kime satmak istediğini söylüyorsun; o işletmeleri buluyor, sitelerini okuyor, her birine sitesinden bir detaya değinen ayrı bir mail yazıyor ve gelen cevapları görüşmeye doğru götürüyor. Model tarafını zaten ödediğin Claude aboneliğinden kullanıyor, yani ayrı bir API faturası çıkmıyor.
Harvey tam olarak ne yapıyor
Harvey senin bilgisayarında bir döngü olarak çalışıyor. Her turda uyanıyor, bütçeye bakıyor, en çok neye ihtiyaç olduğuna karar veriyor, o işi yapıp kaydediyor ve uyuyor. Varsayılan aralık 15 dakika. Bir turda yaptığı işler şunlar:
- İşletme buluyor. Varsayılan kaynak OpenStreetMap ve ücretsiz, hesap da istemiyor. Daha geniş tarama için ücretli kaynaklar da seçilebiliyor.
- Sitelerini okuyor. Her işletme için birkaç sayfa çekip model kullanmadan bilgi topluyor: sitesi var mı, online randevu var mı, blog en son ne zaman güncellenmiş, iş ilanı var mı, reklam veriyor mu gibi.
- Puanlıyor. Topladığı bilgileri senin tarif ettiğin ideal müşteriyle karşılaştırıp uygunluk puanı veriyor.
- Mail yazıyor. Her işletmeye, sitesinde bulduğu bir şeye değinen 3 maillik bir dizi hazırlıyor. İlk iki mail 75 kelimenin altında, üçüncüsü 40 kelimenin altında.
- Cevapları yürütüyor. Gelen cevabı okuyup cevap taslağı yazıyor. Karşı taraf sözleşme isterse ya da şikâyet ederse konuşmayı sana bırakıyor.
Bütün süreci localhost:5555 adresindeki bir panelden izliyorsun: bugünün işleri, bulunan işletmeler, giden kutusu ve konuşmalar.
Neden "API faturası yok" önemli
Benzer satış ajanlarının çoğu yapay zekâ modelini API üzerinden kullanıyor ve her kelime için para ödüyorsun. Gün boyu döngüde düşünen bir ajan, gün boyu kredi yakıyor demek. Harvey ise bilgisayarındaki claude komutunu kullanıyor; model çağrıları Claude Pro ya da Max aboneliğinin kullanım sınırından düşüyor. ChatGPT aboneliğin varsa Codex'i de seçebiliyorsun (sadece macOS ve Linux).
Harvey'in Claude çağrıları senin kendi Claude Code ayarlarından ayrı çalışıyor: senin CLAUDE.md dosyan, eklentilerin, MCP sunucuların ve geçmişin bu çağrılara karışmıyor.
Kurulum
Gerekenler:
- Python 3.11 ya da üstü. macOS'ta hazır gelen sürüm 3.9; önce
brew install python@3.13ile yenisini kur. - Giriş yapılmış bir Claude Code (
claude login) ve Claude Pro ya da Max aboneliği. - Mail göndermek için bir posta kutusu. Gmail/Google Workspace, Microsoft 365 ya da SMTP destekleniyor.
En kolay yol, kurulumu Claude'a yaptırmak:
git clone https://github.com/ethanplusai/harvey.git
cd harvey
claude
Claude Code açılınca şunu yaz:
set up Harvey for me
Depodaki CLAUDE.md dosyası Claude'u bir kurulum sihirbazına çeviriyor: eksikleri kuruyor, ihtiyaç duyduğu bilgileri soruyor ve Harvey'i senin ürününe göre eğitiyor.
Kendin kurmak istersen sıra şöyle:
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
cp .env.example .env # ayarları düzenle
harvey train https://senin-siten.com
harvey signals --confirm free # ücretsiz sinyalleri onayla
harvey discover # işletmeleri bul
harvey dashboard # paneli aç
harvey run # döngüyü başlat
harvey train komutu senin sitene bakıp ne sattığını ve kime satman gerektiğini öğreniyor. harvey signals adımı atlanamıyor: Harvey hangi bilgileri toplayacağını sana soruyor ve sen onaylamadan hiçbirini toplamıyor. 29 sinyalin 26'sı ücretsiz.
Hiçbir mail sen onaylamadan gitmiyor
Varsayılan mod "onay" modu. Yazılan her mail, takip maili ve cevap Outbox'ta bekliyor; A ile onaylıyor, R ile reddediyorsun. Terminalden de bakabilirsin:
harvey outbox # bekleyen mailleri gör
harvey sending pause # acil durdurma: bütün gönderimi keser
Gönderimden önce model kullanmayan bir kontrol daha var. Doldurulmamış şablon alanı, yasaklı ifade, sınırı aşan uzunluk, fazla link ya da veritabanıyla uyuşmayan alıcı gibi hatalarda maili durduruyor. Bir de "bunlara asla yazma" listesi tutabiliyorsun (compliance.do_not_contact): rakipler, mevcut müşterilerin, istemediğin kişiler.
Türkiye'de kullanırken dikkat et
Harvey'in hukuk ayarları ABD (CAN-SPAM) ve AB/İngiltere (GDPR, PECR) kurallarına göre hazırlanmış. Türkiye için birkaç şeyi kendin ayarlaman gerekiyor:
- Kime gönderdiğine dikkat et. Türkiye'de esnaf ve tacirlere önceden onay almadan ticari ileti gönderilebiliyor, ama ret hakkı her mailde açıkça sunulmalı. Şahıslara izinsiz ticari ileti göndermek yasak. Sınırı tam bilmiyorsan bir hukukçuya danış.
- Listeden çıkma satırını ayarla. Harvey her soğuk mailin altına bir çıkma satırı koyuyor ve bu satırın tanıdığı bir cevabı istemesi gerekiyor ("STOP", "unsubscribe" gibi). Türkçe bir satır yazacaksan içine STOP kelimesini koy:
Bir daha yazmamı istemezseniz STOP yazmanız yeterli. - Mailleri Türkçe yazdır. Harvey'in belgeleri ve örnekleri İngilizce. Satış bilgisi
skills/klasöründeki düz Markdown dosyalarında duruyor ve düzenlenebiliyor; Türkçe yazma kuralını oraya ekleyebilirsin. İlk taslakları Outbox'ta tek tek oku. - Ana alan adından gönderme. Soğuk maili ana alan adından ya da ilk gün yüksek hacimle göndermek, adresini kalıcı olarak spam'e düşürebilir. Ayrı bir gönderim alan adı al, SPF, DKIM ve DMARC kayıtlarını kur, 2-4 hafta ısındır ve günde 10-20 mail ile başla.
harvey warmupkomutu hazır olup olmadığını söylüyor. - Biri sorarsa yapay zekâ olduğunu söylesin. Harvey, karşı taraf "bir yapay zekâyla mı konuşuyorum" diye sorarsa doğruyu söyleyecek şekilde ayarlanmış. Bunu değiştirme.
Kapı kapı gezip yüz yüze satmayı seviyorsan bizim Mahalle Avcısı sistemimize de bak: sitesi olmayan esnafı bulup her birine hazır site kuruyor. Harvey ise mail tarafını üstleniyor.
Bizim yorumumuz
Harvey'de en sevdiğimiz şey frenlerin çok olması. Hangi bilgilerin toplanacağını sen onaylıyorsun, her mail Outbox'ta bekliyor, acil durdurma düğmesi var. Mail başına 75 kelime sınırı ve kişiye özel detay kuralı da az ama yerinde mail yazdırmaya göre kurulmuş.
Bizce en çok, ne sattığını net bilen ve az sayıda doğru işletmeye ulaşmak isteyen serbest çalışanlara ve küçük ajanslara yarar. Dikkat edilecek iki nokta var. Birincisi, OpenStreetMap kapsamı her semtte ve her sektörde aynı değil. İkincisi, Türkçe mail kalitesi senin skills/ ayarlarına bağlı. İlk hafta otomatik pilotu açma: birkaç düzine maili kendin oku, cevapları izle, sonra hacmi artır.
Harvey'in GitHub sayfası: github.com/ethanplusai/harvey. MIT lisanslı, 5 Kasım 2026 itibarıyla 4.400'den fazla yıldızı var. Anthropic ya da OpenAI ile resmi bir bağlantısı yok. Sponsorlu değildir. Bu sayfa hukuki tavsiye değildir.
Sık sorulanlar
Harvey gerçekten ücretsiz mi?
Yazılımın kendisi ücretsiz ve MIT lisanslı. Model çağrıları zaten ödediğin Claude Pro/Max ya da Codex erişimi olan ChatGPT aboneliğinden gidiyor, ayrı bir API faturası çıkmıyor. Varsayılan işletme kaynağı OpenStreetMap de ücretsiz. Para isteyebilecek tek kısım mail tarafı: ayrı bir gönderim alan adı, bir posta kutusu (Google Workspace gibi) ve isteğe bağlı bir ısınma (warmup) servisi.
Mailleri kendi kendine mi gönderiyor?
Varsayılan ayarda hayır. Yazdığı her mail Outbox'ta (giden kutusu) onayını bekliyor; tek tek onaylıyor ya da reddediyorsun. Otomatik pilot modu var ama onu sen açman gerekiyor. Ayrıca gönderimden önce model kullanmayan bir kontrol, bozuk şablon, yasaklı ifade, fazla link ya da yanlış alıcı gibi hataları durduruyor.
Bilgisayar sürekli açık mı kalmalı?
Harvey senin bilgisayarında bir döngü olarak çalışıyor: uyanıyor, ne yapılması gerektiğine bakıyor, işini yapıp uyuyor. Varsayılan aralık 15 dakika. Bilgisayar kapalıyken çalışmaz. Sürekli açık bir Linux sunucun varsa Docker ile de kurulabiliyor.
Türkiye'deki işletmeleri bulabilir mi?
Varsayılan kaynak OpenStreetMap ve dünya genelinde çalışıyor. Bulabildiği işletme sayısı o bölgenin haritada ne kadar iyi işlendiğine bağlı: dükkânı olan işletmeler iyi görünüyor, vitrini olmayan hizmet işleri (tesisatçı, çatı ustası gibi) zayıf kalıyor. Kendi Mahalle Avcısı denememizde Kadıköy'de 4.837 işletme çıkmıştı.
Türkiye'de toplu soğuk mail atmak yasal mı?
Kesin cevabı bir hukukçu verir. Genel kural şu: esnaf ve tacirlere önceden onay almadan ticari ileti gönderilebiliyor, ama her mailde kolayca reddetme (listeden çıkma) imkânı olmalı. Bireylere, yani şirket adına değil kişi olarak kullanılan adreslere izinsiz ticari ileti göndermek yasak. Harvey'in hukuk ayarları ABD ve AB kurallarına göre hazırlanmış; Türkiye için ayrıca bakmalısın.











































