Vercel ve Shopify ile Ajan Ticareti (Agent Commerce) Çağı: Vercel Shop ve Modern E-Ticaret Mimarisi

Vercel ve Shopify, yapay zeka ajanlarını birinci sınıf müşteriye dönüştüren Vercel Shop ve yeni Hydrogen SDK mimarisini duyurdu. İşte teknik detaylar.

Vercel ve Shopify ile Ajan Ticareti (Agent Commerce) Çağı: Vercel Shop ve Modern E-Ticaret Mimarisi

E-Ticarette Yeni Paradigma: İnsan Arayüzlerinden Yapay Zeka Ajanlarına

İnternet üzerindeki e-ticaret ekosistemi, çeyrek asırdır tek bir temel ön kabul üzerine inşa edildi: Ekranın arkasında görsel hiyerarşiyi, renk kontrastlarını ve buton yerleşimlerini algılayan bir insan kullanıcının bulunduğu gerçeği. Bunun bir uzantısı olarak arama motoru botları (Googlebot, Bingbot vb.) da sayfaların salt HTML metinlerini ve dizinleme sinyallerini taramak üzere tasarlandı. Ancak büyük dil modellerinin (LLM) otonom karar alabilen yapay zeka ajanlarına (AI Agents) dönüşmesi, bu ikili denklemi kökünden sarsıyor.

Günümüzde yapay zeka ajanları kullanıcılar adına internette alışveriş yapmaya başladı bile. Fakat mevcut web siteleri, bot korumaları (Cloudflare, reCAPTCHA), karmaşık JavaScript yüklemeleri ve DOM ağacına gömülü dinamik arayüzler nedeniyle otonom yazılımlar için aşılması güç engellerle doludur.

Vercel ve Shopify ortaklığıyla genel kullanıma sunulan Vercel Shop ve baştan yazılan Shopify Hydrogen SDK, ajanları ikinci sınıf bir kazıyıcı (scraper) olmaktan çıkarıp doğrudan "birinci sınıf müşteri" (first-class shopper) konumuna yükseltiyor.

"Ödeme altyapısını (checkout) doğru kurgulamak inanılmaz derecede zordur; gerçekten 20 yıllık ince ayar gerektiren yazılım parçalarından biridir. Shopify'ın tüm altyapısını alıp üzerine dilediğinizi inşa edebilirsiniz."
— Tobias Lütke, Shopify Kurucu Ortağı ve CEO'su


Geleneksel Headless ve Ajan Uyumlu (Agent-Ready) Mimarilerin Karşılaştırması

Yeni nesil mimarinin getirdiği dönüşümü anlamak için klasik headless yaklaşımlarla ajan destekli mimariyi kıyaslamak gerekir:

Kriter / ÖzellikGeleneksel Headless E-TicaretAjan Uyumlu (Agent-Ready) E-Ticaret
Birincil Hedef Kitleİnsan kullanıcılar ve klasik arama motoru botlarıİnsanlar, LLM tabanlı arama motorları ve otonom alışveriş ajanları
Veri SunumuAğır DOM, Client-Side Hydration, CSS/Asset bağımlılığıÇift katmanlı: İnsan için UI, ajan için saf yapılandırılmış makine verisi
Sepet ve CheckoutTarayıcı cookie/session ve görsel buton tıklamalarıUniversal Commerce Protocol (UCP) ve Model Context Protocol (MCP) araçları
Arama ve KeşifElasticsearch/Algolia UI bileşenleriDoğal dil vektör araması ve ajanlar için doğrudan API uç noktaları
SEO / AEO DinamikleriMeta etiketler, temel Schema.org JSON-LDGenişletilmiş Yapılandırılmış Veri, LLM-Ready Sitemaps, Raw Content Negotiation

Vercel Shop ve Yeni Hydrogen SDK'nın Teknik Anatomisi

Vercel Shop, Next.js App Router (React Server Components) temelleri üzerinde yükselen, Shopify'ın framework bağımsız hale getirilen yeni Hydrogen SDK'sını kullanan açık kaynaklı bir vitrin şablonudur. Bu mimarinin kalbinde üç ana bileşen yer alır:

  1. Bağımsız SDK Entegrasyonu: Shopify Storefront API'sini tür güvenli (type-safe) bir şekilde tüketen Hydrogen katmanı; ürün kataloğu, dinamik fiyatlandırma, stok kontrolü ve sepet yönetimini doğrudan Next.js Server Components içine aktarır.
  2. Ortak Durum (Shared Cart State): Kullanıcı siteye girdiğinde görsel olarak ürün seçebilir veya gömülü yapay zeka asistanından tavsiye isteyebilir. Her iki etkileşim de arka planda aynı Shopify Cart ID'sini manipüle eder.
  3. Universal Commerce Protocol (UCP) ve MCP Entegrasyonu: Ajanların harici bir tarayıcı otomasyonuna (Puppeteer vb.) ihtiyaç duymadan mağaza alan adında doğrudan çalıştırabileceği fonksiyon çağrıları (Tool Calling) barındırır.

Çift Katmanlı İçerik Müzakeresi (Content Negotiation)

Vercel Shop'un en kritik inovasyonu, aynı URL yapısının hem insanlara hem de ajanlara hizmet edebilmesidir. Ajanlar bir URL'ye istek attığında layout parse etmek yerine doğrudan makine tarafından okunabilir veriye ulaşır.

Aşağıdaki Next.js Route Handler örneğinde, gelen HTTP Accept başlığına göre yanıt döndüren bir modelleme yer almaktadır:

KOD
// app/products/[handle]/route.ts
import { NextRequest, NextResponse } from 'next/server';
import { getProductByHandle } from '@/lib/shopify';

