User Guide

Everything you need to use RankFlo — from creating your first project to publishing with AI assistance.

Dashboard overview

After signing in you land on the Overview page. The left sidebar gives you access to all sections:

Section	What it does
Overview	Quick stats: posts published, total views
Posts	All blog posts across every status
Calendar	Visual editorial calendar for scheduling
Media	Image and file library
Analytics	Pageviews, top posts, traffic sources
Search	Search analytics — queries, CTR, zero-results
Settings	API keys, AI providers, team, webhooks

Projects

Every blog lives inside a Project. One organization can have multiple projects.

Go to Projects → New Project
Enter a name and your website URL
Copy your Project API Key (blg_xxx)

Your project key is read-only and only returns published posts. Safe to use in frontend code.

Writing posts

RankFlo uses a block editor powered by Tiptap. Type / anywhere to open the block menu.

Block	Shortcut
Heading (H1-H3)	`/h1` `/h2` `/h3`
Image	`/image`
Callout	`/callout`
Code block	`/code`
Table	`/table`
Quote	`/quote`
Embed	`/embed`

Posts move through statuses:

text

Draft → In Review → Scheduled → Published → Archived

AI Writing

Click the AI icon in the editor toolbar to access AI tools:

Tool	What it does
Generate post	Write a full post from a topic or brief
Continue writing	Extend the current content
Rewrite	Rewrite selected text in a different tone
SEO optimize	Improve keyword density and meta tags
AI Chat	Free-form conversation about the content

Go to Settings → AI to connect your AI provider (OpenAI, Anthropic, Google, Ollama). BYO key — RankFlo charges nothing for AI usage.

SEO Audit

The SEO panel runs a 9-point audit on every post (score out of 100):

Meta title — present, correct length (30-60 chars)
Meta description — present, correct length (120-160 chars)
H1 heading — present, one per post
Keyword in title and first paragraph
Image alt text on all images
Internal links — at least one
Structured data — valid JSON-LD schema

Analytics

Add the tracker to your site:

html

<script
  async
  src="https://app.rankflo.io/tracker.js"
  data-project-key="blg_xxx"
></script>

Cookieless, privacy-first — no GDPR consent banner needed.

Dashboard shows pageviews, top posts, traffic sources, UTM breakdown, devices, and AI referrers (ChatGPT, Perplexity, Claude).

Team & Roles

Invite members at Settings → Team.

Role	Permissions
Admin	Everything: billing, API keys, team settings
Editor	Create, edit, publish any post
Author	Create and edit own posts
Viewer	Read-only access

Chrome Extension

Write and publish from any webpage. Press Cmd+Shift+Y (Mac) / Ctrl+Shift+Y (Windows) to open the side panel. Select text on any page to import it into the editor.

MCP Server (Claude Desktop)

Connect RankFlo to Claude Desktop for AI-powered content management:

json

{
  "mcpServers": {
    "rankflo": {
      "command": "node",
      "args": ["/path/to/RankFlo/packages/mcp/dist/index.js"],
      "env": {
        "RANKFLO_API_KEY": "sk_live_...",
        "RANKFLO_URL": "https://app.rankflo.io"
      }
    }
  }
}

Example prompts: "Write a 1000-word post about B2B lead generation", "List my last 5 published posts", "Schedule this post for Monday at 9am"