---
title: "Adresle çalışan site içi arama · Specoria"
description: "Adresle çalışan site içi arama: Ajan kataloğu tıklamadan, arama adresiyle sorgular; adresle çalışmayan arama onu yavaş tarayıcıya mecbur bırakır."
source_url: "https://specoria.com/tr/yontem/kontroller/site-search/"
lang: "tr"
---

[← Bütün kontroller](https://specoria.com/tr/yontem/kontroller/)
site_search

# Adresle çalışan site içi arama

Neden önemli Ajan kataloğu tıklamadan, arama adresiyle sorgular; adresle çalışmayan arama onu yavaş tarayıcıya mecbur bırakır.

**Kategori**
Eylem (sepet ve sipariş)

**Ağırlık**
100 puan üzerinden 1

**Kritik engel**
Hayır. Kalırsa yalnızca kendi ağırlığı kadar puan kaybettirir.

**Geçerli olduğu siteler**
E-ticaret siteleri

**Efor**
1-2 saat · geliştirici

**Skor modeli**
v2.4

## Nasıl ölçüyoruz?

Ana sayfada adres parametresiyle çalışan arama aranır: yapısal veride SearchAction ya da GET ile gönderilen bir arama formu (q, s, search…). Yalnızca betikle çalışan bir arama kutusu kısmen geçer; arama yoksa düşer.

### Sonuç sayfasında ne yazar?

Test sonucundaki cümleler bunlardır; “…” yerine sitenizde bulunan değer gelir.

- Geçti Site içi arama adres parametresiyle çalışıyor (ör. /arama?q=…).
- Kısmen Arama kutusu var ama yalnızca betikle çalışıyor; adresle sorgulanamıyor.
- Kaldı Site içi arama bulunamadı.

## Nasıl düzeltilir?

**Hedef:** Arama GET formuyla adres parametresine yazılır; WebSite verisinde SearchAction tanımlıdır.

### Örnek kod

`{
"@context": "https://schema.org",
"@type": "WebSite",
"url": "https://example.com",
"potentialAction": {
"@type": "SearchAction",
"target": "https://example.com/arama?q=…",
"query-input": "required name=search_term_string"
}
}`
Örnek değerler (example.com, ürün adı, fiyat) yer tutucudur; kendi sitenizinkilerle değiştirin.

### Kendiniz nasıl doğrularsınız?

https://example.com/arama?q=deneme gibi bir adres doğrudan sonuç sayfası açmalı.

### Bir yapay zekâ kodlama ajanıyla düzeltin

Bunu mağazanızın kodu üzerinde çalışan Claude Code, Cursor ya da başka bir kodlama ajanına yapıştırın. Yayına almadan önce değişikliği gözden geçirin.

`Mağazamın sitesi üzerinde çalışıyorsun. Specoria’nın ajan hazırlık testi aşağıdaki maddeyi kontrol ediyor. Yapay zekâ alışveriş ajanları mağazayı okuyabilsin ve işlem yapabilsin diye bunu düzelt.

## 1. Adresle çalışan site içi arama (site_search)
Hedef: Arama GET formuyla adres parametresine yazılır; WebSite verisinde SearchAction tanımlıdır.
Örnek düzeltme (bu kod tabanına ve altyapıya uyarla; örnek değerler yer tutucudur):
```
{
"@context": "https://schema.org",
"@type": "WebSite",
"url": "https://example.com",
"potentialAction": {
"@type": "SearchAction",
"target": "https://example.com/arama?q=…",
"query-input": "required name=search_term_string"
}
}
```
Kaynak: https://specoria.com/tr/yontem/kontroller/site-search/

## Kurallar
- Önce kod tabanını incele ve hiçbir şeyi değiştirmeden hangi dosya ya da şablonları değiştireceğini bana söyle.
- Yalnızca bu kontrollerin gerektirdiğini değiştir; görünen sayfa ile yapısal veri aynı şeyi söylesin.
- Fiyat, stok, kargo ya da iade koşulu, yorum ve ürün kimliği (GTIN) uydurma: mağazanın gerçek verisinden al ya da bana sor.
- Gerçek ziyaretçileri engelleme ya da yavaşlatma; izleme kodu ekleme.
- Yayına aldıktan sonra https://specoria.com/tr/ adresindeki ücretsiz testi yeniden çalıştırıp düzeltmeyi doğrula.`

## Şartname ve rehberler

- [schema.org/SearchAction ↗](https://schema.org/SearchAction)

Kontrol bu açık kaynaklara dayanır; bağlantılar yayımcının kendi sayfalarıdır.

## 196 kriterlik çerçevedeki karşılığı

Bu kontrolün sonucu, hazırlık çerçevesindeki şu maddeler için kanıt sayılır:

- `0.site_search` Alışveriş akışı (Specoria) bölümü

[Çerçeve ve kaynağı →](https://specoria.com/tr/yontem/#kriterler)

[← ÖncekiSipariş takibi](https://specoria.com/tr/yontem/kontroller/order-tracking/)[Sonraki →Otel yapısal verisi (Hotel / LodgingBusiness)](https://specoria.com/tr/yontem/kontroller/lodging-schema/)

[Ücretsiz testi çalıştır](https://specoria.com/tr/yontem/kontroller/site-search/#test) [Örnek raporu görün →](https://specoria.com/tr/rapor/ornek-rapor/)

## İlgili

- [Sepete ekle düğmesi ilk HTML’de](https://specoria.com/tr/yontem/kontroller/add-to-cart/)
- [Sepet düğmesi erişilebilir mi?](https://specoria.com/tr/yontem/kontroller/cart-accessible/)
- [Ajan simülatörü](https://specoria.com/tr/ajan-simulatoru/) Yapay zekâ ajanlarının gerçek tarayıcıda alışverişini izleyin
- [Ajan protokolleri haritası: UCP, ACP, AP2, MCP, WebMCP](https://specoria.com/tr/ajan-protokolleri/) Her protokol ne yapar, ücretsiz test neyi kontrol eder

ÜCRETSİZ TEST

## Mağazanızı şimdi test edin

Mağaza adresinizi yazın: herkese açık sayfalarınızda, bir alışveriş ajanının okuduğu gibi 27 kontrol.

Ücretsiz test tarayıcınızda çalışır ve JavaScript gerektirir. [Bunun yerine ücretsiz derin denetimi e-postayla isteyin →](https://specoria.com/tr/#iletisim)

Sonucunuz kendi sayfasında açılır. Tamamını görmek isterseniz ücretsiz derin denetim ve panel e-postayla gelir.