Skip to main content
Resmi Gazete CLI Logo

Resmi Gazete CLI

T.C. Resmi Gazete için Asenkron Python SDK, CLI ve FastMCP Sunucusu

PyPI Sürümü Python Sürümleri Release Durumu CI Durumu Web Dokümantasyonu PyPI Profil Homebrew Tap Lisans


İçindekiler


Genel Bakış

resmi-gazete-cli, T.C. Resmi Gazete (resmigazete.gov.tr) üzerinde yayımlanan kararları, kanunları, yönetmelikleri ve ilanları terminal üzerinden sorgulamak ve LLM ajanlarına aktarmak üzere tasarlanmış asenkron bir araç setidir.

Üç temel arabirim sunar:

  1. Python SDK: httpx ve pydantic tabanlı, TLS doğrulamalı asenkron HTTP istemcisi.
  2. Terminal Arayüzü (CLI): click ve rich tabanlı, formatlanmış konsol çıktısı veren komut satırı aracı.
  3. Model Context Protocol (MCP) Sunucusu: LLM ajanlarının (Claude Desktop, Cursor vb.) günün gazetesini ve geçmiş sayıları doğrudan sorgulayabilmesini sağlayan FastMCP stdio sunucusu.

Dokümantasyon

Detaylı kullanım ve entegrasyon kılavuzları docs/ dizini altında toplanmıştır:

Doküman Kapsam
Web Arayüzü & Canlı Dokümantasyon Komut sihirbazı, interaktif mimari ve tarayıcı dostu kılavuz.
Genel Mimari ve Giriş Sistem mimarisi, veri akış diyagramı ve genel yetenekler.
CLI Kullanım Kılavuzu daily ve search komutları, tüm parametreler, kısayollar ve çıkış kodları.
Model Context Protocol (MCP) FastMCP araçları, Claude Desktop, Cursor ve VS Code yapılandırma rehberi.
Python SDK & API Referansı ResmiGazeteClient API'si, Pydantic modelleri ve asenkron kod tarifleri.

Mimari

Sistem bileşenleri ve katmanlar arası veri akışı aşağıdaki şemada gösterilmiştir:

flowchart TD
    subgraph ClientLayer["Kullanıcı ve Entegrasyon Katmanı"]
        CLI["CLI Arayüzü<br/>resmi-gazete-cli"]
        MCP["FastMCP Sunucusu<br/>resmi-gazete-mcp"]
        SDK["Python SDK<br/>ResmiGazeteClient"]
    end

    subgraph CoreLayer["Çekirdek Kütüphane (resmi_gazete_cli)"]
        Client["ResmiGazeteClient<br/>(httpx.AsyncClient + TLS)"]
        Models["Pydantic Veri Modelleri<br/>(GazetteItem, DailyGazette)"]
        Parser["HTML & JSON Ayrıştırıcı<br/>(BeautifulSoup4 / lxml)"]
    end

    subgraph External["Dış Sistem"]
        Target["T.C. Resmi Gazete Portalı<br/>resmigazete.gov.tr"]
    end

    CLI --> Client
    MCP --> Client
    SDK --> Client
    Client --> Target
    Target --> Client
    Client --> Parser
    Parser --> Models

Kurulum

1. Homebrew ile Kurulum (macOS & Linux)

Homebrew kullanıcıları tek satırla tap ekleyerek aracı kurabilir:

# Depoyu tap olarak ekleyin ve kurun
brew tap AtaCanYmc/resmi-gazete-cli https://github.com/AtaCanYmc/resmi-gazete-cli.git
brew install resmi-gazete-cli

Veya AtaCanYmc/homebrew-tap üzerinden:

brew tap AtaCanYmc/tap
brew install resmi-gazete-cli

2. PyPI Üzerinden Kurulum (Önerilen)

Paketi doğrudan PyPI üzerinden yükleyebilirsiniz:

pip install resmi-gazete-cli

