Getting Started SEO Tools Publishing Images Content Social Analytics Account

v0.9.0

Pipepost Docs

Everything you need to install, configure, and use Pipepost with Claude Code. One command to set up, natural language to use.

Installation

Run this in your terminal. It automatically installs the Pipepost MCP server, configures Claude Code to use it, and creates your local config file.

Manual setup: If you prefer, add pipepost-mcp to your Claude Code MCP server config in ~/.claude/settings.json under the mcpServers key.

Quick start

Once installed, use Pipepost tools through natural language in Claude Code. Here's the typical workflow:

1Connect a platform

"Set up my Dev.to API key: dv1_abc123..."

2Score your content

"Score this article for SEO targeting 'MCP servers'"

3Optimize metadata

"Generate meta tags and JSON-LD for this article"

4Publish

"Publish this to Dev.to as a draft with tags: node, cli"

Configuration

Your API keys and license are stored locally in ~/.pipepost/config.json. They never leave your machine. Pipepost runs as a local stdio process — no cloud server, no telemetry.

~/.pipepost/config.json

{

"platforms": {

"devto": { "api_key": "dv1_..." }

"credits": { "balance": 27, "free_credits": 3 }

}

SEO Tools

Analyze, score, and optimize your content for search engines.

seo_scorefree

SEO Score

Analyze your content for SEO quality. Returns a composite 0–100 score based on readability (sentence length, passive voice, paragraph density), keyword usage (density, placement in headings), heading structure (hierarchy, count), and word count. Basic scoring is free; full analysis with issues and suggestions requires credits.

Parameter	Type	Required	Description
`content`	string	Yes	The markdown content to analyze
`keyword`	string	Yes	Target keyword to check density for

claude code

you: "Score my article about building MCP servers for SEO"

✓ SEO Score: 84/100 — Readability: Grade 8, Keywords: 2.1%, Headings: clean hierarchy

seo_metacredits

SEO Meta Tags

Generate optimized meta titles, descriptions, and Open Graph tags for your content. Follows Google’s recommended character limits (title ≤60 chars, description ≤155 chars). Returns ready-to-use HTML meta tags. Requires credits.

Parameter	Type	Required	Description
`content`	string	Yes	The content to generate meta tags for
`keyword`	string	Yes	Target keyword for optimization

claude code

you: "Generate meta tags for this article targeting 'node cli tools'"

✓ Meta title (54ch), description (148ch), OG title, OG description, OG type

seo_schemacredits

JSON-LD Schema

Generate structured data markup (JSON-LD) for your content. Supports Article, HowTo, FAQPage, and SoftwareApplication schemas. Output is a complete JSON-LD script tag ready to embed. Requires credits.

Parameter	Type	Required	Description
`content`	string	Yes	The content to generate schema for
`type`	string	Yes	Schema type: article, howto, faq, or software

claude code

you: "Generate Article JSON-LD schema for this blog post"

✓ Complete JSON-LD script tag ready to embed in your page

index_nowfree

IndexNow

Submit URLs to search engines for instant indexing via the IndexNow protocol. Notifies both IndexNow and Bing simultaneously. Generates and caches a verification key automatically on first use.

Parameter	Type	Required	Description
`url`	string	Yes	Primary URL to submit for indexing
`urls`	string[]	No	Batch of additional URLs (max 10)

claude code

you: "Submit my new blog post URL to search engines for indexing"

✓ Submitted 1 URL to IndexNow + Bing — typically crawled within 24-48h

Publishing

Publish and manage content across platforms.

publishcredits

Publish

Publish your content to Dev.to, Ghost, Hashnode, WordPress, Medium, or Substack. Costs 1 credit per publish. Supports drafts and published states, tags, canonical URLs, series grouping, and cover images. 3 free credits every month.

Parameter	Type	Required	Description
`content`	string	Yes	Markdown content to publish
`title`	string	Yes	Article title
`platform`	string	Yes	Target platform (devto, ghost, hashnode, wordpress, medium, substack)
`tags`	string[]	No	Up to 4 tags for the article
`status`	string	No	draft or published (default: draft)
`canonical_url`	string	No	Canonical URL if cross-posting
`series`	string	No	Series name to group articles

claude code

you: "Publish this article to Dev.to as a draft with tags: node, cli, javascript"

✓ Published to dev.to/you/article-slug — 1,247 words, 6 min read

cross_publishcredits

Cross-Publish

Publish to multiple CMS platforms in a single call — costs just 1 credit total regardless of how many platforms. Sends your article to every specified platform and returns a summary of successes and failures.

Parameter	Type	Required	Description
`platforms`	string[]	Yes	Platforms to publish to: devto, ghost, hashnode, wordpress, medium, substack
`title`	string	Yes	Article title
`content`	string	Yes	Markdown content to publish
`tags`	string[]	No	Tags for the article
`status`	string	No	draft or published (default: draft)

claude code

you: "Cross-publish this article to Dev.to, Ghost, and Hashnode as a draft"

✓ Published to 3/3 platforms — dev.to, ghost, hashnode

list_postsfree

List Posts

List your published and draft posts on a platform. Shows title, status, publish date, URL, and basic stats. Filter by status to find drafts or published articles.

Parameter	Type	Required	Description
`platform`	string	Yes	Platform to list posts from (devto, ghost, hashnode, wordpress, medium, substack)
`status`	string	No	Filter: all, published, or draft (default: all)

claude code

you: "Show me my draft posts on Dev.to"

✓ 3 drafts found — Building CLI Tools (Apr 12), MCP Guide (Apr 10), …

Images

Find cover images for your content.

cover_imagefree

Cover Image Search

Search Unsplash for high-quality cover images with proper attribution. Returns multiple results with photographer credit, image URLs in multiple sizes, and ready-to-use attribution text. Triggers Unsplash download tracking for API compliance.

Parameter	Type	Required	Description
`query`	string	Yes	Search terms for the image
`orientation`	string	No	landscape, portrait, or squarish (default: landscape)
`count`	number	No	Number of results 1-5 (default: 3)

claude code

you: "Find a cover image for my article about TypeScript"

✓ Found 3 images — with attribution text and URLs for regular + small sizes

Content

Transform and repurpose your content for different platforms and formats.

repurposecredits

Repurpose

Transform a full blog post into platform-native content for 6 platforms. Generates Twitter/X threads with rotating hook styles, LinkedIn posts with curated hashtags and engagement questions, Reddit posts with code snippets and subreddit suggestions, Hacker News titles, Bluesky posts, and newsletter intros. Each output follows platform-specific formatting rules and conventions.

Parameter	Type	Required	Description
`content`	string	Yes	Full article markdown content
`title`	string	Yes	Article title
`url`	string	No	Article URL for links and CTAs
`platforms`	string[]	Yes	Platforms: twitter, linkedin, reddit, hackernews, bluesky, newsletter

claude code

you: "Repurpose this article for Twitter, LinkedIn, Reddit, and Hacker News"

✓ Repurposed for 4 platforms — X thread (7 tweets), LinkedIn post, Reddit post with 3 suggested subreddits, HN title

frontmatterfree

Frontmatter

Generate correctly-formatted frontmatter for any static site generator or publishing platform. Supports Hugo, Jekyll, Astro, Next.js, Dev.to, Hashnode, and Ghost. Auto-extracts description, reading time, slug, and suggested tags from your content.

Parameter	Type	Required	Description
`title`	string	Yes	Article title
`content`	string	Yes	Article content for auto-extraction
`format`	string	Yes	hugo, jekyll, astro, nextjs, devto, hashnode, or ghost
`tags`	string[]	No	Tags (auto-suggested if omitted)
`canonical_url`	string	No	Canonical URL for cross-posted content
`featured_image`	string	No	Cover image URL

claude code

you: "Generate Hugo frontmatter for this article with canonical URL"

✓ Generated Hugo frontmatter — title, date, tags, description (auto-extracted), 5 min read

Social

Generate platform-native promotional posts from your articles.

generate_social_postscredits

Social Posts

Generate platform-native promotional posts from your article content. Creates optimized copy for each platform — concise threads for Twitter, professional posts for LinkedIn, discussion-friendly posts for Reddit, and clean text posts for Bluesky. Each output follows the conventions of its platform.

Parameter	Type	Required	Description
`content`	string	Yes	The article content to create posts from
`platforms`	string[]	Yes	Target platforms: twitter, linkedin, reddit, bluesky

claude code

you: "Generate social posts for this article on Twitter, LinkedIn, Reddit, and Bluesky"

✓ Generated 4 posts — Twitter thread (4 posts), LinkedIn post, Reddit text post, Bluesky post

Analytics

Track how your content performs across platforms.

analyticsfree

Analytics

Fetch post analytics and stats across all configured platforms in one view. Returns title, URL, views, reactions, and comments for each post, plus aggregate totals. Supports Dev.to, Ghost, Hashnode, and WordPress. Medium API does not support analytics.

Parameter	Type	Required	Description
`platform`	string	No	Specific platform, or omit for all configured platforms
`limit`	number	No	Max posts per platform (default: 10)

claude code

you: "Show my analytics across all platforms"

✓ 15 posts across 3 platforms — 8,500 total views, 230 reactions

Account

Configure platforms, manage your license, and check status.

setupfree

Setup

Configure platform API keys. Keys are stored locally in ~/.pipepost/config.json and never leave your machine. Run this once per platform to connect it.

Parameter	Type	Required	Description
`platform`	string	Yes	Platform to configure (devto, ghost, hashnode, wordpress, medium, substack, unsplash)
`api_key`	string	Yes	Your platform API key

claude code

you: "Set up my Dev.to API key: dv1_abc123…"

✓ Dev.to API key saved to ~/.pipepost/config.json

activatefree

Activate

Activate a credit pack license key. Validates with Lemon Squeezy, adds credits to your balance, and caches locally for offline use. Re-validates every 24 hours when online.

Parameter	Type	Required	Description
`license_key`	string	Yes	Your license key from checkout

claude code

you: "Activate my Pipepost license: XXXX-XXXX-XXXX"

✓ License activated — 30 credits added. Cached for offline use (re-validates every 24h).

statusfree

Status

Show your current Pipepost configuration: version, credit balance, configured platforms, API key status, and free credits remaining.

claude code

you: "Show my Pipepost status"

✓ v0.9.0 — 27 credits remaining (3 free), Dev.to + Ghost configured

Ready to try these tools?

3 free credits every month. Buy credit packs for unlimited SEO, publishing, and social posts. Credits never expire.

View pricing