Ghost API tool

If you run a Ghost site and you’re doing “content ops” (SEO fields, images, migrations), this tool is for you.

It talks to Ghost through the Admin API (posts, pages, tags, members, themes, etc.).

The point is simple: it gives you a safe loop for “agent-assisted content ops”: dry-run → review → apply → verify → receipt.

What you can do with it

• Audit content (find posts/pages, export, spot missing metadata).
• Patch pages/posts safely (SEO fields, feature images, some body edits).
• Manage tags safely (including bulk/cleanup flows with extra confirmation).

Why it’s safer than “raw API calls”

• No writes unless you pass --apply.
• Risky/destructive actions require extra confirmation (often --yes).
• After writes, it verifies what happened (read-back, and when it fits: re-run a dry-run and confirm it shows 0 changes).
• It saves backups on apply (so you can recover if something goes wrong).
• It redacts member emails by default (so logs don’t leak personal data).

Quickstart (the only 2 commands you need first)

• ghost-api-tool --version
• ghost-api-tool auth check

A normal workflow (how I recommend you use it)

1) Run the command without --apply (dry-run). 2) Read the plan like a checklist: “Is this the change I actually want?” 3) Re-run with --apply (and --yes if the tool asks for it). 4) Read the receipt and verify the result.

Status

• Release: v0.1.0
• Status label: Stable
• Verification date: shown in the Trust box at the top of the page.

Start here

If you’re new, start with the docs and the safety model first.