메뉴
Deep search via Perplexity API. Three modes: search (quick facts), reason (complex analysis), research (in-depth reports). Returns AI-grounded answers with citations.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications. Use when deploying an application, setting up CI/CD, writing GitHub Actions workflows, configuring health checks, or asking about rollback strategies.
Create Mermaid diagrams (activity, deployment, sequence, architecture) from text descriptions or source code. Use when asked to "create a diagram", "generate mermaid", "document architecture", "code to diagram", "create design doc", or "convert code to diagram". Supports hierarchical on-demand guide loading, Unicode semantic symbols, and Python utilities for diagram extraction and image conversion.
Docker and Docker Compose patterns for local development, container security, networking, volume strategies, and multi-service orchestration. Use when writing a Dockerfile, setting up docker-compose, containerizing an app, or asking about container security and networking.
PostgreSQL database patterns for query optimization, schema design, indexing, and security. Use when designing a database schema, writing SQL queries, optimizing slow queries, adding indexes, or asking about database security and migrations.
Reviews a GitHub pull request diff and produces a structured report covering correctness, security, Python best practices, and test coverage. Use when asked to review a PR, check a pull request, analyze a diff, or validate code before merging.
Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Use when starting a Python project, choosing a framework, structuring code, adding type hints, or asking about Python best practices.
| name | perplexity-deep-search |
| description | Deep search via Perplexity API. Three modes: search (quick facts), reason (complex analysis), research (in-depth reports). Returns AI-grounded answers with citations. |
| homepage | https://docs.perplexity.ai |
| metadata | {"clawdbot":{"emoji":"🔮","requires":{"bins":["curl","jq"]},"primaryEnv":"PERPLEXITY_API_KEY"}} |
AI-powered web search with three modes for different depth levels.
# 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"
| 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 |
| 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 |
# 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"
Set PERPLEXITY_API_KEY env var, or store it in a file:
mkdir -p ~/.config/perplexity
echo "your_key_here" > ~/.config/perplexity/api_key
chmod 600 ~/.config/perplexity/api_key
The script checks the env var first, then falls back to the file.
Use search for everyday queries. Reserve research for when you truly need exhaustive analysis.
| Error | Cause | Solution |
|---|---|---|
401 Unauthorized | Invalid or missing API key | Check PERPLEXITY_API_KEY env var is set |
429 Rate Limited | Too many requests | Wait and retry; use search mode instead of research |
500 Server Error | Perplexity outage | Retry after 30s; fall back to web search |
| Empty results | Query too specific | Broaden search terms |
| Timeout | research mode is slow (~3-5 min) | Expected for deep research; use search for quick queries |