# SEO-Anweisungen für die Claude-Routine

Diese Datei sagt Claude, was bei jeder Ausführung der Routine zu tun ist. Passen Sie sie nach Belieben an: Tonalität der Marke, zu überarbeitende Felder, Regeln, die nur für Ihren Shop gelten. Die mit „Anpassen“ markierten Abschnitte werden Sie am häufigsten ändern.

## Oberste Regel: ein einziger Inhalt pro Ausführung

Bei jeder Ausführung bearbeitest du **einen einzigen Inhalt** und hörst dann auf. Auch wenn noch Zeit bleibt, auch wenn weitere Zeilen warten. Die nächste Ausführung übernimmt den nächsten.

## Die Tracking-Datei

Die Datei `suivi-seo.csv` im Stammverzeichnis des Repositorys listet die zu optimierenden Inhalte auf. Spalten:

| Spalte | Inhalt |
| --- | --- |
| `Type` | `product`, `collection`, `page` oder `article` |
| `Handle` | der Shopify-Handle des Inhalts |
| `Title` | der aktuelle Titel, zur Orientierung |
| `Optimized` | `YES`, sobald der Vorschlag an Vetta gesendet wurde, sonst `NO` |
| `OptimizedAt` | Datum und Uhrzeit des Versands (ISO 8601, zum Beispiel `2026-09-25T14:00:00Z`) |
| `WorkingNow` | `YES`, solange eine Ausführung an der Zeile arbeitet, sonst `NO` |
| `WorkingSince` | Datum und Uhrzeit, zu der `WorkingNow` auf `YES` gesetzt wurde |
| `VettaStatus` | Status des Vorschlags in Vetta (`pending`, `approved`, `changes_requested`, `rejected`) |
| `VettaProposalUrl` | Freigabelink des Vorschlags in Vetta |

## Ablauf einer Ausführung

1. Lies `suivi-seo.csv`.
2. Steht in einer Zeile seit weniger als 2 Stunden `WorkingNow = YES`, läuft gerade eine andere Ausführung: Hör auf, ohne etwas zu ändern. Steht der Wert dort seit mehr als 2 Stunden, gilt die Zeile als abgebrochen: Setz `WorkingNow` zurück auf `NO`.
3. Wähle die erste Zeile mit `Optimized = NO`. Gibt es keine, hör auf und melde, dass alles erledigt ist.
4. Setz diese Zeile auf `WorkingNow = YES`, trag `WorkingSince` ein und mach sofort einen Commit und einen Push (Nachricht: `seo: start <handle>`).
5. Ruf mit dem Vetta-Connector `get_shop_context` auf, um den Shop und seine Sprachen kennenzulernen. Such dann den Inhalt mit `list_contents` (Parameter `type` und `query` = der Handle), um seine ID zu erhalten, und lies ihn mit `get_content`.
6. Schreib die neue Version nach den Regeln unten. Stütz dich auf die SEO-Empfehlungen (`seo`) und, falls die Search Console verbunden ist, auf die Suchanfragen knapp vor der ersten Seite (`gsc.opportunities`), die `get_content` zurückgibt.
7. Sende sie mit `propose_version`. Du veröffentlichst nie: Ein Mensch prüft den Vorschlag in Vetta. Zeigt der zurückgegebene SEO-Score ein Problem, das du beheben kannst, sende einen neuen Vorschlag: Er ersetzt den vorherigen.
8. Aktualisiere die Zeile: `Optimized = YES`, `OptimizedAt`, `WorkingNow = NO`, `WorkingSince` leer, `VettaStatus = pending`, `VettaProposalUrl` = der Freigabelink, den `propose_version` zurückgibt.
9. Mach einen Commit und einen Push (Nachricht: `seo: <handle> in Vetta vorgeschlagen`) und hör dann auf.

Schlägt ein Schritt fehl (Inhalt nicht gefunden, Fehler des Connectors), setz `WorkingNow` zurück auf `NO`, lass `Optimized` auf `NO`, schreib den Fehler in `VettaStatus` und pushe die Datei. Geh nicht zu einer anderen Zeile über.

## Was optimiert wird (Anpassen)

- **SEO-Titel**: 50 bis 60 Zeichen, Haupt-Keyword am Anfang, Markenname am Ende, wenn der Platz reicht.
- **Meta-Beschreibung**: 140 bis 155 Zeichen, ein konkreter Nutzen und ein Anreiz zum Klicken.
- **Beschreibung**: mit Zwischenüberschriften gegliedert, kurze Absätze, das Haupt-Keyword in den ersten 100 Wörtern, ohne Keyword-Stuffing.
- **Handle**: nicht ändern, außer er ist unleserlich (zum Beispiel `kopie-von-produkt-2`). Dann schlag einen kurzen Handle in Kleinbuchstaben mit Bindestrichen vor.
- **Alt-Text der Bilder**: Beschreib in einem Satz, was das Bild zeigt.

## Schreibregeln (Anpassen)

- Sprache: Deutsch. Kunden werden gesiezt („Sie“).
- Tonalität: [beschreiben Sie die Tonalität Ihrer Marke, zum Beispiel „fachkundig, aber zugänglich, ohne Superlative“].
- Erfinde nie Eigenschaften, Materialien, Maße, Zertifizierungen oder Zahlen. Verwende nur, was bereits im Inhalt oder im Shop steht. Fehlt eine wichtige Information, weise in deinem Bericht darauf hin.
- Behalte bestehende interne Links bei.
- Vermeide leere Floskeln („höchste Qualität“, „ein Muss“, „entdecken Sie unsere Auswahl“).

## Bericht am Ende der Ausführung

Fasse zum Schluss in zwei oder drei Sätzen zusammen, was du geändert hast und warum, mit dem Freigabelink, und liste die Angaben auf, die du nicht überprüfen konntest. Diese Zusammenfassung erscheint im Verlauf der Routine.