Claude Code & Cursor SEO that ranks.
Sites built with Claude Code or Cursor rank when they send crawlers real HTML. One prompt adds a server-rendered blog that GrandRanker fills every day.
14-day money-back guarantee
Set up a blog in this app that receives articles from an external service. Do ALL of the following:
1. Create a database table named "articles" using this app's existing database and ORM, with columns: external_id (text, unique, not null), title (text), slug (text, unique), content_html (text), content_markdown (text), meta_title (text), meta_description (text), subtitle (text), category (text), author_name (text), image_url (text), read_time (text), word_count (integer), tags (json), faqs (json), json_ld_schema (json), language_code (text), published_at (timestamp), updated_at (timestamp, default now).
2. Add an app secret named GRANDRANKER_SECRET (a shared webhook key) with this value: <your secret from GrandRanker>
If you cannot set the secret value yourself, ask me for it and I will paste it. Never hardcode the value in the code — always read it from the environment.
3. Create a POST endpoint at "/api/articles-webhook" on this app's server. The endpoint must:
- Accept JSON request bodies up to 10 MB (articles contain full HTML — the default body size limit is too small).
- Return HTTP 401 if the "X-API-Key" request header does not equal the GRANDRANKER_SECRET environment variable.
- Respond HTTP 200 to GET and HEAD requests (health check).
- On POST: parse the JSON body. If "event_type" is "publish_articles", upsert every item in data.articles into the "articles" table keyed on external_id. Build each row using ONLY these columns and IGNORE any other field in the payload (the payload contains extra fields the table does not have, such as author_initials and hreflang_tags — do not try to write them): external_id (from the item's "id"), title, slug, content_html, content_markdown, meta_title, meta_description, subtitle, category, author_name, image_url, read_time, word_count, tags, faqs, json_ld_schema, language_code, published_at (from "publish_date"), updated_at. If "event_type" is "unpublish_article", delete the row where external_id equals data.id. Return HTTP 200 on success.
4. Build a "/blog" page listing articles from the "articles" table (newest first), and a "/blog/:slug" page that renders one article's content_html, using meta_title and meta_description for SEO tags. On the article page, also output: a <link rel="canonical"> tag with the page's full URL, og:title / og:description / og:image / og:url meta tags, and — if json_ld_schema is present — a <script type="application/ld+json"> tag in the page <head>. Both pages must be readable by search engine and AI crawlers — serve the article content and meta tags in the initial HTML response (server-side), not only after client-side JavaScript runs. Requests for a slug that does not exist in the "articles" table must return HTTP status 404, not a 200 page.
5. Serve a real "/sitemap.xml" route that returns XML (Content-Type application/xml) listing the /blog page and every article's /blog/:slug URL with its updated_at as lastmod, generated from the "articles" table on each request. Make sure robots.txt allows crawling and points to the sitemap. The sitemap must NOT be swallowed by a catch-all route that returns the app's HTML.
After you finish, confirm the webhook is reachable at /api/articles-webhook.In GrandRanker, open Integrations, then AI Agent. The prompt there has your real secret in it.
The stack your agent picks decides what Google sees
Claude Code and Cursor write normal code. These are the three stacks they pick most for a website.
- Vite + React single-page app
- What a crawler getsAn empty root element until JavaScript runs
- SEOGoogle renders it later; AI crawlers and SEO tools see nothing
- Next.js
- What a crawler getsFull HTML for each page, rendered on the server or at build time
- SEOGood, if pages are not client-only
- Astro
- What a crawler getsStatic HTML for each page, built ahead of time
- SEOGood by default
| Stack | What a crawler gets | SEO |
|---|---|---|
| Vite + React single-page app | An empty root element until JavaScript runs | Google renders it later; AI crawlers and SEO tools see nothing |
| Next.js | Full HTML for each page, rendered on the server or at build time | Good, if pages are not client-only |
| Astro | Static HTML for each page, built ahead of time | Good by default |
Where agent-built sites lose SEO
The code works. These three things are easy for an agent to skip.
A single-page app by default.
Ask for "a website" and many agents scaffold Vite + React. The first HTML is empty, and Google has to run JavaScript to see your text.
- Fast to build
- Content in the first HTML
- Readable by AI crawlers
No sitemap, one title.
Agents rarely add a sitemap.xml or a unique title per route unless you ask. A catch-all route can even return the app page for /sitemap.xml.
- robots.txt
- Real /sitemap.xml
- Unique title per page
No content to rank.
Your agent builds the product, not 100 articles about the questions buyers search. Without them, you rank for your brand name only.
- Home page
- Pricing
- Answers to buyer questions
How to add a blog with one prompt
Your agent builds the blog in your own app. GrandRanker writes and publishes the articles.
Copy the prompt
In GrandRanker, open Integrations, then AI Agent, and copy the prompt. It holds your secret webhook key.
Paste it into your agent
Claude Code or Cursor adds an articles table, a webhook, server-rendered /blog pages and a real sitemap.xml.
Deploy and connect
Deploy your site, paste the webhook URL into GrandRanker, then click Test Connection and Save & Connect.
Watch rankings grow
Most sites see first rankings in 4 to 8 weeks. Track every keyword and AI mention in one place.
Be the Claude Code app ChatGPT names.When buyers ask what to use.
AI answers cite pages they can read. Your blog articles are plain HTML, so ChatGPT, Perplexity and Google can quote them.
Trusted by top performers
setup was easy and the articles are actually good?? did not expect that

Dec 4, 2025
we tried everything before this. nothing came close

Dec 2, 2025
the fact that it also writes AND publishes? yeah that's just unfair

Nov 14, 2025
better results. fraction of the cost. only regret is not switching earlier

Dec 28, 2025
connected my blog, setup took 15 min, now getting organic traffic i never had. wild

Jan 3, 2026
47 articles in a month, 12 already on page 1
the keyword research alone saves me hours every week

Nov 30, 2025
these aren't generic AI articles. they match my brand tone perfectly. actually impressed

Dec 10, 2025
but @grandranker articles actually read well. my audience hasn't noticed at all
Nov 5, 2025
@grandranker published 60 articles month one. already at 200+ daily visitors from google
Jan 12, 2026
Questions, answered
Short answers, with sources below.
Is a site built with Claude Code good for SEO?
It can be. Claude Code writes the code you ask for, so SEO depends on the stack and the content. Ask for server-rendered or static pages, a sitemap.xml and unique titles, then add articles that answer what buyers search.
Does Cursor do SEO?
Cursor is a coding agent, not a website host, so it has no SEO settings. The site it builds ranks when its pages send real HTML and have content. Paste our prompt into Cursor to add a server-rendered blog.
Which stack should I ask my agent for?
For a marketing site or blog, ask for Next.js with server rendering or Astro. Both send full HTML to crawlers. A Vite + React single-page app is fine for the app itself, but keep content pages off it.
What does the prompt build?
An articles table, a webhook at /api/articles-webhook that checks your secret, /blog and /blog/:slug pages rendered on the server with canonical and Open Graph tags, and a real /sitemap.xml. GrandRanker then sends each new article to the webhook.
Do I need to write the articles?
No. GrandRanker finds the searches your buyers make, writes the articles and publishes them to your blog through the webhook. You can edit any article before it goes live.
Can I skip the code and use a hosted blog?
Yes. Point blog.yourapp.com at a GrandRanker hosted blog with one DNS record. Nothing changes in your code, and the blog has its own sitemap.

