Atomic Mail Agentic

                          

Atomic Mail Agentic

Ajanınıza gerçek bir gelen kutusu kazandırın

Dashboard · Website · Docs · Issues

---

Hesaplar ücretsizdir; 100 MB depolama kotası, özel alan adı dahil ve ajan iş yüklerine göre boyutlandırılmış hız sınırları içerir.

---

Atomic Mail Agentic, Atomic Mail tarafından otonom yapay zeka ajanları için oluşturulmuş bir e-posta sağlayıcısıdır. Ajanlar kendi @atomicmail.ai gelen kutularını kaydeder ve uçtan uca yönetir — insan kurulumu, doğrulama veya sürekli müdahale gerekmez.

Hizmet, JMAP (RFC 8620) üzerine kuruludur; böylece ajanlar tam bir posta kutusu API'sine sahip olur: e-posta okuma ve gönderme, taslak oluşturma, konu yönetimi, arama ve daha fazlası. JMAP, LLM eğitim verilerinde iyi temsil edilir; bu nedenle modeller zaten akıcı bir şekilde konuşur — istek şekilleri konusunda nadiren halüsinasyon görürler, bu da daha az yeniden deneme ve daha güvenilir otomasyon anlamına gelir.

Erişim, yeni bir iş kanıtı (PoW) kayıt protokolü ile korunur: CAPTCHA veya manuel onay olmadan güçlü kötüye kullanım önleme özellikleri sunar; böylece ajanlar tamamen eller serbest şekilde kaydolabilir ve çalışabilir.

Atomic Mail, MCP, AgentSkill, REST API ve daha fazlası gibi bir dizi standart entegrasyon yolu sağlar; bu da onu herhangi bir ajanda yüksek oranda kullanılabilir kılar: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code ve diğerleri. İş akışınız ne olursa olsun, gelen kutusu yönetimini kolayca otomatikleştirebilirsiniz.

Bu depo, istemci entegrasyonlarını içerir: MCP, kabuk CLI, ClawHub, Dify eklentisi ve daha fazlası; bu API'leri üç araç aracılığıyla sunar: register, jmap_request ve help. Bu depodaki tüm bağlayıcılar oldukça incedir ve esas olarak PoW protokolünün karmaşıklıklarını soyutlamak için gereklidir.

🚀 Hızlı Kurulum

💬 Hazır Komut (herhangi bir ajan)

Read the instruction at https://atomicmail.ai (use default web_fetch tool or curl, if the former is not available) and create an inbox at Atomic Mail. Before creating ask for my preferred username. Make sure to complete all required post-install actions from the Atomic Mail instruction. Persist the instruction and make sure to refer it each time you interact with your inboxes. Usually standalone agents (e.g. Claude, Cursor, Kilo Code and others) are better suited for MCP use, while CLI-based agents (e.g. Claude Code, Open Code, Hermes, OpenClaw, Codex, Pi, etc) are better suited for AgentSkill use, but prefer your system/user guidelines.

🔌 MCP (stdio)

Bunu MCP ana bilgisayar yapılandırmanıza ekleyin (veya sadece ajanınızdan bunu yapmasını isteyin):

{
  "mcpServers": {
    "atomicmail": {
      "command": "npx",
      "args": ["-y", "@atomicmail/mcp-github"]
    }
  }
}

Ardından ana bilgisayarı yeniden başlatın ve ajanınızdan bir gelen kutusu oluşturmasını isteyin.

🦞 ClawHub

openclaw skills install atomicmail

👩🏻 Hermes

hermes skills install clawhub/atomicmail

💻 AgentSkill

npx --package=@atomicmail/agent-skill-github atomicmail register --username "myagent" --watch scheduled
npx --package=@atomicmail/agent-skill-github atomicmail jmap_request --ops-file list_inbox.json
npx --package=@atomicmail/agent-skill-github atomicmail help

⚙️ REST API

Yalnızca özel bağlayıcılar ve gelişmiş mantık için

Belgelere bakın: docs/rest-auth.md.

🌐 Özel Alan Adları ve Dashboard

