using-ghost-admin-api

houfu/using-ghost-admin-api

Writing

About

SKILL.md

Using Ghost Admin API

Most Ghost operations use the ghst MCP tools directly. Use this skill to route to the one custom script still needed (publish-lexical.js for markdown → lexical with bookmark cards, GitHub footer, table conversion).

Decision tree

Post a draft from markdown → creating_a_draft.md (uses publish-lexical.js)
Sync Ghost post metadata back to local markdown (CHECK phase) → npm run sync-ghost <slug>
Backlink curation → use the backlink_curating skill
Everything else (read/query/update/stats) → MCP tools below

MCP tools quick reference

Operation	MCP Tool	Notes
Search posts	`ghost_search`	Full-text across posts, pages, tags
List posts	`ghost_post_list`	Supports filter, status, limit
Get post	`ghost_post_get`	By `slug` or `id`
Create / update / delete	`ghost_post_create` / `ghost_post_update` / `ghost_post_delete`	Delete needs `confirm: true`
Publish / schedule	`ghost_post_publish` / `ghost_post_schedule`	Schedule takes `at` datetime
Tags	`ghost_tag_list` / `_create` / `_update` / `_delete`
Image upload	`ghost_image_upload`	Local file path
Site / settings	`ghost_site_info` / `ghost_setting_list` / `ghost_setting_get`
Stats	`ghost_stats_overview` / `_post` / `_web` / `_growth` / `_email`
Members, pages, newsletters	`ghost_member_list` / `ghost_page_list` / `ghost_newsletter_list`

Reference

/docs/ghost-lexical-format.md — comprehensive lexical format reference. Consult when constructing complex lexical structures for publish-lexical.js.
scripts/ghost-lexical-single.js — reference documentation only (a LexicalBuilder API illustration). Do NOT require it or write per-post publishing scripts; scripts/publish-lexical.js at the repo root is the only canonical publishing path.

Reminders

Announce that you're using this skill.
MCP tools handle auth via the ghst CLI; no manual JWT needed.
Ghost docs are sparse — report any surprises so we can improve these instructions.