Menu
AI-powered web search, research, and reasoning via Perplexity
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create git commits with user approval and no Claude attribution
Create or update continuity ledger for state preservation across clears
Create handoff document for transferring work to another session
Generate comprehensive PR descriptions following repository templates
Deep interview process to transform vague ideas into detailed specs. Works for technical and non-technical users.
Search Mathlib for lemmas by type signature pattern
| name | perplexity-search |
| description | AI-powered web search, research, and reasoning via Perplexity |
| allowed-tools | ["Bash","Read"] |
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 |
uv run python scripts/mcp/perplexity_search.py \
--ask "What is the latest version of Python?"
uv run python scripts/mcp/perplexity_search.py \
--search "SQLite graph database patterns" \
--max-results 5 \
--recency week
uv run python scripts/mcp/perplexity_search.py \
--research "compare FastAPI vs Django for microservices"
uv run python scripts/mcp/perplexity_search.py \
--reason "should I use Neo4j or SQLite for small graph under 10k nodes?"
uv 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 |
# 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.