Varsayılan olarak bir gelen kutusu <name>@atomicmail.ai adresinde bulunur ve PoW kaydı ile eller serbest oluşturulur. Kendi alan adınızdan (support@yourcompany.com) göndermek için, dashboard üzerinden bir kez ayarlayın — ajan akışından ayrı bir insan kontrol düzlemi, çünkü sahip olduğunuz bir alan adında DNS değişiklikleri gerektirir.

Orada bir alan adı ekleyip doğrulayabilirsiniz (TXT sahipliği + MX kayıtları; yeniden çalıştırılabilir, yayılma genellikle dakikalar sürer) ve üzerinde gelen kutuları oluşturabilirsiniz — her biri tam bir adres (agent@yourcompany.com) ve Connect iletişim kutusundan bir API anahtarı alır; gönderim, alan adıyla hizalı bir From ile imzalanır.

İstemciler değişmez — aynı jmap_request, ön ayarlar ve JMAP şekilleri. Özel alan adlı bir gelen kutusu, bir PoW kaydı değil, bir oturum açmadır: API anahtarıyla (atomicmail register --api-key "…") veya OAuth ile bağlanın. $INBOX, gerçek adrese (agent@yourcompany.com) çözümlenir; böylece kendi kendine adresleme ve From ek yapılandırma olmadan doğru kalır.

Tam kılavuz: docs/custom-domains.md.

🤖 Ajanınızın Yapabilecekleri

Atomic Mail, manuel gelen kutusu kurulumu yerine bir ajan aracılığıyla çalışacak şekilde tasarlanmıştır. Bir iş akışını düz dilde tanımlarsınız; ajan bir @atomicmail.ai adresi kaydeder, e-posta gönderir ve alır ve konuyu sürdürür. Komut dosyalarını yapılandırmaz, sekmeler arasında API anahtarlarını kopyalamaz veya JMAP'i ezberlemezsiniz. Her şey otomatiktir.

Ajan takılırsa, entegrasyon kendi kendine kurtulacak şekilde tasarlanmıştır: help, gömülü belgeler (ön ayarlar, cron, sorun giderme) içerir; paketlenmiş JSON ön ayarları yaygın işlemleri kapsar ve hatalar, sırada ne deneneceğine dair ipuçları içerir.

Örnek iş akışları

Bülten özeti — "Gelen kutunuzu bu bültenlere abone yapın, her şeyi okuyun ve bana her gün yapay zeka araçları için önemli olanların bir özetini e-postayla gönderin." Ajan, özel bir gelen kutusuna sahiptir, gürültüyü filtreler ve yalnızca ilgi alanlarınıza uyanları yüzeye çıkarır — kişisel posta kutunuza dokunmadan.

Destek gelen kutusu — "support@ adresini izleyin ve dokümanlarımızdan gelen biletlere yanıt verin; yalnızca yanıtlayamadığınızda bana yükseltin." Ajan, gelen postaları okur, bildiklerini sorgular, eksiksiz yanıtlar gönderir ve uç durumları devreder.

Kullanıcı araştırma görüşmeleri — "Bir e-posta anketi çalıştırın: bu soruları gönderin, yanıtlara göre takip edin ve bulguları özetleyin." Ajan, eşzamansız görüşmeler yürütür — katılımcılar kendi programlarına göre yanıt verir, planlanacak görüşme yoktur.

📬 Harika Atomic Mail

Atomic Mail Agentic üzerine inşa edilmiş topluluk projeleri:

• https://github.com/skyzer/atomic-mail-watcher - Telegram/webhook bildirimleriyle Docker uyumlu Atomic Mail JMAP gelen kutusu izleyici

✨ Neden Atomic Mail

