Sosyal medya işbirlikleri için otomatik PDF invoice üreten skill — elle bilgi veya e-posta thread'inden otomatik çıkarım ile
Sosyal medya markalarıyla yapılan işbirliklerin faturalandırılması için kullanılan otomatik PDF invoice oluşturma aracı.
Bu skill iki farklı modda çalışır:
Kullanıcı doğrudan marka adı, şirket bilgileri ve ücreti verir. Script doğrudan çalışır.
Kullanıcı bir marka/şirket adı verir ve "e-postadan çıkar" veya "mail'den bak" gibi bir ifade kullanır. Bu durumda:
[Brand] collaboration with @INSTAGRAM_KULLANICI_ADI formatında oluşturulurINVOICE_[Marka]_[GG-AA-YYYY].pdf şeklinde yapılır~/Downloads klasörüne kopyalanmaya çalışılırfatura-olusturucu/
├── SKILL.md # Bu dosya
├── faturalastir.py # Ana script (fpdf2 ile PDF üretimi)
├── eposta_fatura_oku.py # Gmail'den fatura bilgisi çıkaran script
├── requirements.txt # Python bağımlılıkları
├── Roboto-Regular.ttf # Unicode font (Türkçe karakter desteği)
├── Roboto-Bold.ttf # Unicode font (bold)
├── uretilen-faturalar/ # 📂 Üretilen tüm PDF faturalar buraya kaydedilir
├── fatura-ornekler/ # Eski invoice örnekleri (referans)
├── token_readonly.json # Gmail API token (otomatik oluşur)
└── .venv/ # Python sanal ortamı
/fatura-kes [Marka Adı], [Meblağ] [Para Birimi]
/fatura-kes [Marka Adı], e-postadan bak
veya doğa dilde:
"Seekoo ile olan e-posta yazışmasından fatura bilgilerini çıkar ve fatura kes"
cd _skills/fatura-olusturucu
source .venv/bin/activate
python faturalastir.py \
--brand "Marka Adı" \
--company "Şirket Yasal İsmi" \
--email "[email protected]" \
--address "Şirket Adresi" \
--amount "700" \
--currency "$" \
--output .
cd _skills/fatura-olusturucu
source .venv/bin/activate
python eposta_fatura_oku.py --query "Seekoo" --max-results 5
| Parametre | Zorunlu | Açıklama |
|---|---|---|
--brand | ✅ | Marka adı (description'da kullanılır) |
--company | ✅ | Şirket yasal ismi |
--email | ❌ | İletişim e-postası |
--address | ❌ | Şirket adresi |
--amount | ✅ | Fatura tutarı |
--currency | ❌ | Para birimi (varsayılan: $) |
--output | ❌ | Çıktı dizini (varsayılan: .) |
| Parametre | Zorunlu | Açıklama |
|---|---|---|
--query | ✅ | Gmail arama sorgusu (marka adı, kişi adı, şirket ismi) |
--max-results | ❌ | Döndürülecek max thread sayısı (varsayılan: 5) |
--thread-id | ❌ | Belirli bir thread ID ile doğrudan çekme |
--output | ❌ | Çıktı dosya yolu (varsayılan: stdout) |
E-postadan fatura bilgisi çıkarma işlemi şu adımları takip eder:
cd ./_skills/fatura-olusturucu
source .venv/bin/activate
python eposta_fatura_oku.py --query "[MARKA_ADI]" --max-results 5
JSON çıktısındaki full_conversation alanını oku ve şu bilgileri çıkar:
Çıkarılan bilgileri kullanıcıya göster ve onay al:
📧 E-postadan çıkarılan fatura bilgileri:
🏢 Şirket: SEEKOO LLC
📧 E-posta: [email protected]
📍 Adres: 123 Main St, Suite 100, San Francisco, CA 94102
💰 Tutar: $700
Bu bilgilerle faturayı oluşturayım mı?
Standart faturalastir.py ile faturayı üret.
EMAIL_ADRESI_BURAYA_skills/eposta-gonderim/credentials.json (paylaşımlı OAuth2 credentials)token_readonly.json — ilk çalıştırmada otomatik tarayıcı onayı istenir