İzole bir CLI aracı olarak çalıştırmak için uv veya pipx kullanabilirsiniz:

# uv ile
uv tool install resmi-gazete-cli

# veya pipx ile
pipx install resmi-gazete-cli

3. Kaynak Koddan Kurulum (Geliştirici Modu)

Projeye katkı sağlamak veya yerel olarak derlemek için:

# Depoyu klonlayın
git clone https://github.com/AtaCanYmc/resmi-gazete-cli.git
cd resmi-gazete-cli

# Sanal ortamı hazırlayın
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Bağımlılıkları yükleyin
pip install --upgrade pip
pip install -e .

Hızlı Başlangıç

Kurulum tamamlandıktan sonra CLI sürümünü kontrol edin:

resmi-gazete-cli --version

Kullanım

1. Komut Satırı Arayüzü (CLI)

Günlük Resmi Gazete (daily)

# Günün sayısını formatlanmış tablo olarak listele
resmi-gazete-cli daily

# Belirli bir tarihteki sayıyı listele (GG.AA.YYYY veya YYYY-MM-DD)
resmi-gazete-cli daily -d 17.11.2026

# Mükerrer sayıyı listele
resmi-gazete-cli daily -d 2026-10-27 -m 1

# Kategoriye göre filtrele (örn. Cumhurbaşkanı, Yönetmelik, Tebliğ, İlan)
resmi-gazete-cli daily -c "Yönetmelik"

# Çıktıyı JSON formatında al
resmi-gazete-cli daily -j
# Anahtar kelime ile arama yap
resmi-gazete-cli search -k "vergi"

# Tarih aralığı ve mevzuat türü ile arama yap (kanun, teblig, yonetmelik, cb-karar, aym)
resmi-gazete-cli search -k "vergi" -t "teblig" -b 01.11.2026 -e 15.11.2026

# Resmi Gazete sayısına göre ara
resmi-gazete-cli search -s 33434

# Çıktıyı Markdown formatında al
resmi-gazete-cli search -k "yapay zeka" --format md

# Çıktıyı JSON formatında al
resmi-gazete-cli search -k "kvkk" --format json -l 20

2. Model Context Protocol (MCP) Sunucusu

Proje, LLM ajanlarının (Claude Desktop, Cursor, Windsurf, Cline vb.) Resmi Gazete verilerine canlı erişebilmesi için FastMCP stdio sunucusu içerir.

Sunulan MCP Araçları (Tools)

Araç Adı Açıklama Temel Parametreler
get_todays_gazette Güncel Resmi Gazete özetini, bölüm başlıklarını ve madde linklerini listeler. Parametresiz
get_gazette_by_date Belirli bir tarihteki Resmi Gazete sayısını listeler. tarih (GG.AA.YYYY veya YYYY-MM-DD), mukerrer (opsiyonel)
search_gazette Arşivde anahtar kelime, tarih aralığı, sayı ve mevzuat türüyle parametrik arama yapar. kelime, baslangic_tarihi, bitis_tarihi, sayi, mevzuat_turu, page
get_document_content Karar veya yönetmeliğin metin içeriğini indirip temizler. url (dokümanın web bağlantısı)

Claude Desktop Entegrasyonu

Claude Desktop yapılandırma dosyanıza aşağıdaki bloğu ekleyin:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "resmi-gazete": {
      "command": "resmi-gazete-mcp"
    }
  }
}

Sanal ortam ile çalıştırmak isterseniz mutlak python yolunu belirtin:

{
  "mcpServers": {
    "resmi-gazete": {
      "command": "/Users/KULLANICI_ADI/PycharmProjects/resmi-gazete-cli/.venv/bin/python",
      "args": ["-m", "resmi_gazete_cli.mcp.server"]
    }
  }
}

