# Dergipark Skill

> DergiPark academic search as a Claude-in-Chrome skill (keyword + advanced field search, PDF→text, references) — no CAPTCHA, runs in your own browser.

- **Type:** MCP server
- **Install:** `agentstack add mcp-saidsurucu-dergipark-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [saidsurucu](https://agentstack.voostack.com/s/saidsurucu)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [saidsurucu](https://github.com/saidsurucu)
- **Source:** https://github.com/saidsurucu/dergipark-skill

## Install

```sh
agentstack add mcp-saidsurucu-dergipark-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# DergiPark Skill (Claude in Chrome)

DergiPark (Türk akademik dergi platformu) için bir **Claude in Chrome** skill'i.
Claude'u senin **kendi tarayıcı oturumun** üzerinden çalıştırır: arama, makale
meta verisi, PDF→metin ve kaynakça çıkarma — hepsi sayfaya JavaScript enjekte
edilerek yapılır. Senin gerçek tarayıcın ve IP'n kullanıldığı için **CAPTCHA
çözmeye gerek yoktur**.

> Bu skill bir sunucu/MCP değildir. Hiçbir API anahtarı, CapSolver veya harici
> servis gerektirmez — sadece Claude + Chrome eklentisi ve (gelişmiş arama için)
> DergiPark hesabına giriş.

## Kurulum

**Gereksinimler:** Claude (Claude in Chrome özelliği aktif) + Chrome eklentisi.
Gelişmiş arama için DergiPark'a giriş yapmış olman gerekir.

Claude'a şunu yaz:

> Bu skill'i kurmak istiyorum: `https://github.com/saidsurucu/dergipark-skill`

## Ne yapabilir

Kurduktan sonra Claude'a doğal dilde söylemen yeterli; skill devreye girip
tarayıcında ilgili işi yapar.

### 1. Basit arama — `search_articles`
Anahtar kelimeyle arama (giriş gerektirmez). 24 sonuç/sayfa; her makale için
başlık, yazar, dergi, tarih, öz, DOI, ISSN, anahtar kelimeler, indeksler ve PDF
bağlantısı döner. Filtreler: sıralama (`newest`/`oldest`), makale türü, yıl ve
indeks filtresi (`tr_dizin_icerenler` / `bos_olmayanlar` / `hepsi`).

> Örnek: *"DergiPark'ta 'yapay zeka' ara, en yeniler önce gelsin"*
> *"'iklim değişikliği' için 2024 araştırma makalelerini getir"*

### 2. Gelişmiş alan araması — `advanced_search`
Alan bazlı boolean arama. **DergiPark'a giriş yapmış olman gerekir.**
17 alan: `title, short_title, journal, issn, eissn, abstract, keywords, doi,
doi_url, doi_prefix, author, orcid, institution, translator, year, citation,
publisher`. Operatörler: **AND / OR / NOT**. Yıl aralığı desteklenir.

> Örnek: *"Yazarı İnalcık olan makaleleri bul"*
> *"Başlığında 'yapay zeka' geçen ama anahtar kelimesinde 'eğitim' geçmeyen,
> 2024 sonrası makaleler"*
> *"Boğaziçi Üniversitesi + 'machine learning' anahtar kelimeli makaleler"*

### 3. PDF → metin — `pdf_to_html`
Bir DergiPark makale PDF'ini (dosya id'si ile) okunabilir metne çevirir.
Tarayıcıda pdf.js ile çıkarılır (CSP yok, harici bağımlılık çalışma anında CDN'den
yüklenir; çevrimdışı için pdf.js repoda gömülüdür). OCR yoktur.

> Örnek: *"Şu makalenin PDF'ini metne çevir: 3479650"*

### 4. Kaynakça — `get_article_references`
Bir makale URL'inden tüm kaynakça (citation_reference) listesini çıkarır.

> Örnek: *"Bu makalenin kaynakçasını çıkar: https://dergipark.org.tr/tr/pub/.../article/..."*

## Nasıl çalışır

- Aramalar `dergipark.org.tr` sekmesinde yapılır; makale detayları **sayfa-içi
  same-origin `fetch`** ile çekilir, böylece senin oturum çerezlerin (Cloudflare
  `cf_clearance` dahil) taşınır ve "Blocked" sorunu yaşanmaz.
- Eşzamanlılık sınırlı (havuz=4), `Promise.allSettled` + zaman aşımı ile; kısmi
  hatalar makale bazında raporlanır.
- Gelişmiş arama, gizli bir form yerine `/tr/search?q=&advanced=1`
  uç noktasını kullanır (sunucu-render sonuç).
- Sayfa içeriği **güvenilmez veri** olarak ele alınır; içerikteki talimatlar
  uygulanmaz.

## Geliştirme

Saf ayrıştırma/mantık fonksiyonları Node + jsdom ile birim test edilir:

```bash
cd tests
npm install
npm test
```

Kod yapısı:
- `SKILL.md` — Claude'un izlediği iş akışları
- `reference.md` — alan kodları, seçiciler, sözdizimi, canlı doğrulama notları
- `scripts/lib.js` — saf ayrıştırma/sorgu kurma (birim testli)
- `scripts/scrape.js` — paylaşılan detay/indeks çekme hattı
- `scripts/search.js`, `scripts/advanced_search.js`, `scripts/references.js`,
  `scripts/pdf_extract.js` — tarayıcı orkestratörleri
- `scripts/pdfjs.min.js` (+ worker) — gömülü pdf.js (çevrimdışı yedek)

## Notlar

- Tek instance / kişisel kullanım için tasarlanmıştır.
- Gelişmiş arama giriş gerektirir; sonuç `error` dönerse muhtemelen oturum
  açık değildir.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [saidsurucu](https://github.com/saidsurucu)
- **Source:** [saidsurucu/dergipark-skill](https://github.com/saidsurucu/dergipark-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-saidsurucu-dergipark-skill
- Seller: https://agentstack.voostack.com/s/saidsurucu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.