yargitay-karar-scraper 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. yargitay_karar_scraper-0.1.0/.github/workflows/ci.yml +41 -0
  2. yargitay_karar_scraper-0.1.0/.github/workflows/publish.yml +39 -0
  3. yargitay_karar_scraper-0.1.0/.gitignore +1 -0
  4. yargitay_karar_scraper-0.1.0/LICENSE +21 -0
  5. yargitay_karar_scraper-0.1.0/PKG-INFO +176 -0
  6. yargitay_karar_scraper-0.1.0/README.md +161 -0
  7. yargitay_karar_scraper-0.1.0/docs/cli_usage.md +52 -0
  8. yargitay_karar_scraper-0.1.0/docs/mcp_usage.md +51 -0
  9. yargitay_karar_scraper-0.1.0/examples/basic_search.py +44 -0
  10. yargitay_karar_scraper-0.1.0/examples/detailed_search.py +44 -0
  11. yargitay_karar_scraper-0.1.0/examples/get_document.py +28 -0
  12. yargitay_karar_scraper-0.1.0/images/cli_detailed_search_example.png +0 -0
  13. yargitay_karar_scraper-0.1.0/images/cli_karar_detail_example.png +0 -0
  14. yargitay_karar_scraper-0.1.0/images/cli_search_example.png +0 -0
  15. yargitay_karar_scraper-0.1.0/images/logo.png +0 -0
  16. yargitay_karar_scraper-0.1.0/pyproject.toml +25 -0
  17. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/__init__.py +2 -0
  18. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/cli/__init__.py +3 -0
  19. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/cli/main.py +164 -0
  20. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/mcp/__init__.py +3 -0
  21. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/mcp/server.py +93 -0
  22. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/scraper/__init__.py +11 -0
  23. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/scraper/client.py +160 -0
  24. yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/scraper/models.py +48 -0