Cursor Entegrasyonu

  1. Cursor ayarlarını açın: Settings > Features > MCP.
  2. Add New MCP Server butonuna tıklayın.
  3. Bilgileri girin:
    • Name: resmi-gazete
    • Type: command
    • Command: resmi-gazete-mcp (veya sanal ortam yolu: /path/to/.venv/bin/resmi-gazete-mcp)
  4. Sunucuyu kaydedip yeşil durum ışığını doğrulayın. Cursor Agent veya Composer içinde "Günün Resmi Gazete kararlarını getir" veya "Vergi Usul Kanunu tebliğlerini ara" komutlarını verebilirsiniz.

VS Code (Cline / Roo Code) Entegrasyonu

cline_mcp_settings.json içerisine ekleyin:

{
  "mcpServers": {
    "resmi-gazete": {
      "command": "resmi-gazete-mcp",
      "disabled": false,
      "autoApprove": [
        "get_todays_gazette",
        "get_gazette_by_date",
        "search_gazette",
        "get_document_content"
      ]
    }
  }
}

3. Python Kütüphanesi Olarak Kullanım

ResmiGazeteClient sınıfını doğrudan asenkron Python projelerinizde kullanabilirsiniz:

import asyncio
from resmi_gazete_cli import ResmiGazeteClient


async def main():
    async with ResmiGazeteClient() as client:
        gazette = await client.get_todays_gazette()
        print(f"Tarih: {gazette.date}, Sayı: {gazette.number}")

        for category in gazette.categories:
            print(f"\n## {category.main_category}")
            for item in category.items:
                print(f"  - {item.title} -> {item.url}")


if __name__ == "__main__":
    asyncio.run(main())

Proje Dizini Yapısı

resmi-gazete-cli/
├── pyproject.toml                     # Hatchling derleme ve bağımlılık manifestosu
├── Makefile                           # Test, lint ve derleme otomasyon görevleri
├── README.md                          # Temel dokümantasyon ve vitrin
├── CONTRIBUTING.md                    # Geliştirici katkı kuralları
├── SECURITY.md                        # Güvenlik politikası ve bildirim SLA'sı
├── ROADMAP.md                         # Sürüm kilometre taşları
├── LICENSE                            # Apache-2.0 lisans metni
├── .editorconfig                      # Evrensel editör biçimlendirme kuralları
├── .gitattributes                     # Satır sonu (LF) ve ikili dosya kuralları
├── .markdownlint.json                 # Markdown linter yapılandırması
├── .flake8                            # Python linter kuralları
├── release-please-config.json         # Otomatik sürümleme yapılandırması
├── .release-please-manifest.json      # Sürüm takip manifestosu
├── Formula/                           # Homebrew tap formülü
│   └── resmi-gazete-cli.rb            # Homebrew kurulum reçetesi
├── docs/                              # Detaylı teknik kılavuzlar
│   ├── index.md                       # Dokümantasyon indeksi ve sistem mimarisi
│   ├── cli.md                         # CLI komut referansı (daily, search)
│   ├── mcp.md                         # Model Context Protocol ve LLM entegrasyonu
│   ├── sdk.md                         # Python SDK referansı ve modeller
│   └── assets/
│       └── logo.svg                   # Vektörel kurumsal logo
├── .github/
│   ├── CODEOWNERS                     # PR otomatik denetçi atamaları
│   ├── dependabot.yml                 # Bağımlılık güncelleme planlayıcısı
│   ├── ISSUE_TEMPLATE/                # Hata ve özellik talep şablonları
│   ├── PULL_REQUEST_TEMPLATE/         # PR kontrol listesi şablonu
│   └── workflows/
│       ├── ci.yml                     # Otomatik test ve derleme iş akışı
│       └── release-please.yml         # Sürüm ve etiket otomasyonu
├── resmi_gazete_cli/
│   ├── __init__.py                    # Paket dışa aktarımları ve sürüm sabiti
│   ├── scraper/
│   │   ├── __init__.py
│   │   ├── client.py                  # HTTP istemcisi ve hata yönetimi
│   │   ├── models.py                  # Pydantic veri modelleri
│   │   ├── parser.py                  # HTML gazete ayrıştırıcısı
│   │   └── security.py                # SSRF ve URL doğrulama güvenlik kontrolleri
│   ├── cli/
│   │   ├── __init__.py
│   │   └── main.py                    # Click terminal komutları
│   └── mcp/
│       ├── __init__.py
│       └── server.py                  # FastMCP stdio sunucusu
└── tests/
    ├── __init__.py
    ├── test_cli.py                    # CLI komut testleri
    ├── test_client.py                 # İstemci ve HTTP mock testleri
    ├── test_mcp.py                    # FastMCP araç testleri
    ├── test_models.py                 # Pydantic model doğrulama testleri
    ├── test_parser.py                 # HTML parser ve normalizasyon testleri
    └── test_security.py               # SSRF, DoS ve enjeksiyon güvenlik testleri

