perplexity
Deep search via Perplexity API. Three modes: search (quick facts), reason (complex analysis), research (in-depth reports). Returns AI-grounded answers with citations.
Best use case
perplexity is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Deep search via Perplexity API. Three modes: search (quick facts), reason (complex analysis), research (in-depth reports). Returns AI-grounded answers with citations.
Teams using perplexity should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/perplexity-deep-search/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How perplexity Compares
| Feature / Agent | perplexity | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Deep search via Perplexity API. Three modes: search (quick facts), reason (complex analysis), research (in-depth reports). Returns AI-grounded answers with citations.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Perplexity Deep Search
AI-powered web search with three modes for different depth levels.
## Quick Start
```bash
# Quick search (sonar) - facts, summaries, current events
{baseDir}/scripts/search.sh "latest AI news"
# Reasoning (sonar-reasoning-pro) - complex analysis, multi-step
{baseDir}/scripts/search.sh --mode reason "compare React vs Vue for enterprise apps"
# Deep Research (sonar-deep-research) - full reports, exhaustive analysis
{baseDir}/scripts/search.sh --mode research "market analysis of AI in healthcare 2025"
```
## Modes
| Mode | Model | Best For | Cost |
|------|-------|----------|------|
| `search` (default) | `sonar-pro` | Quick facts, summaries, current events | Low |
| `reason` | `sonar-reasoning-pro` | Complex analysis, comparisons, problem-solving | Medium |
| `research` | `sonar-deep-research` | In-depth reports, market analysis, literature reviews | High |
## Options
| Flag | Description | Default |
|------|-------------|---------|
| `--mode` | `search`, `reason`, `research` | `search` |
| `--recency` | `hour`, `day`, `week`, `month` | — |
| `--domains` | Comma-separated domain filter | — |
| `--lang` | Language code (`pt`, `en`, `es`, etc.) | — |
| `--json` | Raw JSON output | off |
## Examples
```bash
# Search with recency filter
{baseDir}/scripts/search.sh --recency week "OpenAI latest announcements"
# Search restricted to specific domains
{baseDir}/scripts/search.sh --domains "arxiv.org,nature.com" "transformer architecture advances"
# Search in Portuguese
{baseDir}/scripts/search.sh --lang pt "inteligência artificial no Brasil"
# Deep research with JSON output
{baseDir}/scripts/search.sh --mode research --json "enterprise AI adoption trends"
```
## API Key
Set `PERPLEXITY_API_KEY` env var:
```bash
export PERPLEXITY_API_KEY="pplx-..."
```
## Pricing Reference
- **Search (sonar-pro):** ~$0.01/query
- **Reasoning (sonar-reasoning-pro):** ~$0.02/query
- **Deep Research (sonar-deep-research):** ~$0.40/query (uses many searches + reasoning)
Use `search` for everyday queries. Reserve `research` for when you truly need exhaustive analysis.Related Skills
perplexity-research
Conduct deep research using Perplexity Agent API with web search, reasoning, and multi-model analysis.
perplexity-safe
Use Perplexity API for web-grounded AI search.
perplexity-web-search
Web search and URL fetching via Perplexity (default: sonar, optional: sonar-pro)
paylock
Non-custodial SOL escrow for AI agent deals.
agent-reputation
summary: Cross-platform AI agent reputation checker with trust scoring and PayLock escrow recommendations.
Telecom Agent Skill
Turn your AI Agent into a Telecom Operator. Bulk calling, ChatOps, and Field Monitoring.
OpenClaw-Finnhub
OpenClaw skill for real-time stock quote, and financials via Finnhub API.
```markdown
# OpenClaw-Last.fm
security-operator
Runtime security guardrails for OpenClaw agents.
operator-humanizer
Transform AI-generated text into authentic human writing.
kit-email-operator
**AI-powered email marketing for Kit (ConvertKit)**.
agora
Trade prediction markets on Agora — the prediction market exclusively for AI agents. Register, browse markets, trade YES/NO, create markets, earn reputation via Brier scores.