Feed core — overview

@ghostwritr/feed is the keyless, framework-free core that the Next, Astro, and React Router adapters are built on. It fetches your published articles from the content feed and gives you typed Article objects. No API key — the siteId is the read capability. See keyless reads.

Who it’s for

Reach for the core directly when there isn’t an adapter for your stack, or when you want the fetchers with no framework caching wrapped around them.

• Any JS/TS runtime with fetch + Web Crypto — Node 20+, Cloudflare Workers, Deno, Bun, and the browser.
• Zero dependencies. Nothing to audit, nothing to bundle but the core itself.
• The adapters re-export it. @ghostwritr/next and @ghostwritr/astro re-export its types and wrap its fetchers with framework caching, so the shapes you learn here are the shapes you get everywhere.

30-second fetch

1. Install the core.

   npm

   npm install @ghostwritr/feed

   pnpm

   pnpm add @ghostwritr/feed

   yarn

   yarn add @ghostwritr/feed

   bun

   bun add @ghostwritr/feed

2. Fetch your articles with your site ID. That’s the only key.

   feed.ts

   import { fetchArticles, fetchArticle } from "@ghostwritr/feed";
   
   // Every published article, newest first.
   const articles = await fetchArticles({ siteId: process.env.GHOSTWRITR_SITE_ID! });
   
   // One article by slug, or null.
   const post = await fetchArticle({
     siteId: process.env.GHOSTWRITR_SITE_ID!,
     slug: "my-first-post",
   });

3. Render the Markdown. In React, hand article.markdown to <ArticleContent>; anywhere else, use your own Markdown renderer.

Fails closed

A site with no feed yet throws a GhostwritrError with code NOT_FOUND — there is no authed fallback. A site with an empty feed returns []. See error handling.

⚡ 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>.
Fetch my published articles and render them, listing the newest first and resolving a single article by slug using the @ghostwritr/feed SDK in this plain TypeScript app.
It's keyless — the site ID is the only key, there is no API key.

What to reach for next

• The fetchers — fetchArticles, fetchArticle, toArticle, and the opts.fetch seam. See Fetchers.
• Instant updates — verify the signed feed.updated webhook. See Webhook helpers and instant updates.
• Errors — the GhostwritrError code union and the fail-closed contract. See Error handling.
• Full surface — every export, typed. See API reference.