Claude Code ile Web Sitesi SEO Otomasyonu: Başlangıç Rehberi

Bir sayfayı SEO açısından iyileştirmek için önce canonical etiketinin ne yaptığını bilmeniz gerekmez. İhtiyacınız olan şey: önemli bir sayfanın URL'si, değişiklik zamanı geldiğinde web sitesi projenize erişim ve net bir kuraldır: Claude Code önce kontrol eder, siz değişiklikleri sonra onaylarsınız.

Bu rehber, yeni başlayanların seo-auto-optimizer skill'i ile tekrarlayan SEO işlerini Claude Code kullanarak nasıl otomatikleştirebileceğini gösterir. Sayfayı inceleyecek, bulguları sade bir dille açıklatacak, onayladığınız güncellemeleri site dosyalarında hazırlatacak ve yayın öncesinde sonucu test edeceksiniz.

SEO otomasyonu, ajana sitenizi verip "her şeyi düzelt" demek değildir. Yavaş ve tekrar eden işleri ona bırakırken, bir sayfanın aramadan kaybolmasına veya ziyaretçilerin kafasının karışmasına yol açabilecek kararların denetimini sizde tutmaktır.

Bu akışın sonunda ne elde edeceksiniz?

İlk çalışmanın sonunda şunlara sahip olacaksınız:

• görünür SEO sorunları için incelenmiş önemli bir URL'ye;
• Claude Code'un destekleyebileceği kısa ve önceliklendirilmiş bir değişiklik listesine;
• her önerinin sade Türkçe açıklamasına;
• uygulamayı seçerseniz yerel web projenizde gözden geçirilmiş bir değişiklik setine; ve
• yayına çıkmadan önce kullanacağınız bir test kontrol listesine.

İlk deneme için 30-60 dakika ayırın. Ana sayfanız, ürün veya hizmet sayfanız ya da halihazırda trafik alan bir blog yazısı gibi işletmeniz için önemli tek bir sayfa seçin. Tüm siteyle başlamayın.

Buradaki "tamamlandı" tanımı şudur: hangi sayfanın neden değiştiğini açıklayabilir ve güncellemeden sonra çalışmaya devam ettiğini doğrulayabilirsiniz. Bu, sıralama artışı garantisi değildir. Arama motorlarının sayfayı yeniden taraması ve değerlendirmesi zaman alır.

Başlamadan önce hazırlayacağınız dört şey

Google Search Console veya teknik bir geçmiş olmadan da başlayabilirsiniz. İlk kontrol, herkese açık sayfa sinyallerini kullanır.

Google Search Console, Bing Webmaster Tools ve bir tarayıcı (crawler) dışa aktarımı daha sonra faydalıdır. Bunlar, tek bir sayfanın cevaplayamayacağı trafik kaybı, birbiriyle yarışan URL'ler veya toplu indeksleme sorunları gibi soruları yanıtlar.

Claude Code çalışma alanınıza SEO Auto Optimizer skill'ini ekleyin

Bu makaleden indirilecek bir ek yoktur; skill dosyasını kendiniz oluşturmanız gerekir.

En hızlı yöntem: bu makaleyi Claude Code'a gönderin

