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.
- yargitay_karar_scraper-0.1.0/.github/workflows/ci.yml +41 -0
- yargitay_karar_scraper-0.1.0/.github/workflows/publish.yml +39 -0
- yargitay_karar_scraper-0.1.0/.gitignore +1 -0
- yargitay_karar_scraper-0.1.0/LICENSE +21 -0
- yargitay_karar_scraper-0.1.0/PKG-INFO +176 -0
- yargitay_karar_scraper-0.1.0/README.md +161 -0
- yargitay_karar_scraper-0.1.0/docs/cli_usage.md +52 -0
- yargitay_karar_scraper-0.1.0/docs/mcp_usage.md +51 -0
- yargitay_karar_scraper-0.1.0/examples/basic_search.py +44 -0
- yargitay_karar_scraper-0.1.0/examples/detailed_search.py +44 -0
- yargitay_karar_scraper-0.1.0/examples/get_document.py +28 -0
- yargitay_karar_scraper-0.1.0/images/cli_detailed_search_example.png +0 -0
- yargitay_karar_scraper-0.1.0/images/cli_karar_detail_example.png +0 -0
- yargitay_karar_scraper-0.1.0/images/cli_search_example.png +0 -0
- yargitay_karar_scraper-0.1.0/images/logo.png +0 -0
- yargitay_karar_scraper-0.1.0/pyproject.toml +25 -0
- yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/__init__.py +2 -0
- yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/cli/__init__.py +3 -0
- yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/cli/main.py +164 -0
- yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/mcp/__init__.py +3 -0
- yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/mcp/server.py +93 -0
- yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/scraper/__init__.py +11 -0
- yargitay_karar_scraper-0.1.0/yargitay_karar_scraper/scraper/client.py +160 -0
- 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())
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -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,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,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
|