perplexity-search
AI-powered web search, research, and reasoning via Perplexity
How do I install this agent skill?
npx skills add https://github.com/parcadei/continuous-claude-v3 --skill perplexity-searchIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates web searching and AI-powered research via Perplexity. It operates by executing a local Python script and requires an API key for authentication. The primary security consideration is the ingestion of untrusted content from the web, which could potentially contain malicious instructions targeting the agent.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
1 file scanned · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Perplexity AI Search
Web search with AI-powered answers, deep research, and chain-of-thought reasoning.
When to Use
- Direct web search for ranked results (no AI synthesis)
- AI-synthesized research with citations
- Chain-of-thought reasoning for complex decisions
- Deep comprehensive research on topics
Models (2025)
| 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 |
Usage
Quick question (AI answer)
uv run python scripts/mcp/perplexity_search.py \
--ask "What is the latest version of Python?"
Direct web search (ranked results, no AI)
uv run python scripts/mcp/perplexity_search.py \
--search "SQLite graph database patterns" \
--max-results 5 \
--recency week
AI-synthesized research
uv run python scripts/mcp/perplexity_search.py \
--research "compare FastAPI vs Django for microservices"
Chain-of-thought reasoning
uv run python scripts/mcp/perplexity_search.py \
--reason "should I use Neo4j or SQLite for small graph under 10k nodes?"
Deep comprehensive research
uv run python scripts/mcp/perplexity_search.py \
--deep "state of AI agent observability 2025"
Parameters
| 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) |
Search-specific options
| Parameter | Description |
|---|---|
--max-results N | Number of results (1-20, default: 10) |
--recency | Filter: day, week, month, year |
--domains | Limit to specific domains |
Mode Selection Guide
| 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 |
Examples
# 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"
API Key Required
Requires PERPLEXITY_API_KEY in environment or ~/.claude/.env.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/parcadei/continuous-claude-v3/perplexity-search">View perplexity-search on skillZs</a>