@@ -0,0 +1,41 @@
1
+ name: CI
2
+
3
+ on:
4
+ push:
5
+ branches: [ "main" ]
6
+ pull_request:
7
+ branches: [ "main" ]
8
+
9
+ jobs:
10
+ build:
11
+ runs-on: ubuntu-latest
12
+ strategy:
13
+ matrix:
14
+ python-version: ["3.10", "3.11", "3.12"]
15
+
16
+ steps:
17
+ - uses: actions/checkout@v4
18
+
19
+ - name: Set up Python ${{ matrix.python-version }}
20
+ uses: actions/setup-python@v5
21
+ with:
22
+ python-version: ${{ matrix.python-version }}
23
+ cache: 'pip'
24
+
25
+ - name: Install dependencies
26
+ run: |
27
+ python -m pip install --upgrade pip
28
+ pip install -e .
29
+ pip install flake8
30
+
31
+ - name: Lint with flake8
32
+ run: |
33
+ # E9,F63,F7,F82 hataları syntax veya tanımsız isim hatalarıdır
34
+ flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
35
+ # exit-zero ile flake8 uyarılarının build'i kırmasını engelliyoruz
36
+ flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
37
+
38
+ - name: Check package build
39
+ run: |
40
+ pip install build
41
+ python -m build
@@ -0,0 +1,39 @@
1
+ name: Publish to PyPI
2
+
3
+ on:
4
+ release:
5
+ types: [published]
6
+
7
+ jobs:
8
+ pypi-publish:
9
+ name: Build and publish Python package
10
+ runs-on: ubuntu-latest
11
+ permissions:
12
+ id-token: write # PyPI Trusted Publishing için gerekli
13
+ contents: read
14
+
15
+ steps:
16
+ - uses: actions/checkout@v4
17
+
18
+ - name: Set up Python
19
+ uses: actions/setup-python@v5
20
+ with:
21
+ python-version: "3.10"
22
+
23
+ - name: Install pypa/build
24
+ run: >-
25
+ python -m
26
+ pip install
27
+ build
28
+ --user
29
+
30
+ - name: Build a binary wheel and a source tarball
31
+ run: >-
32
+ python -m
33
+ build
34
+ --sdist
35
+ --wheel
36
+ --outdir dist/
37
+
38
+ - name: Publish package to PyPI
39
+ uses: pypa/gh-action-pypi-publish@release/v1
@@ -0,0 +1 @@
1
+ .idea/*
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ata Can Yaymacı
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,176 @@
1
+ Metadata-Version: 2.4
2
+ Name: yargitay-karar-scraper
3
+ Version: 0.1.0
4
+ Summary: Yargıtay Karar Arama Scraper, CLI ve MCP Sunucusu
5
+ Author: Ata Can Yaymacı
6
+ License: MIT
7
+ License-File: LICENSE
8
+ Requires-Python: >=3.10
9
+ Requires-Dist: click>=8.1.7
10
+ Requires-Dist: httpx>=0.25.0
11
+ Requires-Dist: mcp[cli]>=0.5.0
12
+ Requires-Dist: pydantic>=2.5.3
13
+ Requires-Dist: rich>=13.7.0
14
+ Description-Content-Type: text/markdown
15
+
16
+ <p align="center">
17
+ <img src="images/logo.png" alt="Yargıtay Karar Arama Scraper Logo" width="250">
18
+ </p>
19
+
20
+ <h1 align="center">Yargıtay Karar Arama Scraper & MCP Sunucusu</h1>
21
+
22
+ <p align="center">
23
+ <a href="https://pypi.org/project/yargitay-karar-scraper/">
24
+ <img src="https://img.shields.io/badge/pypi-v0.1.0-blue.svg" alt="PyPI Version">
25
+ </a>
26
+ <a href="https://pypi.org/project/yargitay-karar-scraper/">
27
+ <img src="https://img.shields.io/badge/python-3.10%2B-green.svg" alt="Python Versions">
28
+ </a>
29
+ <a href="https://github.com/atacanyaymaci/yargitay-karar-scraper/actions">
30
+ <img src="https://img.shields.io/badge/build-passing-brightgreen.svg" alt="Build Status">
31
+ </a>
32
+ <a href="LICENSE">
33
+ <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
34
+ </a>
35
+ </p>
36
+
37
+ <p align="center">
38
+ <b>Yargıtay Karar Arama</b> sitesinden veri çeken, bunu bir komut satırı arayüzü (CLI) üzerinden renkli tablolarla sunan ve bir MCP (Model Context Protocol) sunucusu olarak Claude gibi Büyük Dil Modelleri (LLM) ile etkileşime açan modern ve modüler bir Python paketidir.
39
+ </p>
40
+
41
+ ---
42
+
43
+ ## ✨ Özellikler
44
+
45
+ - **Modüler Scraper:** `httpx` ve `pydantic` kullanılarak yazılmış temiz, nesne yönelimli ve tip güvenli asenkron (async) scraper çekirdeği.
46
+ - **Güçlü CLI:** `click` ve `rich` tabanlı, kullanıcı dostu ve interaktif görünüme sahip komut satırı arayüzü.
47
+ - **MCP Sunucusu:** LLM'lerin (Claude, Cursor vb.) otomatik olarak Yargıtay'da araştırma yapabilmesi için standart `mcp` arayüzü sağlayan sunucu.
48
+ - **Gelişmiş Arama:** Daire, esas yılı, karar yılı ve sıralama yönü gibi detaylı kriterlerle arama yapabilme yeteneği.
49
+ - **Karar Temizleme:** HTML etiketleriyle dolu kararları otomatik olarak temizleyip saf ve okunaklı metin haline dönüştürme.
50
+
51
+ ---
52
+
53
+ ## 📸 Ekran Görüntüleri (CLI)
54
+
55
+ <details open>
56
+ <summary><b>Terminal Arayüzü Ekran Görüntüleri (Görmek için tıklayın)</b></summary>
57
+ <br>
58
+
59
+ <table>
60
+ <tr>
61
+ <td align="center">
62
+ <b>Basit Arama</b><br>
63
+ <img src="images/cli_search_example.png" alt="Basit Arama CLI">
64
+ </td>
65
+ <td align="center">
66
+ <b>Detaylı Arama</b><br>
67
+ <img src="images/cli_detailed_search_example.png" alt="Detaylı Arama CLI">
68
+ </td>
69
+ </tr>
70
+ <tr>
71
+ <td colspan="2" align="center">
72
+ <b>Karar Detayı Okuma</b><br>
73
+ <img src="images/cli_karar_detail_example.png" alt="Karar Detayı Okuma CLI">
74
+ </td>
75
+ </tr>
76
+ </table>
77
+ </details>
78
+
79
+ ---
80
+
81
+ ## 🚀 Kurulum
82
+
83
+ PyPI üzerinden kararlı sürümü kurmak için (yakında):
84
+
85
+ ```bash
86
+ pip install yargitay-karar-scraper
87
+ ```
88
+
89
+ Kaynak koddan kurmak ve geliştirmek için:
90
+
91
+ ```bash
92
+ git clone https://github.com/atacanyaymaci/yargitay-karar-scraper.git
93
+ cd yargitay-karar-scraper
94
+ pip install -e .
95
+ ```
96
+
97
+ ---
98
+
99
+ ## 💻 Kullanım
100
+
101
+ ### 1. Komut Satırı Arayüzü (CLI)
102
+
103
+ CLI aracını `yargitay-karar-cli` komutu ile terminalden doğrudan kullanabilirsiniz.
104
+
105
+ **Basit Arama:**
106
+ ```bash
107
+ yargitay-karar-cli search --kelime "hırsızlık" --page-size 10
108
+ ```
109
+
110
+ **Gelişmiş / Detaylı Arama:**
111
+ ```bash
112
+ yargitay-karar-cli detailed-search --kelime "hırsızlık" --daire "1. Ceza Dairesi" --karar-yil "2018"
113
+ ```
114
+
115
+ **Bir Kararın Tam Metnini Çekmek:**
116
+ ```bash
117
+ yargitay-karar-cli detail --id "120109100"
118
+ ```
119
+
120
+ *Daha fazla detay için `docs/cli_usage.md` dosyasına göz atabilirsiniz.*
121
+
122
+ ### 2. MCP Sunucusu Olarak Kullanım
123
+
124
+ Aşağıdaki komut MCP sunucusunu (stdio üzerinden) ayağa kaldırır ve LLM'lerin `search_cases` ile `get_case_detail` araçlarını kullanabilmesini sağlar:
125
+
126
+ ```bash
127
+ yargitay-karar-mcp
128
+ ```
129
+
130
+ Bunu **Claude Desktop** uygulamanızın `claude_desktop_config.json` dosyasına şu şekilde ekleyebilirsiniz:
131
+
132
+ ```json
133
+ {
134
+ "mcpServers": {
135
+ "yargitay_kararlar": {
136
+ "command": "yargitay-karar-mcp",
137
+ "args": []
138
+ }
139
+ }
140
+ }
141
+ ```
142
+
143
+ Kurulumu yaptıktan sonra Claude'a doğrudan şu şekilde promptlar verebilirsiniz:
144
+ > *"Bana Yargıtay 1. Ceza Dairesinin 2018 yılında vermiş olduğu 'kasten adam öldürme' ile ilgili kararları bulur musun?"*
145
+
146
+ *Daha fazla detay ve kullanım senaryosu için `docs/mcp_usage.md` dosyasına göz atabilirsiniz.*
147
+
148
+ ### 3. Python Kütüphanesi Olarak Kullanım
149
+
150
+ Eğer kendi Python projenizde doğrudan kod üzerinden kullanmak isterseniz, paketimizin asenkron (async) `YargitayClient` sınıfını kolayca projenize dahil edebilirsiniz:
151
+
152
+ ```python
153
+ import asyncio
154
+ from yargitay_karar_scraper.scraper import YargitayClient, SearchCriteria
155
+
156
+ async def main():
157
+ client = YargitayClient()
158
+ criteria = SearchCriteria(kelime="dolandırıcılık", page_size=5)
159
+
160
+ response = await client.search(criteria)
161
+
162
+ if not response.error:
163
+ for case in response.results:
164
+ print(f"Karar ID: {case.id} | Esas/Karar: {case.esas_no} / {case.karar_no}")
165
+
166
+ if __name__ == "__main__":
167
+ asyncio.run(main())
168
+ ```
169
+
170
+ *Kendi projenize entegre etmeden önce daha fazla detaylı kod örneği incelemek için projedeki `examples/` klasörüne göz atabilirsiniz.*
171
+
172
+ ---
173
+
174
+ ## 📄 Lisans
175
+
176
+ Bu proje [MIT Lisansı](LICENSE) altında lisanslanmıştır. Dilediğiniz gibi kullanabilir, değiştirebilir ve dağıtabilirsiniz.
@@ -0,0 +1,161 @@
1
+ <p align="center">
2
+ <img src="images/logo.png" alt="Yargıtay Karar Arama Scraper Logo" width="250">
3
+ </p>
4
+
5
+ <h1 align="center">Yargıtay Karar Arama Scraper & MCP Sunucusu</h1>
6
+
7
+ <p align="center">
8
+ <a href="https://pypi.org/project/yargitay-karar-scraper/">
9
+ <img src="https://img.shields.io/badge/pypi-v0.1.0-blue.svg" alt="PyPI Version">
10
+ </a>
11
+ <a href="https://pypi.org/project/yargitay-karar-scraper/">
12
+ <img src="https://img.shields.io/badge/python-3.10%2B-green.svg" alt="Python Versions">
13
+ </a>
14
+ <a href="https://github.com/atacanyaymaci/yargitay-karar-scraper/actions">
15
+ <img src="https://img.shields.io/badge/build-passing-brightgreen.svg" alt="Build Status">
16
+ </a>
17
+ <a href="LICENSE">
18
+ <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
19
+ </a>
20
+ </p>
21
+
22
+ <p align="center">
23
+ <b>Yargıtay Karar Arama</b> sitesinden veri çeken, bunu bir komut satırı arayüzü (CLI) üzerinden renkli tablolarla sunan ve bir MCP (Model Context Protocol) sunucusu olarak Claude gibi Büyük Dil Modelleri (LLM) ile etkileşime açan modern ve modüler bir Python paketidir.
24
+ </p>
25
+
26
+ ---
27
+
28
+ ## ✨ Özellikler
29
+
30
+ - **Modüler Scraper:** `httpx` ve `pydantic` kullanılarak yazılmış temiz, nesne yönelimli ve tip güvenli asenkron (async) scraper çekirdeği.
31
+ - **Güçlü CLI:** `click` ve `rich` tabanlı, kullanıcı dostu ve interaktif görünüme sahip komut satırı arayüzü.
32
+ - **MCP Sunucusu:** LLM'lerin (Claude, Cursor vb.) otomatik olarak Yargıtay'da araştırma yapabilmesi için standart `mcp` arayüzü sağlayan sunucu.
33
+ - **Gelişmiş Arama:** Daire, esas yılı, karar yılı ve sıralama yönü gibi detaylı kriterlerle arama yapabilme yeteneği.
34
+ - **Karar Temizleme:** HTML etiketleriyle dolu kararları otomatik olarak temizleyip saf ve okunaklı metin haline dönüştürme.
35
+
36
+ ---
37
+
38
+ ## 📸 Ekran Görüntüleri (CLI)
39
+
40
+ <details open>
41
+ <summary><b>Terminal Arayüzü Ekran Görüntüleri (Görmek için tıklayın)</b></summary>
42
+ <br>
43
+
44
+ <table>
45
+ <tr>
46
+ <td align="center">
47
+ <b>Basit Arama</b><br>
48
+ <img src="images/cli_search_example.png" alt="Basit Arama CLI">
49
+ </td>
50
+ <td align="center">
51
+ <b>Detaylı Arama</b><br>
52
+ <img src="images/cli_detailed_search_example.png" alt="Detaylı Arama CLI">
53
+ </td>
54
+ </tr>
55
+ <tr>
56
+ <td colspan="2" align="center">
57
+ <b>Karar Detayı Okuma</b><br>
58
+ <img src="images/cli_karar_detail_example.png" alt="Karar Detayı Okuma CLI">
59
+ </td>
60
+ </tr>
61
+ </table>
62
+ </details>
63
+
64
+ ---
65
+
66
+ ## 🚀 Kurulum
67
+
68
+ PyPI üzerinden kararlı sürümü kurmak için (yakında):
69
+
70
+ ```bash
71
+ pip install yargitay-karar-scraper
72
+ ```
73
+
74
+ Kaynak koddan kurmak ve geliştirmek için:
75
+
76
+ ```bash
77
+ git clone https://github.com/atacanyaymaci/yargitay-karar-scraper.git
78
+ cd yargitay-karar-scraper
79
+ pip install -e .
80
+ ```
81
+
82
+ ---
83
+
84
+ ## 💻 Kullanım
85
+
86
+ ### 1. Komut Satırı Arayüzü (CLI)
87
+
88
+ CLI aracını `yargitay-karar-cli` komutu ile terminalden doğrudan kullanabilirsiniz.
89
+
90
+ **Basit Arama:**
91
+ ```bash
92
+ yargitay-karar-cli search --kelime "hırsızlık" --page-size 10
93
+ ```
94
+
95
+ **Gelişmiş / Detaylı Arama:**
96
+ ```bash
97
+ yargitay-karar-cli detailed-search --kelime "hırsızlık" --daire "1. Ceza Dairesi" --karar-yil "2018"
98
+ ```
99
+
100
+ **Bir Kararın Tam Metnini Çekmek:**
101
+ ```bash
102
+ yargitay-karar-cli detail --id "120109100"
103
+ ```
104
+
105
+ *Daha fazla detay için `docs/cli_usage.md` dosyasına göz atabilirsiniz.*
106
+
107
+ ### 2. MCP Sunucusu Olarak Kullanım
108
+
109
+ Aşağıdaki komut MCP sunucusunu (stdio üzerinden) ayağa kaldırır ve LLM'lerin `search_cases` ile `get_case_detail` araçlarını kullanabilmesini sağlar:
110
+
111
+ ```bash
112
+ yargitay-karar-mcp
113
+ ```
114
+
115
+ Bunu **Claude Desktop** uygulamanızın `claude_desktop_config.json` dosyasına şu şekilde ekleyebilirsiniz:
116
+
117
+ ```json
118
+ {
119
+ "mcpServers": {
120
+ "yargitay_kararlar": {
121
+ "command": "yargitay-karar-mcp",
122
+ "args": []
123
+ }
124
+ }
125
+ }
126
+ ```
127
+
128
+ Kurulumu yaptıktan sonra Claude'a doğrudan şu şekilde promptlar verebilirsiniz:
129
+ > *"Bana Yargıtay 1. Ceza Dairesinin 2018 yılında vermiş olduğu 'kasten adam öldürme' ile ilgili kararları bulur musun?"*
130
+
131
+ *Daha fazla detay ve kullanım senaryosu için `docs/mcp_usage.md` dosyasına göz atabilirsiniz.*
132
+
133
+ ### 3. Python Kütüphanesi Olarak Kullanım
134
+
135
+ Eğer kendi Python projenizde doğrudan kod üzerinden kullanmak isterseniz, paketimizin asenkron (async) `YargitayClient` sınıfını kolayca projenize dahil edebilirsiniz:
136
+
137
+ ```python
138
+ import asyncio
139
+ from yargitay_karar_scraper.scraper import YargitayClient, SearchCriteria
140
+
141
+ async def main():
142
+ client = YargitayClient()
143
+ criteria = SearchCriteria(kelime="dolandırıcılık", page_size=5)
144
+
145
+ response = await client.search(criteria)
146
+
147
+ if not response.error:
148
+ for case in response.results:
149
+ print(f"Karar ID: {case.id} | Esas/Karar: {case.esas_no} / {case.karar_no}")
150
+
151
+ if __name__ == "__main__":
152
+ asyncio.run(main())
153
+ ```
154
+
155
+ *Kendi projenize entegre etmeden önce daha fazla detaylı kod örneği incelemek için projedeki `examples/` klasörüne göz atabilirsiniz.*
156
+
157
+ ---
158
+
159
+ ## 📄 Lisans
160
+
161
+ Bu proje [MIT Lisansı](LICENSE) altında lisanslanmıştır. Dilediğiniz gibi kullanabilir, değiştirebilir ve dağıtabilirsiniz.
@@ -0,0 +1,52 @@
1
+ # Yargıtay Karar Arama CLI Kullanım Örnekleri
2
+
3
+ Bu dokümanda `yargitay-karar-cli` komut satırı aracının nasıl kullanılacağına dair örnekler yer almaktadır.
4
+
5
+ Proje bağımlılıklarını kurduktan sonra (`pip install -e .` çalıştırarak) terminalinizde doğrudan `yargitay-karar-cli` komutunu kullanabilirsiniz.
6
+
7
+ ## 1. Basit Arama (`search`)
8
+
9
+ Bu komut, bir kelime öbeği üzerinden arama yapmanızı ve sayfalandırma seçeneklerini kontrol etmenizi sağlar.
10
+
11
+ **Örnek:** Sadece "hırsızlık" kelimesi geçen kararları aramak:
12
+ ```bash
13
+ yargitay-karar-cli search --kelime "hırsızlık"
14
+ ```
15
+
16
+ **Örnek:** Sayfa başı 5 kayıt getirecek şekilde, 2. sayfadaki kararları aramak:
17
+ ```bash
18
+ yargitay-karar-cli search --kelime "dolandırıcılık" --page-size 5 --page-number 2
19
+ ```
20
+
21
+ ## 2. Detaylı Arama (`detailed-search`)
22
+
23
+ Bu komut, dairesi, karar yılı, sıralama şekli gibi tüm gelişmiş Yargıtay kriterlerini kullanarak arama yapmanıza olanak tanır.
24
+
25
+ **Örnek:** "1. Ceza Dairesi"nin 2018 yılındaki kararlarından "hırsızlık" kelimesi geçenleri aramak:
26
+ ```bash
27
+ yargitay-karar-cli detailed-search --kelime "hırsızlık" --daire "1. Ceza Dairesi" --karar-yil "2018"
28
+ ```
29
+
30
+ ## 3. Karar Detayı Okuma (`detail`)
31
+
32
+ Arama sonuçlarında (veya başka bir yerden) elde ettiğiniz Yargıtay Karar ID'si ile kararın saf metnini (HTML etiketlerinden arındırılmış haliyle) okuyabilirsiniz.
33
+
34
+ **Örnek:** ID'si `120109100` olan kararın metnini getirmek:
35
+ ```bash
36
+ yargitay-karar-cli detail --id "120109100"
37
+ ```
38
+
39
+ ## Yardım (Help) Dokümantasyonu
40
+
41
+ Kullanabileceğiniz tüm alt komutları ve argümanları görmek için `--help` bayrağını ekleyin:
42
+
43
+ ```bash
44
+ # Ana menü yardımı
45
+ yargitay-karar-cli --help
46
+
47
+ # Arama komutu yardımı
48
+ yargitay-karar-cli search --help
49
+
50
+ # Detay komutu yardımı
51
+ yargitay-karar-cli detail --help
52
+ ```
@@ -0,0 +1,51 @@
1
+ # Yargıtay Karar Arama MCP Sunucusu Kullanımı
2
+
3
+ Model Context Protocol (MCP), Claude ve benzeri Yapay Zeka (LLM) asistanlarının dış sistemlere entegre olmasını sağlayan açık bir standarttır. Bu paket sayesinde LLM'nize doğrudan Yargıtay kararlarında arama yapma ve okuma yeteneği kazandırabilirsiniz.
4
+
5
+ ## 1. MCP Sunucusunu Başlatmak
6
+
7
+ Komut satırından standart girdi/çıktı (stdio) üzerinden MCP sunucusunu ayağa kaldırmak çok basittir:
8
+
9
+ ```bash
10
+ yargitay-karar-mcp
11
+ ```
12
+ *(Bu komut arka planda çalışıp standart JSON-RPC protokolü üzerinden dinlemeye başlar. İnsanların doğrudan okuması için değil, LLM istemcileri için tasarlanmıştır.)*
13
+
14
+ ## 2. Claude Desktop ile Entegrasyon
15
+
16
+ Claude Desktop uygulamasına bu aracı öğretmek için konfigürasyon dosyanıza eklemeniz gereklidir.
17
+
18
+ **MacOS için yapılandırma dosyası yolu:**
19
+ `~/Library/Application Support/Claude/claude_desktop_config.json`
20
+
21
+ **Windows için yapılandırma dosyası yolu:**
22
+ `%APPDATA%\Claude\claude_desktop_config.json`
23
+
24
+ Konfigürasyon dosyasına şu bloğu ekleyin (eğer dosya yoksa yeni bir JSON olarak oluşturun):
25
+
26
+ ```json
27
+ {
28
+ "mcpServers": {
29
+ "yargitay_kararlar": {
30
+ "command": "yargitay-karar-mcp",
31
+ "args": []
32
+ }
33
+ }
34
+ }
35
+ ```
36
+
37
+ *Not: Eğer `yargitay-karar-mcp` komutu ortam değişkenlerinizde (PATH) bulunamıyorsa, "command" kısmına python sanal ortamınızdaki (venv) tam yolunu yazabilirsiniz.*
38
+
39
+ Claude Desktop uygulamasını yeniden başlattığınızda sistem bu araçları (Tools) otomatik tanıyacaktır.
40
+
41
+ ## 3. Claude ile Örnek Etkileşimler (Promptlar)
42
+
43
+ Kurulum tamamlandıktan sonra Claude ile sohbet ederken aşağıdaki gibi komutlar verebilirsiniz. Claude otomatik olarak arka planda MCP sunucunuza bağlanacak, arama yapacak ve sonucu size özetleyecektir.
44
+
45
+ **Örnek Prompt 1 (Gelişmiş/Detaylı Arama):**
46
+ > "Bana Yargıtay 1. Ceza Dairesinin 2018 yılında vermiş olduğu 'kasten adam öldürme' ile ilgili kararları bulur musun?"
47
+ *(MCP sunucusuna entegre edilen `search_cases` aracı aslında arka planda **detailed_search** kullanır. Bu sayede Claude; daire, başlangıç/bitiş tarihleri, esas/karar yılları gibi spesifik filtreleri otomatik olarak kullanarak detaylı Yargıtay taraması yapar.)*
48
+
49
+ **Örnek Prompt 2 (Metin İncelemesi):**
50
+ > "Az önce bulduğun '415233000' ID'li kararın tam metnini oku ve bana bu kararda sanığın neden beraat ettiğini açıkla."
51
+ *(Claude otomatik olarak `get_case_detail` aracını çağırır ve HTML'den arındırılmış saf metni okuyarak analiz yapar)*
@@ -0,0 +1,44 @@
1
+ import asyncio
2
+
3
+ # Proje dizininde çalıştırılırken yargitay_karar_scraper modülünün bulunabilmesi için
4
+ # sys.path'e eklenebilir (pip install -e . yaptıysanız buna gerek yoktur)
5
+ # import sys; sys.path.insert(0, "..")
6
+
7
+ from yargitay_karar_scraper.scraper import YargitayClient, SearchCriteria
8
+
9
+
10
+ async def main():
11
+ print("Yargıtay Karar Arama (Basit Arama) Örneği\n")
12
+
13
+ # 1. İstemciyi oluştur
14
+ client = YargitayClient(timeout=30)
15
+
16
+ # 2. Arama kriterlerini belirle
17
+ # Sadece "hırsızlık" kelimesi geçen, 1. sayfadaki ilk 5 kararı getirelim
18
+ criteria = SearchCriteria(
19
+ kelime="hırsızlık",
20
+ page_size=5,
21
+ page_number=1
22
+ )
23
+
24
+ print(f"'{criteria.kelime}' kelimesi aranıyor...")
25
+
26
+ # 3. İsteği gönder ve yanıtı al
27
+ response = await client.search(criteria)
28
+
29
+ if response.error:
30
+ print(f"Hata: {response.error}")
31
+ return
32
+
33
+ print(f"\nToplam Bulunan Kayıt: {response.total_count}")
34
+ print("-" * 50)
35
+
36
+ for case in response.results:
37
+ print(f"ID: {case.id}")
38
+ print(f"Esas/Karar: {case.esas_no} / {case.karar_no}")
39
+ print(f"Tarih: {case.tarih}")
40
+ print("-" * 50)
41
+
42
+
43
+ if __name__ == "__main__":
44
+ asyncio.run(main())
@@ -0,0 +1,44 @@
1
+ import asyncio
2
+ from yargitay_karar_scraper.scraper import YargitayClient, DetailedSearchCriteria
3
+
4
+
5
+ async def main():
6
+ print("Yargıtay Karar Arama (Detaylı Arama) Örneği\n")
7
+
8
+ client = YargitayClient()
9
+
10
+ # Detaylı arama parametreleri
11
+ # Örnek: "1. Ceza Dairesi"nin, 2015 ile 2018 yılları arasındaki "hırsızlık" kelimesi geçen kararları
12
+ criteria = DetailedSearchCriteria(
13
+ kelime="hırsızlık",
14
+ daire="1. Ceza Dairesi",
15
+ baslangic_tarihi="",
16
+ bitis_tarihi="",
17
+ esas_yil="2015",
18
+ karar_yil="2018",
19
+ siralama="3", # Yargıtay'ın kullandığı özel sıralama parametresi
20
+ siralama_direction="desc", # Yeniden eskiye sırala
21
+ page_size=10,
22
+ page_number=1
23
+ )
24
+
25
+ print("Kriterler ile arama yapılıyor...")
26
+ response = await client.detailed_search(criteria)
27
+
28
+ if response.error:
29
+ print(f"Hata: {response.error}")
30
+ return
31
+
32
+ print(f"\nToplam {response.total_count} kayıt bulundu.")
33
+ print("=" * 60)
34
+
35
+ for case in response.results:
36
+ print(f"Karar ID: {case.id}")
37
+ print(f"Daire: {case.daire}")
38
+ print(f"Esas / Karar: {case.esas_no} / {case.karar_no}")
39
+ print(f"Tarih: {case.tarih}")
40
+ print("=" * 60)
41
+
42
+
43
+ if __name__ == "__main__":
44
+ asyncio.run(main())
@@ -0,0 +1,28 @@
1
+ import asyncio
2
+ from yargitay_karar_scraper.scraper import YargitayClient
3
+
4
+
5
+ async def main():
6
+ print("Yargıtay Karar Arama (Doküman Detayı Çekme) Örneği\n")
7
+
8
+ client = YargitayClient()
9
+
10
+ # Doküman ID'si (Arama sonuçlarından alınmış örnek bir ID)
11
+ # Burada sizin sağladığınız "120109100" ID'sini kullanıyoruz.
12
+ document_id = "120109100"
13
+
14
+ print(f"ID'si '{document_id}' olan karar çekiliyor...\n")
15
+
16
+ response = await client.get_document(document_id)
17
+
18
+ if response.error:
19
+ print(f"Hata: {response.error}")
20
+ return
21
+
22
+ print("--- KARAR İÇERİĞİ ---")
23
+ print(response.icerik)
24
+ print("\n--- SON ---")
25
+
26
+
27
+ if __name__ == "__main__":
28
+ asyncio.run(main())
@@ -0,0 +1,25 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "yargitay-karar-scraper"
7
+ version = "0.1.0"
8
+ description = "Yargıtay Karar Arama Scraper, CLI ve MCP Sunucusu"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = { text = "MIT" }
12
+ authors = [
13
+ { name = "Ata Can Yaymacı" }
14
+ ]
15
+ dependencies = [
16
+ "httpx>=0.25.0",
17
+ "click>=8.1.7",
18
+ "rich>=13.7.0",
19
+ "pydantic>=2.5.3",
20
+ "mcp[cli]>=0.5.0"
21
+ ]
22
+
23
+ [project.scripts]
24
+ yargitay-karar-cli = "yargitay_karar_scraper.cli.main:cli"
25
+ yargitay-karar-mcp = "yargitay_karar_scraper.mcp.server:main"
@@ -0,0 +1,2 @@
1
+ """Yargıtay Karar Arama Scraper & MCP Sunucusu"""
2
+ __version__ = "0.1.0"
@@ -0,0 +1,3 @@
1
+ from .main import cli
2
+
3
+ __all__ = ["cli"]
@@ -0,0 +1,164 @@
1
+ import click
2
+ import asyncio
3
+ from rich.console import Console
4
+ from rich.table import Table
5
+ from rich.panel import Panel
6
+
7
+ from yargitay_karar_scraper.scraper import YargitayClient, SearchCriteria
8
+
9
+ console = Console()
10
+
11
+
12
+ @click.group()
13
+ def cli():
14
+ """Yargıtay Karar Arama CLI aracı"""
15
+ pass
16
+
17
+
18
+ @cli.command()
19
+ @click.option('--kelime', required=True, help='Aranacak kelime veya kelime öbeği')
20
+ @click.option('--page-size', default=10, help='Sayfa başı kayıt sayısı')
21
+ @click.option('--page-number', default=1, help='Sayfa numarası')
22
+ def search(kelime, page_size, page_number):
23
+ """Belirtilen kelime ile basit arama yapar."""
24
+ criteria = SearchCriteria(
25
+ kelime=kelime,
26
+ page_size=page_size,
27
+ page_number=page_number
28
+ )
29
+
30
+ console.print(f"[bold blue]Arama yapılıyor...[/bold blue]")
31
+
32
+ async def run_search():
33
+ client = YargitayClient()
34
+ response = await client.search(criteria)
35
+
36
+ if response.error:
37
+ console.print(f"[bold red]Arama sırasında hata oluştu:[/bold red] {response.error}")
38
+ return
39
+
40
+ if not response.results:
41
+ console.print("[yellow]Sonuç bulunamadı.[/yellow]")
42
+ return
43
+
44
+ table = Table(title=f"Arama Sonuçları (Toplam: {response.total_count})")
45
+
46
+ table.add_column("ID", style="cyan", no_wrap=True)
47
+ table.add_column("Daire", style="magenta")
48
+ table.add_column("Esas / Karar", style="green")
49
+ table.add_column("Tarih", style="yellow")
50
+ table.add_column("Özet", style="white")
51
+
52
+ for case in response.results:
53
+ esas_karar = f"{case.esas_no} / {case.karar_no}"
54
+ ozet_kisa = case.ozet[:50] + "..." if case.ozet and len(case.ozet) > 50 else (case.ozet or "-")
55
+ table.add_row(
56
+ case.id,
57
+ case.daire or "-",
58
+ esas_karar,
59
+ case.tarih or "-",
60
+ ozet_kisa
61
+ )
62
+
63
+ console.print(table)
64
+ console.print(
65
+ "\nDetay görmek için [bold green]yargitay-karar-cli detail --id <ID>[/bold green] komutunu kullanabilirsiniz.")
66
+
67
+ asyncio.run(run_search())
68
+
69
+
70
+ @cli.command(name="detailed-search")
71
+ @click.option('--kelime', default="", help='Aranacak kelime')
72
+ @click.option('--daire', default="", help='İlgili daire')
73
+ @click.option('--baslangic-tarihi', default="", help='Başlangıç Tarihi (GG.AA.YYYY)')
74
+ @click.option('--bitis-tarihi', default="", help='Bitiş Tarihi (GG.AA.YYYY)')
75
+ @click.option('--esas-yil', default="", help='Esas Yıl')
76
+ @click.option('--karar-yil', default="", help='Karar Yıl')
77
+ @click.option('--siralama', default="3", help='Sıralama türü')
78
+ @click.option('--siralama-direction', default="asc", help='Sıralama yönü (asc/desc)')
79
+ @click.option('--page-size', default=10, help='Sayfa başı kayıt sayısı')
80
+ @click.option('--page-number', default=1, help='Sayfa numarası')
81
+ def detailed_search_cmd(kelime, daire, baslangic_tarihi, bitis_tarihi, esas_yil, karar_yil, siralama, siralama_direction, page_size, page_number):
82
+ """Gelişmiş kriterlerle detaylı arama yapar."""
83
+ from yargitay_karar_scraper.scraper import DetailedSearchCriteria
84
+
85
+ criteria = DetailedSearchCriteria(
86
+ kelime=kelime,
87
+ daire=daire,
88
+ baslangic_tarihi=baslangic_tarihi,
89
+ bitis_tarihi=bitis_tarihi,
90
+ esas_yil=esas_yil,
91
+ karar_yil=karar_yil,
92
+ siralama=siralama,
93
+ siralama_direction=siralama_direction,
94
+ page_size=page_size,
95
+ page_number=page_number
96
+ )
97
+
98
+ console.print(f"[bold blue]Detaylı arama yapılıyor...[/bold blue]")
99
+
100
+ async def run_detailed_search():
101
+ client = YargitayClient()
102
+ response = await client.detailed_search(criteria)
103
+
104
+ if response.error:
105
+ console.print(f"[bold red]Arama sırasında hata oluştu:[/bold red] {response.error}")
106
+ return
107
+
108
+ if not response.results:
109
+ console.print("[yellow]Sonuç bulunamadı.[/yellow]")
110
+ return
111
+
112
+ table = Table(title=f"Arama Sonuçları (Toplam: {response.total_count})")
113
+
114
+ table.add_column("ID", style="cyan", no_wrap=True)
115
+ table.add_column("Daire", style="magenta")
116
+ table.add_column("Esas / Karar", style="green")
117
+ table.add_column("Tarih", style="yellow")
118
+ table.add_column("Özet", style="white")
119
+
120
+ for case in response.results:
121
+ esas_karar = f"{case.esas_no} / {case.karar_no}"
122
+ ozet_kisa = case.ozet[:50] + "..." if case.ozet and len(case.ozet) > 50 else (case.ozet or "-")
123
+ table.add_row(
124
+ case.id,
125
+ case.daire or "-",
126
+ esas_karar,
127
+ case.tarih or "-",
128
+ ozet_kisa
129
+ )
130
+
131
+ console.print(table)
132
+ console.print(
133
+ "\nDetay görmek için [bold green]yargitay-karar-cli detail --id <ID>[/bold green] komutunu kullanabilirsiniz.")
134
+
135
+ asyncio.run(run_detailed_search())
136
+
137
+
138
+ @cli.command()
139
+ @click.option('--id', required=True, help='Karar doküman ID\'si')
140
+ def detail(id):
141
+ """Belirtilen ID'ye sahip kararın tam metnini getirir."""
142
+ console.print(f"[bold blue]Karar detayı getiriliyor ({id})...[/bold blue]")
143
+
144
+ async def run_detail():
145
+ client = YargitayClient()
146
+ response = await client.get_document(id)
147
+
148
+ if response.error:
149
+ console.print(f"[bold red]Hata:[/bold red] {response.error}")
150
+ return
151
+
152
+ panel = Panel(
153
+ response.icerik,
154
+ title=f"[bold]Karar Detayı - {id}[/bold]",
155
+ border_style="blue",
156
+ expand=False
157
+ )
158
+ console.print(panel)
159
+
160
+ asyncio.run(run_detail())
161
+
162
+
163
+ if __name__ == '__main__':
164
+ cli()
@@ -0,0 +1,3 @@
1
+ from .server import main
2
+
3
+ __all__ = ["main"]
@@ -0,0 +1,93 @@
1
+ from mcp.server.fastmcp import FastMCP
2
+ from pydantic import Field
3
+
4
+ from yargitay_karar_scraper.scraper import YargitayClient, DetailedSearchCriteria
5
+
6
+ # MCP Sunucusunu başlatıyoruz
7
+ mcp = FastMCP("Yargitay Karar Arama Sunucusu")
8
+
9
+
10
+ @mcp.tool()
11
+ async def search_cases(
12
+ kelime: str = Field("", description="Aranacak kelime veya kelime öbeği"),
13
+ daire: str = Field("", description="İlgili daire (Ör: 1, 2, Ceza, Hukuk vb.)"),
14
+ baslangic_tarihi: str = Field("", description="Başlangıç Tarihi (GG.AA.YYYY)"),
15
+ bitis_tarihi: str = Field("", description="Bitiş Tarihi (GG.AA.YYYY)"),
16
+ esas_yil: str = Field("", description="Esas Yıl"),
17
+ esas_ilk_sira_no: str = Field("", description="Esas İlk Sıra No"),
18
+ esas_son_sira_no: str = Field("", description="Esas Son Sıra No"),
19
+ karar_yil: str = Field("", description="Karar Yıl"),
20
+ karar_ilk_sira_no: str = Field("", description="Karar İlk Sıra No"),
21
+ karar_son_sira_no: str = Field("", description="Karar Son Sıra No"),
22
+ siralama: str = Field("3", description="Sıralama türü"),
23
+ siralama_direction: str = Field("asc", description="Sıralama yönü (asc/desc)"),
24
+ page_size: int = Field(10, description="Sayfa başı kayıt sayısı"),
25
+ page_number: int = Field(1, description="Sayfa numarası")
26
+ ) -> str:
27
+ """
28
+ Yargıtay kararlarında detaylı arama yapar ve sonuç listesini döndürür.
29
+ Bu listeye dayanarak spesifik kararların detayını okumak isterseniz 'get_case_detail' aracını çağırın.
30
+ """
31
+ criteria = DetailedSearchCriteria(
32
+ kelime=kelime,
33
+ daire=daire,
34
+ baslangic_tarihi=baslangic_tarihi,
35
+ bitis_tarihi=bitis_tarihi,
36
+ esas_yil=esas_yil,
37
+ esas_ilk_sira_no=esas_ilk_sira_no,
38
+ esas_son_sira_no=esas_son_sira_no,
39
+ karar_yil=karar_yil,
40
+ karar_ilk_sira_no=karar_ilk_sira_no,
41
+ karar_son_sira_no=karar_son_sira_no,
42
+ siralama=siralama,
43
+ siralama_direction=siralama_direction,
44
+ page_size=page_size,
45
+ page_number=page_number
46
+ )
47
+
48
+ client = YargitayClient()
49
+ response = await client.detailed_search(criteria)
50
+
51
+ if response.error:
52
+ return f"Arama sırasında hata oluştu: {response.error}"
53
+
54
+ if not response.results:
55
+ return "Belirtilen kriterlere uygun sonuç bulunamadı."
56
+
57
+ output = f"Toplam {response.total_count} sonuç bulundu:\n\n"
58
+
59
+ for case in response.results:
60
+ output += f"ID: {case.id}\n"
61
+ output += f"Daire: {case.daire}\n"
62
+ output += f"Esas/Karar: {case.esas_no} / {case.karar_no}\n"
63
+ output += f"Tarih: {case.tarih}\n"
64
+ output += f"Özet: {case.ozet}\n"
65
+ output += "-" * 40 + "\n"
66
+
67
+ return output
68
+
69
+
70
+ @mcp.tool()
71
+ async def get_case_detail(
72
+ document_id: str = Field(..., description="Arama sonuçlarından elde edilen karar doküman ID'si")
73
+ ) -> str:
74
+ """
75
+ Belirli bir Yargıtay kararının detaylı metnini veya tam içeriğini getirir.
76
+ """
77
+ client = YargitayClient()
78
+ response = await client.get_document(document_id)
79
+
80
+ if response.error:
81
+ return f"Karar detayı getirilirken hata oluştu: {response.error}"
82
+
83
+ return f"Karar ID: {response.id}\n\n{response.icerik}"
84
+
85
+
86
+ def main():
87
+ """MCP Sunucusunu ayağa kaldıran ana fonksiyon."""
88
+ # FastMCP otomatik olarak stdio transportunu kullanır
89
+ mcp.run()
90
+
91
+
92
+ if __name__ == "__main__":
93
+ main()
@@ -0,0 +1,11 @@
1
+ from .client import YargitayClient
2
+ from .models import SearchCriteria, DetailedSearchCriteria, SearchResponse, CaseResult, CaseDetail
3
+
4
+ __all__ = [
5
+ "YargitayClient",
6
+ "SearchCriteria",
7
+ "DetailedSearchCriteria",
8
+ "SearchResponse",
9
+ "CaseResult",
10
+ "CaseDetail"
11
+ ]
@@ -0,0 +1,160 @@
1
+ import httpx
2
+ import logging
3
+ from typing import Dict, Any
4
+ import re
5
+ from .models import SearchCriteria, DetailedSearchCriteria, SearchResponse, CaseResult, CaseDetail
6
+
7
+ logger = logging.getLogger(__name__)
8
+
9
+
10
+ class YargitayClient:
11
+ """Yargıtay Karar Arama sistemi için HTTP istemcisi."""
12
+
13
+ BASE_URL = "https://karararama.yargitay.gov.tr"
14
+ SEARCH_ENDPOINT = f"{BASE_URL}/aramalist"
15
+ DETAIL_SEARCH_ENDPOINT = f"{BASE_URL}/aramadetaylist"
16
+ DOCUMENT_ENDPOINT = f"{BASE_URL}/getDokuman"
17
+
18
+ def __init__(self, timeout: int = 30):
19
+ # Gerçekçi bir tarayıcı simülasyonu için User-Agent
20
+ self.headers = {
21
+ "User-Agent": ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
22
+ "AppleWebKit/537.36 (KHTML, like Gecko) "
23
+ "Chrome/120.0.0.0 Safari/537.36"),
24
+ "Accept": "application/json, text/plain, */*",
25
+ "Accept-Language": "tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7",
26
+ "Connection": "keep-alive",
27
+ "Content-Type": "application/json"
28
+ }
29
+ self.timeout = timeout
30
+
31
+ async def search(self, criteria: SearchCriteria) -> SearchResponse:
32
+ """Belirtilen kriterlere göre kararları arar."""
33
+ # Gerçek request yapısına göre payload hazırlanması
34
+ data_payload: Dict[str, Any] = {
35
+ "pageSize": criteria.page_size,
36
+ "pageNumber": criteria.page_number
37
+ }
38
+ if criteria.kelime:
39
+ data_payload["aranan"] = criteria.kelime
40
+ data_payload["arananKelime"] = criteria.kelime
41
+
42
+ payload = {"data": data_payload}
43
+
44
+ try:
45
+ async with httpx.AsyncClient(timeout=self.timeout, headers=self.headers, verify=False) as client:
46
+ response = await client.post(self.SEARCH_ENDPOINT, json=payload)
47
+ response.raise_for_status()
48
+
49
+ # Yanıtın JSON olduğunu varsayıyoruz.
50
+ # Gerçekte Yargıtay yapısı HTML dönebilir, eğer öyleyse BeautifulSoup eklenip parse edilmeli.
51
+ # Şimdilik JSON modeline uygun varsayarak örnekleme yapıyoruz.
52
+ data = response.json()
53
+
54
+ results = []
55
+ # Gerçek JSON yanıt formatına göre ayrıştırma
56
+ response_data = data.get("data", {}) if isinstance(data, dict) else {}
57
+ items = response_data.get("data", []) if isinstance(response_data, dict) else []
58
+ total_count = response_data.get("recordsTotal", len(items)) if isinstance(response_data, dict) else len(
59
+ items)
60
+
61
+ for item in items:
62
+ if isinstance(item, dict):
63
+ results.append(CaseResult(
64
+ id=str(item.get("id", "")),
65
+ kurum="Yargıtay",
66
+ daire=item.get("daire", ""),
67
+ esas_no=item.get("esasNo", ""),
68
+ karar_no=item.get("kararNo", ""),
69
+ tarih=item.get("kararTarihi", ""),
70
+ ozet=item.get("arananKelime", "")
71
+ ))
72
+
73
+ return SearchResponse(results=results, total_count=total_count)
74
+
75
+ except httpx.HTTPError as e:
76
+ logger.error(f"HTTP Hatası: {e}")
77
+ return SearchResponse(results=[], error=f"HTTP isteği başarısız: {str(e)}")
78
+ except Exception as e:
79
+ logger.error(f"Beklenmeyen Hata: {e}")
80
+ return SearchResponse(results=[], error=f"Beklenmeyen hata oluştu: {str(e)}")
81
+
82
+ async def detailed_search(self, criteria: DetailedSearchCriteria) -> SearchResponse:
83
+ """Detaylı arama kriterlerine göre kararları arar."""
84
+ data_payload: Dict[str, Any] = {
85
+ "arananKelime": criteria.kelime,
86
+ "daire": criteria.daire,
87
+ "baslangicTarihi": criteria.baslangic_tarihi,
88
+ "bitisTarihi": criteria.bitis_tarihi,
89
+ "esasYil": criteria.esas_yil,
90
+ "esasIlkSiraNo": criteria.esas_ilk_sira_no,
91
+ "esasSonSiraNo": criteria.esas_son_sira_no,
92
+ "kararYil": criteria.karar_yil,
93
+ "kararIlkSiraNo": criteria.karar_ilk_sira_no,
94
+ "kararSonSiraNo": criteria.karar_son_sira_no,
95
+ "siralama": criteria.siralama,
96
+ "siralamaDirection": criteria.siralama_direction,
97
+ "pageSize": criteria.page_size,
98
+ "pageNumber": criteria.page_number
99
+ }
100
+
101
+ payload = {"data": data_payload}
102
+
103
+ try:
104
+ async with httpx.AsyncClient(timeout=self.timeout, headers=self.headers, verify=False) as client:
105
+ response = await client.post(self.DETAIL_SEARCH_ENDPOINT, json=payload)
106
+ response.raise_for_status()
107
+
108
+ data = response.json()
109
+ results = []
110
+
111
+ response_data = data.get("data", {}) if isinstance(data, dict) else {}
112
+ items = response_data.get("data", []) if isinstance(response_data, dict) else []
113
+ total_count = response_data.get("recordsTotal", len(items)) if isinstance(response_data, dict) else len(
114
+ items)
115
+
116
+ for item in items:
117
+ if isinstance(item, dict):
118
+ results.append(CaseResult(
119
+ id=str(item.get("id", "")),
120
+ kurum="Yargıtay",
121
+ daire=item.get("daire", ""),
122
+ esas_no=item.get("esasNo", ""),
123
+ karar_no=item.get("kararNo", ""),
124
+ tarih=item.get("kararTarihi", ""),
125
+ ozet=item.get("arananKelime", "")
126
+ ))
127
+
128
+ return SearchResponse(results=results, total_count=total_count)
129
+
130
+ except httpx.HTTPError as e:
131
+ logger.error(f"HTTP Hatası (Detaylı Arama): {e}")
132
+ return SearchResponse(results=[], error=f"HTTP isteği başarısız: {str(e)}")
133
+ except Exception as e:
134
+ logger.error(f"Beklenmeyen Hata (Detaylı Arama): {e}")
135
+ return SearchResponse(results=[], error=f"Beklenmeyen hata oluştu: {str(e)}")
136
+
137
+ async def get_document(self, document_id: str) -> CaseDetail:
138
+ """Belirtilen ID'ye sahip kararın tam metnini getirir."""
139
+ params = {"id": document_id}
140
+
141
+ try:
142
+ async with httpx.AsyncClient(timeout=self.timeout, headers=self.headers, verify=False) as client:
143
+ response = await client.get(self.DOCUMENT_ENDPOINT, params=params)
144
+ response.raise_for_status()
145
+
146
+ data = response.json()
147
+ html_content = data.get("data", "") if isinstance(data, dict) else response.text
148
+
149
+ # HTML etiketlerini temizleyip okunabilir metin haline getiriyoruz
150
+ text_content = re.sub(r'<[^>]+>', ' ', html_content)
151
+ text_content = re.sub(r'\s+', ' ', text_content).strip()
152
+
153
+ return CaseDetail(id=document_id, icerik=text_content, raw=html_content)
154
+
155
+ except httpx.HTTPError as e:
156
+ logger.error(f"Doküman getirme HTTP Hatası: {e}")
157
+ return CaseDetail(id=document_id, icerik="", raw="", error=f"Doküman çekilemedi: {str(e)}")
158
+ except Exception as e:
159
+ logger.error(f"Beklenmeyen Hata: {e}")
160
+ return CaseDetail(id=document_id, icerik="", raw="", error=f"Beklenmeyen hata oluştu: {str(e)}")
@@ -0,0 +1,48 @@
1
+ from pydantic import BaseModel, Field
2
+ from typing import List, Optional
3
+
4
+
5
+ class SearchCriteria(BaseModel):
6
+ kelime: Optional[str] = Field(None, description="Aranacak kelime veya kelime öbeği")
7
+ page_size: int = Field(10, description="Sayfa başı kayıt sayısı")
8
+ page_number: int = Field(1, description="Sayfa numarası")
9
+
10
+
11
+ class DetailedSearchCriteria(BaseModel):
12
+ kelime: Optional[str] = Field("", description="Aranacak kelime")
13
+ daire: Optional[str] = Field("", description="İlgili daire")
14
+ baslangic_tarihi: Optional[str] = Field("", description="Başlangıç Tarihi (GG.AA.YYYY)")
15
+ bitis_tarihi: Optional[str] = Field("", description="Bitiş Tarihi (GG.AA.YYYY)")
16
+ esas_yil: Optional[str] = Field("", description="Esas Yıl")
17
+ esas_ilk_sira_no: Optional[str] = Field("", description="Esas İlk Sıra No")
18
+ esas_son_sira_no: Optional[str] = Field("", description="Esas Son Sıra No")
19
+ karar_yil: Optional[str] = Field("", description="Karar Yıl")
20
+ karar_ilk_sira_no: Optional[str] = Field("", description="Karar İlk Sıra No")
21
+ karar_son_sira_no: Optional[str] = Field("", description="Karar Son Sıra No")
22
+ siralama: str = Field("3", description="Sıralama türü")
23
+ siralama_direction: str = Field("asc", description="Sıralama yönü (asc/desc)")
24
+ page_size: int = Field(10, description="Sayfa başı kayıt sayısı")
25
+ page_number: int = Field(1, description="Sayfa numarası")
26
+
27
+
28
+ class CaseResult(BaseModel):
29
+ id: str = Field(description="Karar doküman ID'si")
30
+ kurum: Optional[str] = Field(None, description="Kurum (Ör: Yargıtay)")
31
+ daire: Optional[str] = Field(None, description="Daire")
32
+ esas_no: Optional[str] = Field(None, description="Esas Numarası")
33
+ karar_no: Optional[str] = Field(None, description="Karar Numarası")
34
+ tarih: Optional[str] = Field(None, description="Karar Tarihi")
35
+ ozet: Optional[str] = Field(None, description="Karar Özeti veya Kısa İçerik")
36
+
37
+
38
+ class SearchResponse(BaseModel):
39
+ results: List[CaseResult]
40
+ total_count: int = 0
41
+ error: Optional[str] = None
42
+
43
+
44
+ class CaseDetail(BaseModel):
45
+ id: str = Field(description="Karar doküman ID'si")
46
+ icerik: str = Field(description="Kararın tam metni veya detaylı içeriği")
47
+ raw: str = Field(description="Ham HTML veya JSON yanıtı")
48
+ error: Optional[str] = None