Better Search Pro CLI Overview

Better Search Pro CLI (BSP-CLI) was introduced in Better Search Pro v4.3.0, allowing you to manage search operations without touching the admin dashboard. If you’re running large-scale WordPress installations or automating deployments, these commands handle everything from cache warming to database maintenance.

About WP-CLI

WP-CLI is a set of command-line tools for managing WordPress installations. You can update plugins, configure multisite installations, and much more, all without using a web browser. For more information, visit the official WP-CLI websiteOpens in a new window.

Getting Started with BSP-CLI

To begin using BSP-CLI, ensure that WP-CLI is installed and that you are running Better Search Pro 4.3.0 or later. The CLI commands are accessed through the wp bsearch command. For a complete list of available commands, type wp bsearch in your command-line interface.

Command Structure

All commands use the wp bsearch namespace:

wp bsearch <command> <subcommand> [options]

Available Commands

Run search queries directly from the command line.

wp bsearch search "search term"

Options

  • --limit=<number> — Number of results (default: 10)
  • --post-type=<types> — Comma-separated post types (default: post)
  • --[no-]use-fulltext — Force FULLTEXT search ON or OFF
  • --[no-]boolean-mode — Use boolean mode for FULLTEXT ON or OFF
  • --format=<format> — Output format: table, json, csv (default: table)
  • --verbose — Show detailed output

Examples

# Search for "WordPress" and show 20 results
wp bsearch search "WordPress" --limit=20

# Search across multiple post types
wp bsearch search "tutorial" --post-type=post,page

# Get results in JSON format
wp bsearch search "mysql" --format=json

Status

Show comprehensive plugin status and configuration.

wp bsearch status

Options:

  • --format=<format> — Output format: table, json, csv
  • --verbose — Show detailed information
  • --network — Show status for all network sites

Cache

Manage the search results cache.

Clear Cache

wp bsearch cache clear

Options:

  • --network — Clear cache for all sites in the network
  • --force — Skip confirmation
  • --dry-run — Preview without making changes
  • --verbose — Show detailed output

Warm Cache

Pre-generate search results for your most popular queries.

wp bsearch cache warm

Options:

  • --limit=<number> — Number of top searches to warm (default: 50)
  • --batch-size=<size> — Batch size for processing (default: 100)
  • --dry-run — Preview without making changes
  • --force — Force cache warming even if cache exists

Cache Status

wp bsearch cache status

Options:

  • --format=<format> — Output format: table, json, csv

AI Answers

Inspect and operate Better Search Pro AI Answers from WP-CLI.

AI Status

wp bsearch ai status
wp bsearch ai status --format=json

The status includes whether AI Answers is enabled, provider availability, selected and fallback providers, provider cooldown state, cached-answer count, today’s provider requests, the daily cap, and the number of recorded questions.

Check Provider

Force a live provider availability check:

wp bsearch ai check-provider

Ask a Question

wp bsearch ai ask "How do I configure search?"
wp bsearch ai ask "How do I configure search?" --format=json

The command uses the configured provider chain and returns the answer, sources, cache state, and failure reason.

Clear the AI Cache

wp bsearch ai cache clear

This removes cached answers and provider state.

Content Gaps

wp bsearch ai gaps list
wp bsearch ai gaps list --from=2026-09-01 --to=2026-09-30 --format=json
wp bsearch ai gaps export > content-gaps.csv
wp bsearch ai gaps export --format=json
wp bsearch ai gaps clear --yes

The list command supports --from, --to, --limit, --page, and --format. Export supports CSV and JSON. Clear deletes every recorded question and prompts for confirmation unless --yes is supplied.

Was this article helpful?

Tagged:

Related Articles