Astro — quickstart

@ghostwritr/astro is a keyless Content Layer loader for Astro 5+. It syncs your published articles into a collection at build time — then you render them with the normal getCollection / render / <Content /> flow.

1. Install the loader.

   npm

   npm install @ghostwritr/astro

   pnpm

   pnpm add @ghostwritr/astro

   yarn

   yarn add @ghostwritr/astro

   bun

   bun add @ghostwritr/astro

2. Add your site ID to .env. It’s the only key you need — see Your site ID.

   .env

   GHOSTWRITR_SITE_ID=your-site-id

3. Define the collection. Pass ghostwritr({ siteId }) as the loader. The loader ships a default schema covering the full article — author, tags, language, canonical, timestamps — so you don’t redefine it:

   src/content.config.ts

   import { defineCollection } from "astro:content";
   import { ghostwritr } from "@ghostwritr/astro";
   
   export const collections = {
     articles: defineCollection({
       loader: ghostwritr({ siteId: import.meta.env.GHOSTWRITR_SITE_ID }),
     }),
   };

4. Render an article page. The entry id is the slug, so it’s your route param. render(p) hands back <Content /> from the pre-compiled body:

   src/pages/blog/[slug].astro

   ---
   import { getCollection, render } from "astro:content";
   
   export const getStaticPaths = async () =>
     (await getCollection("articles")).map((p) => ({
       params: { slug: p.id },
       props: { p },
     }));
   
   const { p } = Astro.props;
   const { Content } = await render(p);
   const { title, seoTitle, seoDescription, author, publishedAt } = p.data;
   ---
   <title>{seoTitle}</title>
   <meta name="description" content={seoDescription ?? ""} />
   <article>
     <h1>{title}</h1>
     <p>By {author.name} · {publishedAt.toLocaleDateString()}</p>
     <Content />
   </article>

5. Render the index, newest first. The loader stores articles newest-first, so iterate the collection as-is:

   src/pages/blog/index.astro

   ---
   import { getCollection } from "astro:content";
   const posts = await getCollection("articles");
   ---
   <ul>
     {posts.map((p) => (
       <li><a href={`/blog/${p.id}`}>{p.data.title}</a></li>
     ))}
   </ul>

That’s a complete, statically-generated blog reading from the keyless feed. Run astro dev and open /blog.

Where the fields live

The entry id is the slug. entry.data.ghostwritrId is the Ghost Writr article id (for round-tripping). The three timestamps — publishedAt, createdAt, updatedAt — are Date objects on entry.data. The Markdown is not on entry.data: the raw body is entry.body, the compiled body is entry.rendered, and render(entry) is what gives you <Content />.

⚡ Hand this to your AI agent

Paste this into Claude Code, Cursor, or any coding agent — it has everything it needs to wire up the SDK (swap in your real site ID):

Read https://developer.ghostwritr.io/llms-full.txt.
My Ghost Writr site ID is <YOUR_SITE_ID>.
Define an articles content collection with the ghostwritr loader, then add a /blog index and /blog/[slug] pages that render the article body with the Content component and set head tags from entry.data using the @ghostwritr/astro SDK in this Astro app.
It's keyless — the site ID is the only key, there is no API key.

What to reach for next

• Collection schema — the default entry.data fields, and how your own schema overrides them. See Collection schema.
• Publish without a manual rebuild — wire a deploy hook to the feed.updated webhook. See Redeploy on publish and Instant updates.
• SEO — drive head tags and JSON-LD from the article fields. See SEO & JSON-LD.