← Back to list
perplexity-search
by parcadei
Context management for Claude Code. Hooks maintain state via ledgers and handoffs. MCP execution without context pollution. Agent orchestration with isolated context windows.
⭐ 3,352🍴 252📅 Jan 23, 2026
agentsclaude-codeclaude-code-cliclaude-code-hooksclaude-code-mcpclaude-code-skillsclaude-code-subagentsclaude-skills
Run in ManusUse Cases
🔗
MCP Server Integration
AI tool integration using Model Context Protocol. Using perplexity-search.
🔗
API Integration
Easily build API integrations with external services.
🔄
Data Synchronization
Automatically sync data between multiple systems.
SKILL.md
name: perplexity-search description: AI-powered web search, research, and reasoning via Perplexity allowed-tools: [Bash, Read]
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.
Score
Total Score
95/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
✓説明文
100文字以上の説明がある
+10
✓人気
GitHub Stars 1000以上
+15
✓最近の活動
1ヶ月以内に更新
+10
✓フォーク
10回以上フォークされている
+5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
✓タグ
1つ以上のタグが設定されている
+5
Reviews
💬
Reviews coming soon