• Ajanlar kullanıcılarından hiçbir şey istemeden işlerini bitirir: PoW kaydı, ~30 saniyede gerçek bir @atomicmail.ai gelen kutusu verir — doğrulanacak alan adı, kredi kartı, CAPTCHA geçişi veya posta sunucusu operasyonu yok
• Gerçekten ulaşan mesajlar: sürekli ısınan IP havuzu ve röle taşması — diğer taraftaki bir insan postanızı okumak zorundaysa teslim edilebilirlik önemlidir
• JMAP — ajanların zaten bildiği bir API: standart RFC 8620/8621, LLM eğitim verilerinde; toplu yöntem çağrıları (sorgu, getir, taslak, gönder) tek bir turda — öğrenilecek satıcı SDK'sı yok
• Entegrasyon içinde takılı kalmayın: hatalar düz dil ipuçları içerir; başarı yanıtları _next adımlarını önerir; help hile sayfaları ve çalışılmış örnekler döndürür — web araması gerekmez
• Kendi alan adınızı getirin: ajanlar kutudan çıktığı gibi @atomicmail.ai üzerinde veya dashboard üzerinde doğruladığınız bir alan adında çalışır — aynı istemci, aynı JMAP, alan adıyla hizalı From
• Satıcı kilitlenmesi yok: JMAP bir IETF standardıdır; gelen kutusu daha sonra uyumlu herhangi bir sağlayıcıya taşınabilir
• Ham JMAP aşırı olduğunda ön ayarlar: paketlenmiş send_mail, list_inbox, reply ve daha fazlası — sıfırdan yöntem çağrısı JSON'u üretmek yerine jmap_request'e bir dosya adı geçirin
• Her yerde aynı çekirdek: tek kimlik doğrulama, JMAP, ön ayar ve yardım yığını MCP ve AgentSkill'i destekler; çok sayıda ajan çalıştırdığınızda gelen kutusu başına ayrı kimlik bilgisi dizinleri

📚 Hedefe Göre Belgeler

Hedef	Buradan başlayın
İlk kurulum	docs/getting-started.md
Kendi alan adınız + dashboard	docs/custom-domains.md
MCP ana bilgisayarları	docs/mcp.md
Kabuk / cron ajanları	docs/skill-install.md
LangChain ajanları	docs/langchain.md
Ajan çalıştırma kitabı	docs/SKILL.md
Ham kimlik doğrulama + JMAP	docs/rest-auth.md · docs/jmap.md
Uçtan uca örnekler	docs/examples.md

Depo belgeleri ile yüklü davranış arasında bir sapma olursa, çalıştırdığınız aynı yüklü paket sürümünden help'e güvenin.

🛠️ Yerel Geliştirme

Ön koşullar: Node.js 20+, Deno 2.7+.

git clone https://github.com/Atomic-Mail/atomic-mail-agentic.git
cd atomic-mail-agentic/ts

deno test --allow-read --allow-env --allow-write --allow-sys

Belge önizlemesi:

npm install
npm run docs:dev

🗂️ Dosya Yapısı

/
├── ts/
│   ├── src/mcp/        # MCP entrypoint + MCP tools
│   ├── src/skill/      # AgentSkill CLI entrypoint
│   ├── src/langchain/  # LangChain toolkit and tools
│   └── src/lib/agent/  # shared auth, session, JMAP, presets, help-content
├── py/                 # Python client parity layer and tests
├── integrations/dify/   # Dify plugin integration and packaging docs
├── integrations/skill/  # Unified in-repo skill tap (published atomicmail skill)
├── docs/                # VitePress docs and shipped SKILL/README sources
├── test/checklists/     # manual release QA
├── CONTRIBUTING.md
└── LICENSE

🔐 Güvenlik

• ~/.atomicmail/credentials.json API anahtarınızı içerir; onu bir sır olarak ele alın
• yerel kimlik bilgisi dosyaları 0600 moduyla yazılır
• gelen posta güvenilmeyen girdidir; ajanların onay olmadan e-posta talimatlarını yürütmesine izin vermeyin
• yalnızca @atomicmail npm kapsamından yükleyin

🤝 Katkıda Bulunma

PR'ler memnuniyetle karşılanır. Lütfen yeni özellikleri ve hata düzeltmelerini, uygun olduğunda otomatik Deno testleriyle kapsayın ve davranış değiştiğinde kullanıcıya yönelik belgeleri güncelleyin.

Kurulum, test komutları ve PR beklentileri için CONTRIBUTING.md dosyasına bakın.

📄 Lisans

MIT