Postmancer Help

Everything you need to get started and make the most of Postmancer.

Getting started

Requirements

  • Google Chrome (desktop)
  • A Ghost site — self-hosted or Ghost(Pro)
  • A Ghost Admin API key

Installation

  1. Install Postmancer from the Chrome Web Store
  2. Click the Postmancer icon in your Chrome toolbar
  3. Enter your Ghost site URL and Admin API key
  4. Click Connect

The Postmancer sidebar will appear inside Ghost Admin immediately.

Getting your Ghost Admin API key

  1. Open Ghost Admin
  2. Go to Settings → Integrations
  3. Click Add custom integration
  4. Give it a name (e.g. Postmancer)
  5. Copy the Admin API key
  6. Paste it into the Postmancer popup

Ghost(Pro) users: use your .ghost.io admin URL when connecting, not your custom domain. Your admin URL looks like https://yoursite.ghost.io/ghost.

Your API key is private

Your Ghost API key is stored locally in your browser using Chrome's secure storage. It is never sent to Postmancer's servers.


AI Traffic Insights

What it does

AI chatbots like ChatGPT, Perplexity, and Gemini regularly recommend your site in conversations — but often link to pages that don't exist. Readers click, hit a dead end, and leave. Postmancer tracks every one of those visits and shows you which AI sent them, which URL they were looking for, and how many times it happened.

Setting up the beacon

The beacon is a lightweight snippet you add to your Ghost site once. It watches silently for visitors arriving at pages that don't exist.

  1. Open Ghost Admin → Postmancer → AI Traffic Insights
  2. Click Copy snippet
  3. Open Ghost Admin → Settings → Code Injection
  4. Paste the snippet into the Site Footer field
  5. Click Save

The beacon is now live. Hits will start appearing in the panel as they occur.

Reading the panel

Each entry shows:

  • URL — the path that was linked to but doesn't exist on your site
  • Source — which AI tool sent the visitor (ChatGPT, Perplexity, Gemini, Claude, Copilot, or direct)
  • Hits — how many times this URL has been visited
  • First seen / Last seen — when the URL was first and last recorded

Taking action

For each entry you can:

  • Write post — opens Ghostwriter with the URL slug pre-filled as a topic
  • Add redirect — opens Redirect Manager to point the dead URL to an existing page
  • Dismiss — marks the entry as handled and removes it from the active list

Why some entries show as "direct"

When a visitor arrives from a new browser tab with no referrer — which is common when someone copies a URL from a ChatGPT conversation and opens it manually — the source shows as direct. This is expected and still represents AI-referred traffic.


Ghostwriter

What it does

Ghostwriter generates full blog posts inside Ghost Admin. You provide a brief, it builds an outline, writes every section, and places a formatted draft directly into Ghost's editor.

Three writing modes

Write — generate from a brief you provide From video — paste a YouTube URL and Ghostwriter transcribes and writes an article from it From article — paste any publicly accessible article URL and Ghostwriter writes an original piece based on it

Writing from a brief

Fill in the brief form:

FieldDescription
TopicWhat the article should be about
Article typeBlog post, how-to guide, listicle, opinion, case study, comparison
Word count500 to 4,000 words
KeywordPrimary SEO keyword
AudienceWho the article is for
ToneProfessional, conversational, technical, authoritative, friendly, witty
Context & key factsData or specific points to include
Brand voiceDescribe your style or paste an example paragraph

You can also configure:

  • GEO & AI citability — structural options like FAQ sections, key takeaways, question headings, statistics, comparison tables, and anti-AI style settings
  • Citations — enable inline citations with configurable source tier and density
  • Images — feature image and in-body galleries sourced from Pixabay

Click Generate to begin.

Writing from a YouTube video

  1. Select the From video tab
  2. Paste a YouTube URL
  3. Configure article type, word count, keyword, and tone
  4. Optionally add a focus hint to target a specific part of the video
  5. Click Fetch & generate

Ghostwriter transcribes the video and writes an original article from it. It does not transcribe the video verbatim — it extracts insights and restructures them for reading.

Writing from an article

  1. Select the From article tab
  2. Paste any publicly accessible article URL
  3. Configure article type, word count, keyword, and tone
  4. Optionally add a custom title
  5. Click Fetch & generate

Works best with publicly accessible articles. Paywalled or login-gated content may not be readable.

Reviewing and refining

After generation you reach the review screen:

  • Left pane — full article preview with editable title
  • Right pane — refinement tools and internal link suggestions

To refine: describe the changes you want in the Refine field and click Apply refinements. You can refine as many times as you need.

Internal link suggestions are generated automatically. Each suggestion shows the recommended anchor text and the post to link to. Apply individually or use Apply all high-confidence to insert all strong matches at once.

