作るもの
このtutorialでは、Cursor Cloud Agentsを使ってSEO/GEO pull request reviewを行う方法を説明します。ただし、agentに完全な自律性は与えません。最初に役立つworkflowはcomment-onlyです。cloud agentはbranchまたはPRをreviewし、riskを特定し、あなたが特定のfindingを承認した後だけ小さなpatchを提案します。
作る構成は次のとおりです。
.cursor/
rules/
seo-geo-pr-review.mdc
seo-geo/
pr-review/
checklist.md
review-prompt.md
approved-fixes.md
metadata helpers、schema、robots rules、sitemap output、internal links、page templates、localization、analytics、大きなcontent batchに触るbranchで使います。
キャプション: Cloud Agentには最初からpatch権限を渡さず、finding、承認、限定修正の順に進めます。
Step 1: PR review ruleを作る
mkdir -p .cursor/rules seo-geo/pr-review
cat > .cursor/rules/seo-geo-pr-review.mdc <<'EOF2'
---
description: SEO/GEO pull request review policy
globs:
- "src/**"
- "app/**"
- "pages/**"
- "content/**"
- "public/robots.txt"
- "**/*sitemap*"
- "**/*schema*"
- "**/*seo*"
- "**/*metadata*"
alwaysApply: false
---
For SEO/GEO PR reviews:
- review before patching
- return findings first, ordered by severity
- include file references and verification steps
- do not commit changes unless specific findings are approved
- treat robots, noindex, sitemap, canonical, redirects, schema, analytics, localization, and shared templates as high risk
- do not invent proof, customer names, rankings, statistics, or claims
- do not publish, deploy, submit URLs, or change secrets
EOF2
Cursor planがUI経由でrulesを保存する場合は、これをproject ruleとして貼り付けます。
Step 2: review checklistを作る
cat > seo-geo/pr-review/checklist.md <<'EOF2'
# SEO/GEO PR Review Checklist
Review these risks:
- title, meta description, canonical, Open Graph
- robots, noindex, sitemap, redirects, route changes
- schema / JSON-LD validity and unsupported claims
- internal links, breadcrumbs, navigation
- localization, hreflang, locale canonicals
- template changes affecting many URLs
- content that is too generic for AI answer extraction
- analytics / GTM / GA4 changes
- build, lint, tests, preview, crawl validation
Severity:
- Critical: can block crawling/indexing or break many pages
- High: likely SEO/GEO regression before merge
- Medium: should fix soon
- Low: cleanup or small quality issue
- Note: optional improvement
EOF2
Step 3: cloud-agent review promptを書く
cat > seo-geo/pr-review/review-prompt.md <<'EOF2'
Review this branch or pull request for SEO/GEO risk.
Use `.cursor/rules/seo-geo-pr-review.mdc` and `seo-geo/pr-review/checklist.md`.
Do not commit changes. Return findings only.
For each finding include:
- severity
- file reference
- exact risk
- why it matters for SEO/GEO
- how to verify
- whether a patch is safe or needs human approval
If there are no findings, say that explicitly and list residual testing gaps.
EOF2
Step 4: 最初のcloud reviewを実行する
CursorでbranchまたはPR上にCloud Agentを開始し、次を貼ります。
Use `seo-geo/pr-review/review-prompt.md`.
Review this branch for SEO/GEO risk.
Do not commit changes and do not create a patch.
Return findings only, ordered by severity.
良いfindingは具体的です。
High - `src/lib/seo.ts`: canonical generation now strips locale prefixes. This may cause localized pages to canonicalize to English URLs. Verify rendered canonical and hreflang on one English page and one translated page before merge. Patch safety: requires human approval.
弱いfindingは曖昧です。
Improve SEO metadata.
reviewが曖昧なら、review-prompt.mdに良い例と悪い例を追加し、再実行します。
Step 5: 選んだ修正だけを承認する
approved fixes fileを作ります。
cat > seo-geo/pr-review/approved-fixes.md <<'EOF2'
# Approved Fixes
Approved:
- Finding M1: duplicate meta description on `/features/reporting`
Not approved:
- canonical policy changes
- robots/noindex changes
- redirects
- analytics changes
- schema helper rewrites
- broad content rewrites
EOF2
次にcloud agentへ依頼します。
Apply fixes only for items listed in `seo-geo/pr-review/approved-fixes.md`.
Do not touch unrelated files.
Do not change canonicals, robots, redirects, analytics, schema helpers, or shared templates.
Run available validation and return changed files, commands run, and remaining risks.
これにより、review agentが制御不能なeditorになるのを防げます。
Step 6: merge前にpatchを確認する
agentがpatchを提案または適用した後、確認します。
git diff --name-only
git diff --stat
次のように依頼します。
Compare the changed files against `seo-geo/pr-review/approved-fixes.md`.
List any file that was changed without approval. Do not make more edits.
未承認fileが変更されていたら、止めて手動reviewします。
Step 7: severity modelを一貫して使う
| Severity | Example | Merge decision |
|---|---|---|
| Critical | important pages become noindex | mergeをblockする |
| High | canonicals point to wrong locale | merge前に修正する |
| Medium | duplicate meta descriptions | 修正またはticket化する |
| Low | missing alt text | batch cleanupに回す |
| Note | internal link opportunity | optional |
Cloud agentsが役立つのは、reviewを一貫させるときです。すべてのfindingを同じ重要度で扱い始めると危険です。
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| Agentがすぐcommitする | promptにfindings onlyと書いていない | ruleとpromptに「Do not commit changes」を追加する |
| findingsがgeneric | checklistにexamplesがない | good/bad finding examplesを追加する |
| patchが広すぎる | approved fixes fileが曖昧 | finding IDsとexact filesを承認する |
| Agentがsecretsを求める | taskにanalytics/CMS actionsが含まれている | sanitized exportsまたはcode-only reviewを提供する |
| human reviewerが検証できない | validation stepsがない | findingごとにverificationを必須にする |
FAQ
すべてのPRにCursor SEO/GEO reviewをかけるべきですか?
いいえ。metadata、schema、routes、templates、content、robots、sitemap、localization、analyticsなどSEO-critical pathsに使います。
Cursor Cloud Agentsはtechnical SEO reviewを置き換えますか?
いいえ。反復的なdiff riskを捕まえるものです。strategy、claims、migrations、release timingは人間が承認します。
最も安全な最初のtestは何ですか?
page titleとmeta descriptionを1つずつ変更する小さなPRを開きます。reviewだけを依頼し、人間のreviewと結果を比較します。
AI coding agents for SEO/GEO 学習パス
Cursor track:
- Cursor vs Windsurf vs Gemini CLI:SEO/GEO自動化の選び方
- Cursor RulesでSEO/GEO作業環境を作る方法
- Cursor Plan ModeでSEOページを安全に更新する方法
- MCPでCursorをSEOデータに接続する方法
- Cursor Cloud AgentsでSEO/GEO PRレビューを行う方法
- Cursor、Windsurf、Gemini CLI、Codex、Claude CodeのSEO/GEO運用モデル
Sources and notes
- Cursor documentation hub: Cursor Docs 。Agent、Rules、MCP、Skills、CLI、background/agent capabilitiesのpublic documentationを含みます。
- Related Auspia guide: Cursor vs Windsurf vs Gemini CLI for SEO/GEO Automation 。
Author: Tessa Clarke, Auspiaで120以上のeditorial systemsを支援するContent Governance Lead。Tessaはreview systems、publishing standards、安全なAI-assisted content operationsについて執筆しています。