Install any skill in seconds. Free to start, no credit card required.
Get Started Free →AI-powered web search, research, and reasoning via Perplexity
| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-01 | ✗→✓ | ▲ Improved | 251% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 178% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 402% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 200% | 0% |
| case-07 | ✗→✓ | ▲ Improved | 21% | 0% |
Web search with AI-powered answers, deep research, and chain-of-thought reasoning.
| Model | Purpose | |-------|---------| | sonar | Lightweight search with grounding | | sonar-pro | Advanced search for complex queries | | sonar-reasoning-pro | Chain of thought reasoning | | sonar-deep-research | Expert-level exhaustive research |
bashuv run python scripts/mcp/perplexity_search.py \ --ask "What is the latest version of Python?"
bashuv run python scripts/mcp/perplexity_search.py \ --search "SQLite graph database patterns" \ --max-results 5 \ --recency week
bashuv run python scripts/mcp/perplexity_search.py \ --research "compare FastAPI vs Django for microservices"
bashuv run python scripts/mcp/perplexity_search.py \ --reason "should I use Neo4j or SQLite for small graph under 10k nodes?"
bashuv run python scripts/mcp/perplexity_search.py \ --deep "state of AI agent observability 2025"
| Parameter | Description | |-----------|-------------| | --ask | Quick question with AI answer (sonar) | | --search | Direct web search - ranked results without AI synthesis | | --research | AI-synthesized research (sonar-pro) | | --reason | Chain-of-thought reasoning (sonar-reasoning-pro) | | --deep | Deep comprehensive research (sonar-deep-research) |
| Parameter | Description | |-----------|-------------| | --max-results N | Number of results (1-20, default: 10) | | --recency | Filter: day, week, month, year | | --domains | Limit to specific domains |
| Need | Use | Why | |------|-----|-----| | Quick fact | --ask | Fast, lightweight | | Find sources | --search | Raw results, no AI overhead | | Synthesized answer | --research | AI combines multiple sources | | Complex decision | --reason | Chain-of-thought analysis | | Comprehensive report | --deep | Exhaustive multi-source research |
bash# Find recent sources on a topic uv run python scripts/mcp/perplexity_search.py \ --search "OpenTelemetry AI agent tracing" \ --recency month --max-results 5 # Get AI synthesis uv run python scripts/mcp/perplexity_search.py \ --research "best practices for AI agent logging 2025" # Make a decision uv run python scripts/mcp/perplexity_search.py \ --reason "microservices vs monolith for startup MVP" # Deep dive uv run python scripts/mcp/perplexity_search.py \ --deep "comprehensive guide to building feedback loops for autonomous agents"
Requires PERPLEXITY_API_KEY in environment or ~/.claude/.env.
Other measured skills in the registry, with their headline benchmark lift.