Publishing to Ghost

Click Proceed to publish to reach the publish screen:

  • Set the article title
  • Choose status: Draft or Published
  • Add tags
  • Confirm or change the feature image
  • Generate or edit the meta description

Click Create post in Ghost. The post is created in your Ghost site and opens in the Ghost editor.

Credit cost

Each Ghostwriter run costs 10 AI credits.


Narrate

What it does

Narrate converts any Ghost post into an audio file using ElevenLabs' multilingual text-to-speech models. The audio player is embedded directly into your Ghost post.

Generating audio

  1. Open any post in the Ghost editor
  2. The Narrate panel appears in the post settings sidebar on the right
  3. Select a voice from the dropdown
  4. Click Generate audio

Narrate reads your entire post, converts it to speech, uploads the audio file, and embeds a player in the post. Refresh the page to see the player in the editor.

Voices

Voices are sourced from ElevenLabs and include a range of premade and professional options. Select the voice that best matches your content and audience before generating.

Language detection

Narrate automatically detects the language of your post content and narrates in that language. No configuration required.

Replacing or removing audio

If a post already has audio embedded, the panel shows an Audio embedded indicator. To remove the audio, click the trash icon. To replace it, remove the existing audio first, then generate again with a different voice.

Credit cost

Each Narrate run costs 15 AI credits.


Content Manager

What it does

Content Manager gives you a faster, more powerful interface for browsing and managing all your Ghost posts and pages.

Searching and filtering

  • Search — type to filter by title. Enable Search in content to also search inside post body text (slower)
  • Posts / Pages — toggle between posts and pages
  • Status — filter by All, Published, Drafts, or Scheduled
  • Tag — filter by any tag on your site
  • Author — filter by any author on your site
  • Sort — Newest first, Oldest first, Title A–Z, Title Z–A, Recently updated

Bulk actions

Select multiple posts using the checkboxes, then use the bulk action bar to:

  • Status — change to Published, Draft, or Scheduled
  • Visibility — change to Public, Members only, or Paid members only
  • Add tag — add a tag to all selected posts
  • Author — reassign to a different author
  • Delete — permanently delete selected posts

Exporting content

Click the export button in the toolbar to export:

  • CSV — exports all posts matching your current filters as a spreadsheet
  • HTML — exports selected posts as HTML files
  • Lexical JSON — exports selected posts as Ghost's native Lexical JSON format

Importing content

Use the same export menu to import:

  • HTML — imports an HTML file as a new Ghost post
  • Markdown — imports a Markdown file as a new Ghost post
  • Lexical JSON — imports a Lexical JSON file as a new Ghost post

Redirect Manager

What it does

Redirect Manager lets you create and manage Ghost URL redirects without editing JSON files or using the Ghost CLI.

Creating a redirect

  1. Open Postmancer → Redirect Manager
  2. Enter the From path (the old URL, e.g. /old-post-slug)
  3. Enter the To path (the destination, e.g. /new-post-slug)
  4. Click Add redirect

Managing existing redirects

All current redirects are listed in the panel. To delete a redirect, click the delete icon next to it.

Notes

  • Redirects apply to your entire Ghost site
  • Both paths should start with a forward slash
  • Redirects are applied immediately after saving

Find & Replace

What it does

Find & Replace lets you search for text across your entire Ghost post archive and replace it in bulk.

Using Find & Replace

  1. Open Postmancer → Find & Replace
  2. Enter the text to find
  3. Enter the replacement text
  4. Choose whether to search posts, pages, or both
  5. Click Find to preview matches
  6. Review the results and click Replace to apply

Notes

  • Changes are applied directly to your Ghost posts via the Admin API
  • Always review matches before replacing
  • Find & Replace works on post body content, not titles or metadata

Mermaid Diagrams

What it does

Mermaid Diagrams lets you write Mermaid syntax and preview rendered diagrams inside Ghost Admin, then insert them into your posts.

Supported diagram types

  • Flowcharts
  • Sequence diagrams
  • Entity relationship diagrams
  • Gantt charts
  • Class diagrams
  • State diagrams
  • And more — anything supported by Mermaid

Creating a diagram

  1. Open Postmancer → Mermaid Diagrams
  2. Write your Mermaid syntax in the editor
  3. The diagram renders in the preview pane automatically
  4. Click Insert to add the diagram to your current post

Math & Formula Renderer

What it does

Math & Formula Renderer lets you write LaTeX expressions and render them inside Ghost posts.

Using the renderer

  1. Open Postmancer → Math & Formulas
  2. Enter your LaTeX expression
  3. Preview the rendered formula
  4. Insert it into your post

