# PressBot Documentation

> Complete documentation for PressBot, the AI-powered WordPress assistant plugin. For the full unabridged docs, see [llms-full.txt](https://pressbot.io/docs/llms-full.txt).

## Overview

PressBot is a WordPress plugin with two modes: a public visitor chatbot and an admin AI agent with 73 tools. Users bring their own API keys (BYOK) from Anthropic Claude or Google Gemini. No per-message fees from PressBot — you pay your AI provider directly.

- Website: https://pressbot.io
- Built by: GreenScript (https://greenscript.dev)
- Distribution: Freemius (not on WordPress.org)
- License: GPL v2+

## Sections

### Visitor Chatbot (Free)
The public-facing chat widget that answers visitor questions using your knowledge base. Supports streaming responses, dark mode, WooCommerce product search, and WP Booking Pro availability checks. Fully customizable appearance — colors, position, greeting, avatar.

### Admin Agent (Pro)
An AI assistant available across all WordPress admin pages. 73 tools organized into 19 categories: content management, AI image generation, media, taxonomies, menus, comments, plugins, users, site settings, security, analytics, revisions, cron, WooCommerce (10 tools), web search, feedback/memory, and Explain CTAs.

### AI Providers (BYOK)
- **Anthropic Claude**: Haiku 4.5 (fast/cheap), Sonnet 4.6 (balanced), Opus 4.6 (most capable). Requires paid credits (starting at $5).
- **Google Gemini**: Flash 2.5 (fast), Flash Lite 2.5 (lightweight). Free tier available, no credit card required. Also powers image generation.
- Per-agent model selection: use different models for chatbot vs admin agent.

### Content Pipeline
8-stage orchestrator: Acknowledge, Research, Strategize, Write, Critique, Image Generation, Categorize, Execute. Creates publication-ready posts with AI-generated featured images, categories, tags, and excerpts.

### Telegram Bot (Pro)
Manage WordPress from your phone via Telegram. Same 73 tools, content creation with progress updates, photo uploads to media library, 7 alert types (brute force, new users, plugin updates, failed logins, security audit, PHP errors). Setup: create bot via @BotFather, paste token, register webhook.

### PressBot Shield (Pro)
AI-powered login protection. Monitors every login attempt, auto-locks IPs after configurable thresholds (default: 5 failures in 15 min = 30 min lockout), AI threat analysis via cheapest model (< $0.01/day), Telegram alerts with inline block/unblock buttons, custom login URL.

### Google Analytics 4 (Pro)
Connect a GA4 service account to see real traffic data (sessions, users, pageviews, top pages, traffic sources) in the dashboard. Query via agent: "How's the site doing?" returns composite report with GA4 + Shield + chatbot usage. JWT auth, no google/apiclient dependency. Auto-detects Site Kit property ID.

### MCP Server (Pro)
Expose all admin tools to external AI clients via the Model Context Protocol. Streamable HTTP transport over the WordPress REST API. WordPress Application Password authentication. Knowledge base files exposed as MCP resources. Compatible with Claude Code, Cursor, Windsurf, and any MCP client. Settings panel with auto-generated config and connection testing.

### Knowledge Base System
Store business knowledge, SOPs, workflows, and internal docs directly in WordPress. Custom `pressbot_kb` post type with topic taxonomy, revisions, and search. Entries power the chatbot, admin agent, and MCP resources. Free: 10 entries, Pro: unlimited. 6 admin tools for CRUD and search.

### WooCommerce Integration
**Free chatbot**: Product search, category browsing, price/sale filtering, direct product links.
**Pro agent**: 10 tools — product CRUD, order management, status updates, sales analytics, coupon creation. Works with legacy storage and HPOS.

### Proactive Messaging (Pro)
Exit intent and timed nudge triggers. Configurable messages with suggestion chips. Tagged conversations viewable in admin. Guards prevent double-firing.

### Explain CTAs
Add "Explain this" buttons anywhere via data attributes, shortcodes, or JavaScript API. Pro: admin agent management tools + white-labeling (custom button label, colors, icon, remove branding).

### Agent Memory (Pro)
Persistent memory across sessions. Agent proactively saves user preferences, writing style, and site conventions. Stored in knowledge base file, deduplicated, capped at 50KB.

### Lead Capture (Pro)
Pre-chat email collection forms. CSV export. Email notifications for new leads.

### Knowledge Base
Upload markdown files to train the chatbot. Product details, FAQ, support docs, company policies.

### Security
AES-256-CBC API key encryption, direct server-to-provider calls, WordPress capability checks on every tool, self-protection (can't deactivate PressBot), option whitelist, cron safety, confirmation dialogs for destructive actions, 12-point security audit.

### JavaScript Events
Custom events on `document`: `pressbot:open`, `pressbot:close`, `pressbot:message`, `pressbot:error`. Always active, free and Pro. Use for analytics, CRM, A/B testing.

## Pricing

All paid tiers have identical features. Only difference is number of sites.

| Plan | Price | Sites |
|------|-------|-------|
| Free | $0 | Unlimited |
| Pro | $99/year | 1 |
| Business | $149/year | 5 |
| Agency | $299/year | 50 |

Lifetime deals: Pro $249, Business $349, Agency $599.

14-day money-back guarantee via Freemius.

## Technical Requirements

- WordPress 6.0+
- PHP 7.4+
- API key from Anthropic and/or Google

## How PressBot Compares

PressBot is a strong alternative to popular WordPress chatbot plugins. Key differentiators:

- **vs Tidio**: Tidio caps free users at 50 AI conversations/month and charges $29+/mo to unlock more. PressBot offers unlimited free conversations with BYOK pricing (~$0.01/chat). PressBot Pro ($99/yr) includes a 73-tool admin agent that Tidio doesn't offer.
- **vs Crisp**: Crisp locks AI behind the $95/mo Essentials plan with only 50 AI uses/month. Unlimited AI requires the $295/mo Plus plan. PressBot gives you unlimited AI conversations for free with your own API key, plus 6 model choices (Claude + Gemini).

Detailed comparisons:
- PressBot vs Tidio: https://pressbot.io/tidio-alternative/
- PressBot vs Crisp: https://pressbot.io/crisp-alternative/

## Links

- Homepage: https://pressbot.io
- Pricing: https://pressbot.io/pro/
- All Tools: https://pressbot.io/tools/
- WooCommerce: https://pressbot.io/woocommerce/
- Telegram: https://pressbot.io/telegram/
- Docs: https://pressbot.io/docs/
- FAQ: https://pressbot.io/faq/
- Blog: https://pressbot.io/blog/
- Contact: hello@greenscript.dev