Skip to main content

Perplexity Search CLI

Use Perplexity real-time web search from the command line.

Prerequisites

# Install the package
npm install @perplexity-ai/ai-sdk

# Set your API key
export PERPLEXITY_API_KEY=your-perplexity-api-key

Commands

List Tools

praisonai-ts tools list --tag search

Tool Information

praisonai-ts tools info perplexity

Health Check

praisonai-ts tools doctor

Test Tool

# Dry run
praisonai-ts tools test perplexity

# Live test
praisonai-ts tools test perplexity --live

Search Examples

praisonai-ts agent run \
  --tools perplexity \
  --prompt "What are the latest AI developments?"

Recent News

praisonai-ts agent run \
  --tools "perplexity:recency=day" \
  --prompt "What happened in tech today?"
praisonai-ts agent run \
  --tools "perplexity:searchDomainFilter=arxiv.org" \
  --prompt "Find recent papers on transformer architectures"
praisonai-ts agent run \
  --tools "perplexity:language=en" \
  --prompt "Search for AI news in English"

Tool Options

OptionTypeDefaultDescription
recencystring-day, week, month, year
languagestring-ISO 639-1 language code
searchDomainFilterstring[]-Domains to search
numResultsnumber10Number of results

Advanced Examples

News Analysis

praisonai-ts agent run \
  --instructions "You are a news analyst" \
  --tools "perplexity:recency=day,numResults=5" \
  --prompt "Analyze today's top tech stories"

Academic Research

praisonai-ts agent run \
  --instructions "You are a research assistant" \
  --tools "perplexity:searchDomainFilter=arxiv.org|nature.com" \
  --prompt "Find recent research on quantum computing"

JSON Output

praisonai-ts agent run \
  --tools perplexity \
  --prompt "AI news" \
  --json

Combining Tools

praisonai-ts agent run \
  --tools "perplexity,exa" \
  --prompt "Compare search results about GPT-5 from multiple sources"

Environment Variables

VariableRequiredDescription
PERPLEXITY_API_KEYYesPerplexity API key
OPENAI_API_KEYYesOpenAI API key
  • praisonai-ts tools list - List all tools
  • praisonai-ts tools doctor - Check tool health