Lorem Ipsum Generator

What it does

Lorem Ipsum Generator creates realistic placeholder posts in your Ghost site — useful for testing themes, layouts, and designs with realistic content and real photos.

Generating posts

Configure:

  • Posts — how many posts to generate (1–50)
  • Topic — Mixed, Technology, Travel, Food, Business, Health, Science, Design, or Nature
  • Status — Draft or Published
  • Tag — a tag applied to all generated posts (default: lorem-ipsum)
  • Post length — Short, Medium, or Long

Feature images

Enable feature images to automatically fetch photos from Pixabay and upload them to your Ghost media library. Each post gets its own photo. Configure:

  • Search query — or enable Auto to match the post topic automatically
  • Orientation — Landscape, Portrait, or Square
  • Color filter — Any color, or a specific color

Image galleries

Enable in-body galleries to insert a Pixabay photo gallery inside each post. Configure the number of images per gallery (2–6) and the number of columns.

Cleaning up

Generated posts are tagged automatically (default: lorem-ipsum). Use Content Manager to filter by that tag and delete all lorem ipsum posts when you're done testing.


Settings

Sidebar tools

Choose which tools appear in the Ghost Admin sidebar. Toggle any tool on or off. Settings is always visible. Changes take effect immediately.

Plan and billing

View your current plan, AI credit usage, and billing reset date. Upgrade to Pro or manage your existing subscription from this panel.

Connecting a different site

To connect a different Ghost site, click the Postmancer icon in your Chrome toolbar, clear the current URL and API key, and enter the new site details.


Plans and credits

Free plan

  • 20 AI credits per month
  • All tools unlimited
  • No credit card required

Pro plan — $9/month

  • 200 AI credits per month
  • All tools unlimited
  • Priority support

Credit costs

ActionCredits
Ghostwriter10 credits per run
Narrate15 credits per run
All other toolsFree — no credits

Credits reset monthly on your billing date and are shared across Ghostwriter and Narrate. Non-AI tools have no credit cost and no usage limit.


Troubleshooting

The Postmancer sidebar is not appearing

  • Make sure you are on a Ghost Admin page (the URL should contain /ghost/)
  • Check that the relevant tool is enabled in Postmancer Settings → Sidebar tools
  • Try refreshing the Ghost Admin page
  • Reload the extension from chrome://extensions

Connection failed — invalid API key

  • Double-check your Admin API key in Ghost Admin → Settings → Integrations
  • Ghost(Pro) users: make sure you are using your .ghost.io admin URL, not your custom domain
  • Make sure the URL includes https:// and does not have a trailing slash

The beacon is installed but no hits are appearing

  • Confirm the snippet is pasted into Settings → Code Injection → Site Footer (not header)
  • Visit a URL on your site that does not exist to test
  • Open browser DevTools on the 404 page, go to the Network tab, and look for a POST request to supabase.co/functions/v1/track-404
  • Check that your Ghost theme's 404 page loads — some configurations redirect 404s before the page renders

Ghostwriter returned an error

  • Check your remaining AI credits in Settings → Plan
  • Try reducing the word count or simplifying the brief
  • If the error persists, try again — Gemini occasionally times out on long generations

Narrate returned an error

  • Check your remaining AI credits in Settings → Plan
  • Very long posts may occasionally time out — try generating audio for a shorter post first
  • Make sure the post has body content before generating

Audio is not showing in the Ghost editor

  • After generating audio, refresh the Ghost editor page
  • The audio player is embedded as a post content block — it appears in the editor after a page refresh

Privacy

  • Your Ghost API key is stored locally in your browser and never sent to Postmancer's servers
  • Postmancer only activates on Ghost Admin pages
  • The AI Traffic beacon records anonymous 404 URL hits only — no cookies, no visitor tracking, no personal data from your readers
  • Post content sent to Ghostwriter and Narrate is used only to generate your requested output and is not stored or used for training

Contact and support

For questions, bug reports, or feature requests, contact us at support@postmancer.com.

Pro plan users receive priority support with faster response times.


Postmancer is independent of and not affiliated with, authorised, sponsored, or approved by Ghost Foundation.

Cookie Settings
This website uses cookies

Cookie Settings

We use cookies to improve user experience. Choose what cookie categories you allow us to use. You can read more about our Cookie Policy by clicking on Cookie Policy below.

These cookies enable strictly necessary cookies for security, language support and verification of identity. These cookies can’t be disabled.

These cookies collect data to remember choices users make to improve and give a better user experience. Disabling can cause some parts of the site to not work properly.

These cookies help us to understand how visitors interact with our website, help us measure and analyze traffic to improve our service.

These cookies help us to better deliver marketing content and customized ads.