Makale yayınlandıysa bağlantısını Claude Code'a verip skill'i kurmasını isteyebilirsiniz. Aşağıdaki istemde [MAKALE URL'Sİ] yerine bu makalenin canlı URL'sini koyun:

Bu makaleyi oku ve seo-auto-optimizer skill'ini anlatıldığı şekilde kur:
[MAKALE URL'Sİ]

Yeni başlıyorum. Makaledeki eksiksiz SKILL.md kod bloğunu bul, .claude/skills/seo-auto-optimizer/SKILL.md dosyasını Claude Code çalışma alanındaki doğru skills dizininde oluştur ve kod bloğunu dosyaya aynen kopyala.

Dosyayı yazmadan önce kullanacağın tam yolu söyle. Yazdıktan sonra ilk 10 satırı göster ve skill adının seo-auto-optimizer olduğunu doğrula.

Henüz web sitemi inceleme, site dosyalarını veya ayarları değiştirme, hiçbir şeyi yayınlama ya da dağıtma ve SEO denetimi çalıştırma. Yalnızca bu skill'i kur ve doğrula.

Etkin web sitesi projenizin kök klasöründe şu klasörleri ve dosyayı oluşturun:

sizin-web-projeniz/
.claude/
skills/
seo-auto-optimizer/
SKILL.md

Yerel Claude Code yapılandırmanız açıkça başka bir skills yolu tanımlıyorsa o yolu kullanın. Klasör adı ve dosyadaki name değeri seo-auto-optimizer olmalıdır; Claude Code bunu $seo-auto-optimizer ile çağırabilir.

SKILL.md adında düz metin dosyası açın ve aşağıdaki içeriğin tamamını yapıştırın. Bunu web sitesi kodunuza değil, yukarıdaki skills/seo-auto-optimizer/ klasörüne koyun.

Skill, varsayılan olarak salt okunur modda başlar. Bu bilinçli bir tercihtir: herkese açık kanıtları kontrol eder ve plan hazırlar; sayfa yayınlamaz, sitemap göndermez, Search Console'u değiştirmez ve canlı sitenizi düzenlemez.

---
name: seo-auto-optimizer
description: Audit one public URL or a group of website URLs with evidence, then create an SEO optimization plan ranked by impact and effort. Use when a user asks to check, diagnose, optimize, or create an SEO task list, especially for indexing, technical SEO, metadata, structured data, content quality, internal links, search intent, keyword cannibalization, Core Web Vitals, mobile experience, CTR, Google Search Console, Bing Webmaster Tools, sitemaps, robots.txt, or E-E-A-T. By default, audit and provide code or copy recommendations only. Do not change the website, CMS, search-engine consoles, or third-party platforms.
---

# SEO Auto Optimizer

Turn a supplied URL into a verifiable SEO optimization plan that a developer, content team, or growth team can act on. Never present an item as checked or fixed when public evidence cannot confirm it.

## Working boundaries

- Default to read-only work. Inspect public pages, resources, and public site files. Do not change live pages, submit a sitemap, publish content, buy links, or operate any account.
- For a single-URL request, audit that URL and only the same-domain public files needed to verify it, such as `robots.txt`, a sitemap, or page links. Do not turn a single-page observation into a site-wide conclusion.
- Mark work that needs a login, search-performance data, a full crawl, server logs, or business facts as `Needs data`. State what data is needed and how to check it.
- Do not recommend black-hat, manipulative, or fabricated SEO: no purchased links, fake reviews/authors/comments, doorway pages, keyword stuffing, or bulk low-value AI pages.
- Follow the site's market, page language, URL conventions, and content standards. Proposed titles, meta descriptions, H1s, and body copy must use the target page's language.

## Inputs and clarification

A request needs at least one URL. If available, use the target market, language, business model, primary conversion, target keywords, Google Search Console or Bing exports, and local website project.

When those details are missing, do not block the work. Infer what you can from the page language, page type, and visible content, then state your assumptions at the beginning of the report. Ask one focused question only when the user requests keyword strategy, competitive content, or a site-wide change and the answer would materially depend on the target market or business.

## Audit process

### 1. Build an evidence baseline

1. Record the inspection date, final URL, HTTP status, redirect chain, `<html lang>`, visible robots instructions, and page-rendering limits.
2. Read the first screen, main content, and available source or DOM. Record the title, meta description, canonical, robots meta, viewport, H1-H6, visible publish or update date, author information, approximate body length, images, internal and external links, JSON-LD, and important JavaScript dependencies.
3. Check the same-domain `/robots.txt`. Check a sitemap only when one is discoverable; do not say a sitemap does not exist merely because its URL is not explicitly listed.
4. Keep locatable evidence for every conclusion: tag text, HTTP header, link URL, DOM observation, screenshot observation, or public-tool result. If the page is blocked by a WAF, login, geography, or another access limit, state the limitation immediately.

### 2. Classify every check

Use exactly one status for each item:

| Status | Meaning |
| --- | --- |
| `Pass` | Public evidence shows the item meets its purpose. |
| `Issue` | Public evidence shows an error, risk, or clear omission. |
| `Opportunity` | It may not be an error, but there is a reasonable opportunity to improve visibility, click-through rate, user experience, or conversion. |
| `Needs data` | Google Search Console, Bing, logs, a full crawl, field performance data, or keyword data is required. |
| `Not applicable` | The page type or business does not need this item; explain why. |

Do not turn `Needs data` into an `Issue` just to fill a checklist. Resolve the root causes that affect crawling, indexing, user experience, or the page's main intent before minor copy changes.

### 3. Create an action plan

Merge findings into non-duplicative tasks and rank them:

- `P0`: The page cannot be crawled or indexed; an incorrect canonical; accidental `noindex`; critical 4xx/5xx; site-wide robots blocking; severe mobile or rendering failure.
- `P1`: Main-page intent or content mismatch; duplicate or thin content; missing or conflicting title and H1; unacceptable structured data; missing key internal links; obvious performance bottleneck.
- `P2`: CTR improvements; images and alt text; FAQs; author and update information; content expansion; topic or comparison pages; local link and URL improvements.
- `P3`: Growth experiments, link earning, business profiles, and monitoring that require performance data or external coordination.

For every task, state the problem, evidence, recommended action, owner (developer, content, SEO, or growth), acceptance criteria, and risk or prerequisite. Give specific code or copy only when current information supports it. Where brand facts are missing, use clear placeholders instead of inventing facts.

## What to check

### A. Crawling, indexing, and URLs

Check and report:

- HTTP status, whether redirects are single-hop and appropriate, loops, and HTTP/HTTPS or www/non-www confusion.
- `robots.txt`, meta robots, `X-Robots-Tag`, and whether canonical URLs are reachable, absolute, single, self-referencing, or point to a sensible preferred URL.
- Whether canonical, `noindex`, pagination or filtering rules, and sitemap behavior agree. Mark uncertain cases as `Needs data`.
- Whether URLs are stable, readable, descriptive, free of meaningless parameters, case or trailing-slash duplication, and keyword stuffing. Do not recommend casual URL changes unless the plan includes 301 redirects, internal-link updates, canonical updates, sitemap updates, and rollback conditions.
- Whether main content appears in initial HTML or can render reliably. When important content depends only on client-side JavaScript, recommend verification with URL Inspection, rendering tests, and server-side rendering or prerendering options.
- Discoverable broken links, 404s, soft 404s, and incorrect internal destinations. A single URL cannot prove that a whole site has no broken links.

### B. Page structure and metadata

Check:

- A unique, accurate, intent-matched title. For Latin-script languages, a rough 50-60 characters can be useful, but accuracy matters more than reaching a count.
- A unique meta description that describes the page's real value without keyword lists or false promises. A meta description is not a ranking guarantee; prioritize relevance and likely click-through appeal.
- One H1 that describes the page's main question. Organize H2 and H3 headings by real topic hierarchy, without skipped levels or decorative text disguised as headings.
- `lang`, viewport, mobile usability, the ratio of main content to template noise, and breadcrumb visibility and semantics.
- Appropriate image formats, dimensions, lazy loading, and specific alt text. Decorative images should have empty alt text. Do not force keywords into alt text.

When recommending a rewrite, provide one adoptable title, meta description, H1, and heading outline. Label any information that needs a brand-owner confirmation.

### C. Structured data and trust signals

Check whether visible page content and JSON-LD, Microdata, or RDFa agree. Consider only schema appropriate to the page type: `BreadcrumbList`, `Article` or `BlogPosting`, `Product`, `SoftwareApplication`, `Organization`, `LocalBusiness`, `FAQPage`, and `WebPage`.

- Recommend schema only when it represents visible, real page information. Never add invented ratings, reviews, prices, authors, FAQs, or awards.
- Identify required fields such as URL, name, description, image, author, publish date, `dateModified`, breadcrumb positions, and entity identifiers.
- For content pages, check visible author information, author page or experience, editorial policy, sources, contact information, organization information, update date, and factual citations. E-E-A-T is not a tag that can be added; it comes from verifiable content and entity information.
- When schema exists, recommend the Google Rich Results Test and Schema Markup Validator as acceptance checks.

### D. Content, intent, and duplication

Identify the page's main query intent: informational, commercial research, transactional, local, navigational, or mixed. Check whether the main content answers the question early and adds value through original evidence, examples, steps, data, or product detail.

- Flag clear thin content, template repetition, unanswered core questions, intent mismatch, and stale content. Do not define thin content by word count alone.
- A single URL cannot prove site-wide duplicate content, keyword cannibalization, or orphan pages. Explain that these require a URL inventory, canonical and index status, GSC query-to-page data, an internal-link graph, and similarity analysis.
- For overlapping pages, first define the evidence and decision criteria for keep, merge, split, or redirect. Never recommend deleting a page based on a guess.
- When content creation is requested, provide a search-intent brief, unique value, information architecture, sources needed for claims, and internal-link targets. Original content means independent insight or verification, not a competitor rewrite.
- Suggest comparison, alternatives, list, or FAQ pages only when they have distinct intent, real comparison criteria, and maintainable facts. Do not create batches of low-value templates.

### E. Internal links, architecture, and topic coverage

Assess how the page can be found and understood:

- Check whether important pages have crawlable HTML links from relevant parent pages, topic hubs, navigation, or breadcrumbs. Anchor text should naturally describe the destination.
- Mark orphan pages as `Needs data` unless a sitemap and full link graph prove the finding.
- For a topic cluster, define one pillar or owner URL, a distinct intent for each support page, link direction, and a cannibalization rule. Multiple near-identical owner pages should not compete for one head topic.
- Before suggesting feature, use-case, integration, comparison, alternatives, or FAQ pages, define the user question, target query, unique content, owner URL, and link-back path.

### F. Performance, mobile use, and Core Web Vitals

Separate lab data from field data. Prefer real-user data from CrUX or PageSpeed Insights to validate LCP, INP, and CLS. Without it, inspect obvious risks: oversized hero media, images without dimensions, render-blocking CSS or JavaScript, third-party scripts, font loading, layout shifts, and heavy client-side rendering.

Every performance recommendation must explain its mechanism and test method. For example: responsive, compressed hero media may improve LCP; image width and height reduce CLS risk; splitting long tasks may improve INP. Do not promise a score or ranking improvement.

### G. Search performance, keywords, and external authority

Unless the user supplies data or access, mark these items as `Needs data`:

- Page-two rankings, traffic or ranking declines, and query-to-page keyword cannibalization.
- URLs or queries with high impressions and low CTR, plus title and meta tests.
- High-volume, low-difficulty keywords, SERP and People Also Ask opportunities, competitor gaps, and search intent.
- High-quality backlinks, broken-link opportunities, brand mentions, Google Business Profile, and local citations.
- GSC or Bing sitemap submission, URL Inspection, index coverage, and crawl errors.

Give an executable data-checking instruction. For example: in GSC, compare the last 28 days with the previous 28 days, filter to the target URL, export queries, impressions, clicks, CTR, and average position, then test a new title or meta description for high-impression, same-intent queries with weak CTR. Link strategies must use audience-relevant, editorially independent, verifiable channels and genuinely useful assets.

## Default deliverable format

Unless the user asks for a shorter response, return these sections in this order:

1. `Scope and limits`: target URL, check date, accessibility, what could not be verified, and key assumptions.
2. `Executive summary`: the three to seven most important findings and what to address first.
3. `Check matrix`: status, evidence, and short conclusion for items A-G. Cover the user's supplied checklist, and state `Needs data` where necessary.
4. `Prioritized action list`: P0-P3 tasks with owner, effort (S/M/L), acceptance criteria, and dependencies.
5. `Implementation-ready recommendations`: where appropriate, include metadata, heading structure, JSON-LD templates, internal-link locations, content briefs, or performance fixes.
6. `Data and human follow-up`: needed GSC, Bing, crawl, log, keyword, and business inputs, plus exact validation steps.

Use careful language. Say a change may improve relevance, discoverability, or CTR. Do not promise indexing, first place rankings, or that every SEO issue has been fixed.

## Completion standard

Before delivering the work, confirm:

- Every conclusion has public evidence or is explicitly labeled as an assumption or `Needs data`.
- Tasks are ordered by impact, dependency, and actual executability, not copied mechanically from a checklist.
- Recommendations do not risk breaking URLs, canonicals, index status, or content facts. Migration, deletion, and merge suggestions include redirect and rollback conditions.
- Schema and E-E-A-T recommendations come from visible facts or are clearly marked as information still needed.
- The report makes clear that no live changes, submissions, or publishing actions were performed.

Kaydedin. Kurulumunuz bunu gerektiriyorsa Claude Code'ı yeniden başlatın veya yeniden yükleyin. Ardından şunu sorun: Bu çalışma alanındaki kullanılabilir skill'leri listele. seo-auto-optimizer kullanılabilir mi? Skill kullanılabilir olduğunu doğrulamadan eğitime başlamayın.

İlk düzenlemeden önce bir CLAUDE.md politikası yazın

Claude Code proje dosyaları üzerinde çalıştığı için, ilk SEO denetiminden önce kökteki CLAUDE.md dosyasını okuyun veya dosya yoksa aşağıdaki dar kapsamlı politikayı oluşturun:

# Güvenli SEO otomasyonu

- Önce yalnızca herkese açık URL kanıtlarını denetle.
- Dosya değiştirmeden önce yazılı plan ve açık kullanıcı onayı iste.
- URL'leri, yönlendirmeleri, robots ayarlarını, `noindex`, canonical, sitemap, CMS veya dağıtımı değiştirme.
- Her değişiklik için yerel test ve özet rapor sun.
- İnsan açıkça istemedikçe commit veya dağıtım yapma.

İlk denetim sırasında giriş yapılmış CMS, Search Console, barındırma ya da dağıtım erişimi vermeyin. Bu politika, Claude Code'un değişiklikten önce planı beklemesini netleştirir.

Claude Code'dan bir şey değiştirmesini istemeden önce sayfayı kontrol edin

Claude Code'ı açın ve aşağıdaki istemi yapıştırın. Örnek URL'yi kendi sayfanızla değiştirin.

$seo-auto-optimizer kullanarak şu sayfayı incele:
https://example.com/sayfaniz

SEO konusunda yeniyim. Her bulguyu sade Türkçe ile açıkla.
Dosya değiştirme, sayfa yayınlama, bir şey gönderme veya canlı sitede değişiklik yapma.

Her öneri için şunları göster:
1. Claude Code ne buldu ve bunu nerede buldu?
2. Bu, ziyaretçiler veya arama motorları için neden önemli olabilir?
3. Doğrulanmış bir sorun mu, iyileştirme fırsatı mı, yoksa daha fazla veriye mi ihtiyaç var?
4. En güvenli sonraki adım nedir?
5. Geliştiriciye veya Google Search Console verisine ihtiyacım var mı?

Raporu SEO uzmanı olmadan okuyun

Skill her kontrol için aynı durumlardan birini kullanmalıdır:

Öncelikler de neyi önce incelemeniz gerektiğini açıklar:

İlk değişiklikleri güvenli seçin; riskli kararları sonraya bırakın

Claude Code'dan sürpriz düzenleme değil, yazılı plan isteyin

Bir öneri mantıklı görünüyorsa önce plan isteyin:

Bu öneriyi uygulamadan önce yalnızca yazılı bir plan hazırla. Önce CLAUDE.md kurallarını oku.

Açık biçimde göster:
1. Değişmesini beklediğin her dosyayı.
2. Her dosyanın etkilediği sayfa veya bileşeni.
3. Ziyaretçilerin ve arama motorlarının farklı olarak ne göreceğini.
4. Sonucu nasıl test edeceğimizi.
5. Değişiklik yanlışsa geri alma yolunu.

Henüz dosya düzenleme, CMS kullanma, commit veya dağıtım yapma.

Planı inceleyin. robots.txt, noindex, canonical, URL, yönlendirme veya sayfa silme içeren adımlarda teknik ya da SEO incelemesi isteyin. Plan düşük riskliyse şu istemi verin:

Planı onaylıyorum. Yalnızca [DOSYA VEYA BİLEŞEN] içindeki [TEK DEĞİŞİKLİK]'i uygula.
Başka dosya, URL, yönlendirme, robots, canonical, CMS veya dağıtım ayarı değiştirme.
Yerel olarak test et ve yaptığın değişiklikleri listele. Commit veya dağıtım yapma.

Sonra özet raporu ve yerel önizlemeyi inceleyin. Açık yazılı onay, Claude Code ile ilk SEO değişikliğinizin zorunlu kapısı olmalıdır.

Sonuç yayına çıkmadan önce kontrol edin

SEO otomasyonu tek sayfadan neyi bilemez?

Bu verileri daha sonra toplama ve düzenleme işini otomatikleştirebilirsiniz. İlk sayfada, Claude Code'un tahmini teşhise dönüştürmek yerine Needs data demesi yeterlidir.

Sürdürülebilir basit haftalık rutin

İlk sayfayı yayınlayıp doğruladıktan sonra, her hafta önemli bir sayfa için bu akışı tekrarlayın:

1. Rastgele URL değil, ticari amacı olan bir sayfa seçin.
2. Salt okunur Claude Code kontrolünü çalıştırın.
3. Yalnızca birkaç açık ve düşük riskli güncellemeyi onaylayın.
4. Uygulama planını ve dosya farkını inceleyin.
5. Dağıtımdan önce yerelde veya staging'de test edin.
6. Sayfayı, tarihi, değişiklikleri ve açık soruları basit bir e-tabloda veya Markdown dosyasında kaydedin.

Birkaç hafta sonra GSC dışa aktarımlarını ekleyin. Claude Code, bir sonraki iyileştirmesi gerçek gösterim, tıklama veya sorgularla desteklenen sayfaları bulmanıza yardım edebilir. Daha geniş teşhis için kod düzeyindeki incelemenin yanında web sitesi SEO puanı kontrolünü kullanın.

Sık sorulan sorular

Claude Code sitemdeki tüm SEO'yu otomatikleştirebilir mi?

Hayır. Claude Code; herkese açık sinyalleri inceleme, sorun listesi çıkarma, title ve description taslağı hazırlama, kod veya içerik değişikliklerini hazırlama ve onaylanmış listeyi kontrol etme gibi tekrarlanabilir işleri otomatikleştirebilir. Sayfa silme, yönlendirme, indeksleme denetimleri, canonical'lar, ticari iddialar, dağıtım veya performans verisiyle ilgili kararlar hâlâ insan incelemesi ister.

Başlamadan önce SEO anahtar kelimelerini bilmem gerekir mi?

Hayır. Önemli bir sayfayla başlayın ve Claude Code'dan görünür SEO kurulumunu açıklamasını isteyin. Anahtar kelime araştırması, yeni sayfa oluşturmak veya hangi mevcut sayfaların çalışmaya değer olduğuna karar vermek istediğinizde gerekir; yalnızca ajanın ürettiği bir liste değil, veri ve müşteri anlayışı gerektirir.

Claude Code, WordPress, Webflow veya Shopify sayfamı benim için düzenleyebilir mi?

Yalnızca Claude Code ortamının o sistem veya site dosyaları için yetkili erişimi varsa. İlk akışta Claude Code'dan metin, kod veya dosya düzeyinde değişiklik hazırlamasını isteyin; CMS güncellemesini sonra siz yapın ya da sahibinden onay alın. Güvenilir bir inceleme süreciniz olmadan yayınlama erişimi vermeyin.

Bu değişiklikler sayfamı Google'da ilk sıraya çıkarır mı?

Hayır. SEO değişiklikleri taranabilirliği, alaka düzeyini, açıklığı ve kullanıcı deneyimini iyileştirebilir. Sıralama; rekabet, arama amacı, site kalitesi, bağlantılar ve arama motorlarının zaman içindeki değerlendirmesine de bağlıdır. Claude Code'u sıralama garantisi değil, daha iyi ve daha güvenli kararlar için bir araç olarak görün.

Yazar: Auspia'da 14 yıllık teknik SEO uzmanı Julian Mercer. Julian; taranabilirlik, schema, rendering, site mimarisi ve AI tarafından okunabilir içeriklerin teknik temelleri hakkında yazar.