export async function GET(
  request: NextRequest,
  { params }: { params: { handle: string } }
) {
  const product = await getProductByHandle(params.handle);

  if (!product) {
    return NextResponse.json({ error: 'Ürün bulunamadı' }, { status: 404 });
  }

  const acceptHeader = request.headers.get('accept') || '';

  // Yapay zeka ajanları veya LLM araçları için saf veri protokolü
  if (acceptHeader.includes('application/json') || acceptHeader.includes('text/markdown')) {
    return NextResponse.json({
      id: product.id,
      title: product.title,
      description: product.description,
      price: product.priceRange.minVariantPrice.amount,
      currency: product.priceRange.minVariantPrice.currencyCode,
      availableForSale: product.availableForSale,
      variants: product.variants.map((v) => ({
        id: v.id,
        title: v.title,
        available: v.availableForSale,
        price: v.price.amount,
      })),
      checkoutUrl: `/cart/add?variantId=${product.variants[0]?.id}`,
    });
  }

  // Standart tarayıcı yönlendirmesi veya normal sayfa akışı
  return NextResponse.next();
}

Teknik SEO ve Answer Engine Optimization (AEO) Stratejileri

Perplexity, ChatGPT Search, Claude Artifacts ve Google AI Overviews gibi platformlar, web sitelerini klasik crawler'lardan farklı tarar. Bu platformlar sitelerden salt ham veri çekmeyi hedefler.

1. Gelişmiş Schema.org JSON-LD Yapısı

Vercel Shop, Google Merchant Center ve LLM modellerinin kolayca sindirebileceği derinlikte mikro formatları dinamik olarak üretir. Sayfa kodunda aggregateRating, offers, itemCondition ve availability alanları hiçbir client-side gecikme olmadan SSR katmanında render edilir.

KOD
// components/product-schema.tsx
export function ProductSchema({ product }: { product: any }) {
  const schema = {
    '@context': 'https://schema.org',
    '@type': 'Product',
    name: product.title,
    description: product.description,
    sku: product.variants[0]?.sku || product.id,
    offers: {
      '@type': 'Offer',
      price: product.priceRange.minVariantPrice.amount,
      priceCurrency: product.priceRange.minVariantPrice.currencyCode,
      availability: product.availableForSale
        ? 'https://schema.org/InStock'
        : 'https://schema.org/OutOfStock',
      url: `https://example.com/products/${product.handle}`,
    },
  };

  return (
    <script
      type="application/ld+json"
      dangerouslySetInnerHTML={{ __html: JSON.stringify(schema) }}
    />
  );
}

2. Edge Katmanında Önbellekleme ve Performans

PAIGE markasının Shopify ve Vercel altyapısına geçişinde Black Friday döneminde elde ettiği %76'lık dönüşüm artışı ve sıfır kesinti, mimarinin Edge Cache yeteneklerinden kaynaklanır. Next.js stale-while-revalidate ve Incremental Static Regeneration (ISR) stratejileriyle, binlerce varyant içeren e-ticaret siteleri milisaniyelik hızlara ulaşabilir.


Vercel Shop ile Başlangıç Adımları

Projeyi yerel ortamınızda veya sunucunuzda ayağa kaldırmak oldukça pratiktir:

KOD
pnpm create next-app@latest my-agent-store --example https://github.com/vercel/shop

Kurulum tamamlandıktan sonra .env.local dosyasında Shopify Storefront API anahtarlarının yapılandırılması gerekir:

KOD
SHOPIFY_STORE_DOMAIN="magaza-adiniz.myshopify.com"
SHOPIFY_STOREFRONT_ACCESS_TOKEN="shpat_xxxxxxxxx"

Bu adımlarla birlikte sistem; Storefront GraphQL API'si ile haberleşen, ürün varyantlarını anlık senkronize eden ve yapay zeka asistanı entegrasyonuna hazır bir altyapıya kavuşur.


Kaynak: Vercel Blog - https://vercel.com/blog/vercel-and-shopify-make-agents-first-class-shoppers

Sıkça Sorulan Sorular

Bu konu hakkında geliştiricilerin ve site sahiplerinin en çok merak ettiği soruların yanıtları.

Vercel Shop, Shopify'ın Liquid tabanlı klasik monolitik temaları yerine, Next.js (App Router), React Server Components ve Hydrogen SDK kullanılarak geliştirilmiş açık kaynaklı modern bir headless e-ticaret şablonudur. Klasik temalara kıyasla sayfa yükleme hızlarında devasa avantajlar sunar, sunucu maliyetlerini düşürür ve yapay zeka ajanlarının doğrudan mağazadan alışveriş yapabileceği protokolleri hazır olarak barındırır.

Son yazılar

Akordeon (Accordion) İkon Seçimi: Kullanıcı Deneyimi, Erişilebilirlik ve SEO Optimizasyonu

Akordeon (Accordion) İkon Seçimi: Kullanıcı Deneyimi, Erişilebilirlik ve SEO Optimizasyonu

Google'ın Başlık Etiketi Yeniden Yazma Güncellemesi: Kapsamlı Analiz ve Optimizasyon Stratejileri

Google'ın Başlık Etiketi Yeniden Yazma Güncellemesi: Kapsamlı Analiz ve Optimizasyon Stratejileri

Vercel CLI ile Harcama Yönetimi: Sunucusuz Mimarilerde Maliyet ve Altyapı Güvenliği Rehberi

Vercel CLI ile Harcama Yönetimi: Sunucusuz Mimarilerde Maliyet ve Altyapı Güvenliği Rehberi