T.C. Resmî Gazete Scraper, CLI ve FastMCP Sunucusu
Resmî Gazete sayılarını, kanunları, cumhurbaşkanı kararlarını ve tebliğleri terminalden yapılandırılmış formatta sorgulayın, Python projelerine bağlayın veya LLM ajanlarına yerel Model Context Protocol (MCP) ile entegre edin.
pip install resmi-gazete-cli
uv tool install resmi-gazete-cli
brew tap atacanymc/tap && brew install atacanymc/tap/resmi-gazete-cli
Modüler Katmanlar ve Doğrulanabilir Veri Akışı
Sistem harici bağımlılıkları en aza indirir; HTTP/2 bağlantı havuzu, windows-1254 Türkçe karakter kodlama düzelticisi ve Pydantic V2 veri doğrulama modelleriyle çalışır.
1. Scraper & Core Motor
httpx.AsyncClient ile resmigazete.gov.tr arşivine bağlanır. HTML tablolarını ve DataTables JSON yanıtlarını Pydantic nesnelerine dönüştürür.
2. Terminal CLI Arayüzü
Click ve Rich kütüphaneleriyle yapılandırılmış, renkli ve sütun hizalı terminal tabloları çizer. Otomasyonlar için doğrudan json ve md çıktısı verir.
3. FastMCP Sunucusu
Claude Desktop, Cursor ve VS Code ajanlarına stdio protokolü üzerinden doğrudan 4 adet optimize araç sunar. LLM bağlamını gereksiz etiketlerden temizler.
| Kullanım Katmanı | Hedef Kitle | Çıktı Formatları | Öne Çıkan Özellik |
|---|---|---|---|
| CLI | Geliştiriciler, Hukukçular, Sistem Yöneticileri | Rich Tablo, JSON, Markdown | Sıfır kurulum gereksinimiyle doğrudan terminalden günlük gazete ve arama sorgusu |
| FastMCP | Claude Desktop, Cursor, AI Kodlama Ajanları | LLM Tool Yanıtı (JSON / Düz Metin) | Mevzuat tam metinlerini windows-1254 çözümüyle token tasarruflu sunma |
| Python SDK | Backend Servisleri, Veri Analizi Boru Hatları | Pydantic V2 Modelleri | Tam tip güvenli asenkron istemci, hata sınıflandırması ve bağlantı havuzu |
Doğrulanmış Kurulum Adımları
Ortamınıza uygun paketi seçin ve komutları doğrudan terminalinizde çalıştırın.
# 1. PyPI üzerinden standart Python kurulumu
pip install resmi-gazete-cli
# 2. Veya izole CLI aracı olarak çalıştırma
uv tool install resmi-gazete-cli
# veya: pipx install resmi-gazete-cli
# 3. macOS / Linux Homebrew Tap ile sistem genelinde kurulum
brew tap atacanymc/tap
brew install atacanymc/tap/resmi-gazete-cli
# 4. Sürüm doğrulaması
resmi-gazete-cli --version
CLI Kılavuzu ve Komut Sihirbazı
Aşağıdaki form üzerinden parametreleri belirleyin; sözdizimi doğrulanmış terminal komutunu anında kopyalayarak çalıştırın.
| Komut | Parametre | Kısa Ad | Varsayılan | Açıklama |
|---|---|---|---|---|
daily |
--date |
-d |
Bugün | Sorgulanacak gazete tarihi (GG.AA.YYYY veya YYYY-MM-DD). |
daily |
--mukerrer |
-m |
False | Varsa günün mükerrer sayısını çeker. |
daily |
--category |
-c |
Yok | Yürütme, Yargı veya İlân gibi bölümleri yerel olarak filtreler. |
daily |
--json-output |
-j |
False | Çıktıyı boru hatları için doğrudan JSON formatında üretir. |
search |
--kelime |
-k |
"" | Arama yapılacak anahtar kelime veya metin öbeği. |
search |
--mevzuat-turu |
-t |
Yok | Tür kısayolu (kanun, cb-karar, yonetmelik, teblig, aym, danistay, yargitay). |
search |
--format |
-f |
table | Çıktı formatı: table, json, md. |
FastMCP ile LLM Entegrasyonu
Anthropic MCP standardında çalışan stdio sunucusu. Claude Desktop ve Cursor IDE ile tam uyumludur.
| Araç Adı (Tool) | Parametreler | Dönüş Tipi | İşlev ve Özel Davranış |
|---|---|---|---|
get_todays_gazette |
Yok | dict (GazetteDay) |
Bugünün gazete sayısını ve kategorize edilmiş maddelerini JSON olarak döndürür. |
get_gazette_by_date |
tarih (str), mukerrer (bool) |
dict (GazetteDay) |
Belirtilen tarihteki (ör. 15.11.2024) Resmî Gazete içeriğini çeker. |
search_gazette |
kelime, mevzuat_turu, page vb. |
dict (SearchResponse) |
Resmî Gazete arşivinde parametrik arama yürütür. |
get_document_content |
url (str) |
str (Mevzuat Metni) |
Mevzuatın tam metnini indirir, windows-1254 kodlamasını düzeltir ve HTML temizliği yapar. |
İstemci Yapılandırma Dosyaları
{
"mcpServers": {
"resmi-gazete": {
"command": "resmi-gazete-mcp",
"args": []
}
}
}
{
"name": "resmi-gazete",
"type": "command",
"command": "resmi-gazete-mcp"
}
Asenkron Python İstemcisi ve Veri Modelleri
Tip güvenli Pydantic V2 modelleri ve HTTP/2 bağlantı yönetimi ile projelerinize doğrudan entegre edin.
import asyncio
from resmi_gazete_cli import ResmiGazeteClient
from resmi_gazete_cli.scraper.models import SearchCriteria
async def main():
async with ResmiGazeteClient() as client:
# 1. Günün gazetesini çekme
gazette = await client.get_todays_gazette()
print(f"Gazete Sayısı: {gazette.number}, Tarih: {gazette.date}")
# 2. Parametrik arama yapma
criteria = SearchCriteria(
kelime="yapay zeka",
mevzuat_turu="4", # Yönetmelikler
page=1,
page_size=5
)
results = await client.search(criteria)
print(f"Toplam Sonuç: {results.records_total}")
for item in results.data:
print(f"- [{item.resmi_gazete_tarihi}] {item.baslik}")
if __name__ == "__main__":
asyncio.run(main())
| Hata Sınıfı | Üst Sınıf | Tetiklenme Durumu |
|---|---|---|
ResmiGazeteError |
Exception |
Kütüphaneden fırlatılan tüm hataların temel sınıfı. |
NetworkError |
ResmiGazeteError |
Bağlantı zaman aşımı, DNS çözme hatası veya sunucu yanıt vermediğinde. |
NotFoundError |
ResmiGazeteError |
Belirtilen tarihe ait Resmî Gazete sayısı yayımlanmamışsa veya 404 döndüğünde. |
ParseError |
ResmiGazeteError |
HTML yapısı veya DataTables JSON yapısı beklenmeyen bir biçimde değiştiğinde. |
SSRFError |
ResmiGazeteError |
İstek izin verilen resmi alan adları dışına veya özel ağ adreslerine yönlendiğinde. |
ResponseTooLargeError |
ResmiGazeteError |
Sunucu yanıtı 10MB bellek güvenliği eşiğini aştığında (DoS koruması). |
Üretim Ortamı İçin Koruma Önlemleri
Sistem harici kaynaklardan gelen girdilere ve sunucu manipülasyonlarına karşı çok katmanlı savunma uygular.
SSRF Koruması
Harici HTTP istekleri katı bir şekilde yalnızca resmigazete.gov.tr ve mevzuat.gov.tr alan adlarına izin verir. Loopback (127.0.0.1), yerel ağlar ve bulut metadata IP'leri (169.254.169.254) engellenir.
DoS & Bellek Sınırı
Gelen yanıt boyutları aktarım sırasında denetlenir; 10MB üzerindeki anormal gövdeler belleğe alınmadan ResponseTooLargeError ile sonlandırılır.
Terminal Injection Koruması
Resmî Gazete başlıklarındaki köşeli parantezler ([...]) terminal Rich markup ayrıştırıcısından önce rich.markup.escape ile kaçışlanır; terminal format bozulması engellenir.
Teknik ve Hukuki Ayrıntılar
Resmî Gazete verilerini çekmek için API anahtarı gerekiyor mu?
Hayır. Resmî Gazete verileri kamuya açık resmî yayındır. Herhangi bir üyelik, kayıt veya API anahtarı gerektirmez.
Eski tarihli HTML metinlerinde Türkçe karakterler bozuluyor mu?
Hayır. resmigazete.gov.tr üzerindeki eski arşiv metinleri windows-1254 karakter setiyle yayımlanmıştır. İstemci karakter setini otomatik tespit edip UTF-8'e dönüştürür.
MCP sunucusu yerel makinede mi çalışır?
Evet. FastMCP sunucusu stdio üzerinden yerel bir alt süreç olarak çalışır. Verileriniz üçüncü taraf bir bulut sunucusuna iletilmez.
Mükerrer sayılar nasıl ayrıştırılır?
Mükerrer sayılar Resmî Gazete sisteminde aynı gün içinde yayımlanan ek sayılardır. CLI'da -m, SDK ve MCP'de mukerrer=True bayrağı ile çekilir.