Documentation

Welcome to the BetterPost documentation! Learn how to use BetterPost effectively to monitor content sources and automate content creation in order to save you time.

Overview

BetterPost is a powerful content monitoring and creation platform that helps you:

• Monitor Multiple Sources: Track RSS feeds, social media, blogs, and more
• Intelligent Content Curation: Use AI to filter and prioritize relevant content
• Automated Distribution: Share curated content across multiple channels
• AI-Enhanced Analysis: Extract key points, quotes, and insights from content
• Advanced Customization: Fine-tune content generation with detailed instructions
• Keep Your Voice: Create content in your own voice with your own style and unique insights

Getting Started

BetterPost uses a sophisticated modular architecture to automatically process your content sources. When you add a source, our system:

1. Source Processing - Analyzes the input and selects the appropriate processor
2. Content Discovery - Extracts story URLs and metadata from the source
3. Content Fetching - Uses specialized fetchers to retrieve and parse content from various URL types
4. AI Processing - Summarizes and analyzes the content for your project

Key Features

Source Types

BetterPost supports various content source types through specialized processors:

• Link (Auto-Detect) - Any URL with automatic feed discovery and web processing
• Web Search - General web search results for discovering new content
• YouTube Search - Video content and tutorials
• X/Twitter Search - Social media content and trends
• Bluesky Search - Decentralized social media content and trends

AI-Powered Curation

• Content Relevancy Scoring - Automatically scores content based on your criteria
• Smart Filtering - Include or exclude content based on keywords and patterns
• Content Summarization - Generate concise summaries of longer articles
• Key Points Extraction - AI identifies important claims and insights
• Quote Extraction - Relevant quotes and passages from original content
• Personal Notes - Add your own observations and planning notes

Content Generation

• Multi-Channel Support - Newsletter, social media, blog posts, email outreach
• SEO Optimization - Meta descriptions, tags, and FAQ generation for blog posts
• Word Limit Control - Configurable content length (100-10,000 words for blogs)
• Additional Instructions - Advanced customization beyond audience and tone
• Product Tie-Ins - Weave product or service descriptions into content naturally
• Saved Topics - Quick reference library of topics for content creation
• Advanced Mode - Full control with persisted state management
• Content Storage - Historical record of all generated content
• Scheduled Posts - Automatic weekly or monthly content generation

Channel Types

• Newsletter: Email distribution with subject line optimization and preview text
• Blog Post: Long-form content with SEO optimization, meta descriptions, tags, and FAQ generation
• Email Outreach: Personalized business outreach requiring product descriptions
• Social Media: Platform-specific formatting for:
  • X (Twitter): Character-optimized posts with thread support
  • LinkedIn: Professional posts optimized for business networking
  • Facebook: Posts with engagement optimization
  • BlueSky: Posts for the decentralized social network
• Video Content: Scripts for:
  • TikTok: 15-60 second scripts with hook-focused storytelling
  • Instagram: Reels scripts with hashtag strategy
  • YouTube Shorts: Scripts with SEO-optimized titles and descriptions

Quick Start

1. Create a Project - Organize your content monitoring by topic or purpose
2. Add Sources - Use our search tool or manually add content sources
3. Set Criteria - Define what content is relevant to your project
4. Configure Settings - Set up your audience, tone, and content type preferences
5. Start Creating - Click the "Generate Content" button to create content in your voice

Advanced Features

Content Customization

• Additional Instructions: Fine-tune AI output with specific guidelines
• Word Limits: Control content length for optimal SEO and engagement
• Product Tie-Ins: Connect stories to your business offerings with natural integration
• Saved Topics: Build a library of topics for quick reference during content creation
• Channel-Specific Settings: Override project defaults per channel
• Max Story Age: Control how recent stories must be (1-30 days)
• Scheduled Posts: Automate content generation on weekly or monthly schedules

Story Management

• Personal Notes: Add observations and planning notes to stories
• Key Points: AI-extracted important claims and insights
• Quotes: Relevant passages from original content
• Bulk Operations: Manage multiple stories efficiently

Content Storage

• Historical Records: Access all previously generated content
• Performance Tracking: Monitor content effectiveness
• Content Reuse: Repurpose and adapt existing content

Source Processing

• Automatic Detection: BetterPost automatically selects the best processor for each source
• Feed Discovery: Automatically finds RSS/Atom feeds on websites
• Quality Filtering: Social media sources filter by engagement (likes, upvotes)
• Fallback Processing: Multiple strategies ensure content is captured
• Error Handling: Robust error handling and retry mechanisms

Billing and Credits

BetterPost uses a credit-based billing system:

• Credit Costs: Each content generation costs 1 credit
• Plan Limits: Different plans offer varying credits, projects, and sources per project
• Trial Credits: New users receive 10 trial credits (users only)
• Monthly Reset: Credits reset monthly based on your billing period
• Upgrade Options: Multiple plans available from Free Trial to Pro

See Billing and Credits for complete details on plans, limits, and credit usage.

Additional Features

Content Calendar

• Weekly Schedule View - See all scheduled posts organized by day of the week
• Monthly Calendar View - Visual calendar showing generated content and scheduled posts
• Manual Generation - Generate content for specific dates on demand
• Content Preview - Click any generated content to view it in a modal

Content History

• Posts Page - View all generated content in a searchable table
• Content Details - See creation date, content type, word limits, story counts, and tie-ins
• Quick Actions - View, edit, or delete content directly from the list
• Content Links - Access permalinks to individual content items

Content Type Settings

• Platform-Specific Configuration - Override default settings for each content type
• Custom Instructions - Set additional instructions per content type
• Word Limits - Configure target word counts for blog posts and long-form content
• Automatic Application - Settings are automatically used during content generation

Next Steps

• Your First Project - Step-by-step tutorial
• Billing and Credits - Understand credits, plans, and limits
• Adding Sources - Learn about different source types
• Configuring Projects - Set up project settings, saved topics, and product tie-ins
• Content Generator - Create and manage content
• Scheduled Posts - Automate content generation on a schedule
• Content Calendar - View and manage your content calendar
• Posts - Browse and manage your content history
• Stories Management - Curate and organize discovered content
• MCP Server - Connect AI assistants to BetterPost