Geliştirme ve Test

Geliştirici ortamında testleri ve kod stili kontrollerini çalıştırmak için:

# Linter kontrolü
flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics

# Testleri çalıştırın
pytest

Sıkça Sorulan Sorular (SSS)

Resmi Gazete sunucusu istekleri engelliyor mu?

Hedef sistem resmigazete.gov.tr, belirli bir frekansın üzerindeki isteklerde veya geçersiz User-Agent başlıklarında bağlantıyı reddedebilir. ResmiGazeteClient varsayılan olarak gerçekçi tarayıcı başlıkları kullanır ve yeniden deneme/zaman aşımı yönetimini destekler.

Bu araç resmi bir kamu projesi midir?

Hayır. Bu araç bağımsız bir açık kaynak projesidir ve T.C. Cumhurbaşkanlığı İdari İşler Başkanlığı ya da Resmi Gazete kurumu ile doğrudan resmi bir bağı bulunmamaktadır.

Karar ve ilan metinleri çevrimdışı önbelleğe alınıyor mu?

Varsayılan istemci canlı HTTP sorguları yapar. Ağ trafiğini optimize etmek veya toplu analiz gerçekleştirmek isteyen kullanıcılar dönen GazetteItem modellerini yerel SQLite ya da dosya sistemine kaydedebilir.


Lisans

Bu proje Apache-2.0 lisansı ile dağıtılmaktadır.

Metadata

Release files for resmi-gazete-cli 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for resmi-gazete-cli 0.1.3
File Size Uploaded Provenance Actions
resmi_gazete_cli-0.1.3.tar.gz 71.2 kB With provenance Details for resmi_gazete_cli-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for resmi-gazete-cli 0.1.3
File Interpreter ABI Platform Actions
resmi_gazete_cli-0.1.3-py3-none-any.whl Python 3 none any Details for resmi_gazete_cli-0.1.3-py3-none-any.whl

Total release size: 98.1 kB

Release files / resmi_gazete_cli-0.1.3.tar.gz

Download URL resmi_gazete_cli-0.1.3.tar.gz
Size 71.2 kB
Tags Source
SHA-256 checksum
How to use checksums
6a5d7f45e613c735e2ad516d86c40d84659eed506b68c080546cd09d4c0b858a
BLAKE2b-256 checksum
How to use checksums
4a01afaf48cb6b677d6c6aef7f9d1e6fffae7bf08d2819846b3563bab9c4b747
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / resmi_gazete_cli-0.1.3-py3-none-any.whl

Download URL resmi_gazete_cli-0.1.3-py3-none-any.whl
Size 27.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8ee725b9660b8b99ea2bbcca277871f8d02235742f0248736de0ecdaf7f159ba
BLAKE2b-256 checksum
How to use checksums
5c199d102a828b0926839ef68acaa458167be7541e419350b196588ccaf4b6ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for resmi-gazete-cli 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for resmi_gazete_cli-0.1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page