Queries Perplexity AI via sonar/sonar-pro/sonar-deep-research/sonar-reasoning-pro models. Use when conducting cited web research, deep technical reports, or complex reasoning problems requiring up-to-date sources.
Scanned 9/19/2026
Install to Claude Code
Skills Directorynpx -y skills add bsamiee/Parametric_Portal --skill perplexity-tools --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Perplexity Tools?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/bsamiee-perplexity-tools)More formats (shields.io, HTML) on the badges page.
---
name: perplexity-tools
user-invocable: false
description: >-
Queries Perplexity AI via sonar/sonar-pro/sonar-deep-research/sonar-reasoning-pro models. Use when conducting cited web research, deep technical reports, or complex reasoning problems requiring up-to-date sources.
---
# [H1][PERPLEXITY-TOOLS]
>**Dictum:** *Specialized models optimize response quality.*
<br>
Execute Perplexity AI queries via Python CLI. API key auto-injected via 1Password.
[IMPORTANT] Sonar family models (Feb 2026): `sonar` (lightweight search), `sonar-pro` (deeper retrieval, 2x more results), `sonar-reasoning` (real-time reasoning), `sonar-reasoning-pro` (DeepSeek-R1, visible reasoning), `sonar-deep-research` (long-form reports). Citation tokens no longer billed for sonar/sonar-pro.
---
## [1][COMMANDS]
| [CMD] | [ARGS] | [MODEL] |
| -------- | ------------------------- | ------------------- |
| ask | `<query>` | sonar |
| pro | `<query>` | sonar-pro |
| research | `<query> [strip]` | sonar-deep-research |
| reason | `<query> [strip]` | sonar-reasoning-pro |
| search | `<query> [max] [country]` | sonar |
---
## [2][USAGE]
```bash
# Quick question with citations (lightweight)
uv run .claude/skills/perplexity-tools/scripts/perplexity.py ask "What is Effect-TS?"
# Pro question with deeper retrieval
uv run .claude/skills/perplexity-tools/scripts/perplexity.py pro "Compare Vite 7 vs Turbopack bundling strategies"
# Deep research (10min timeout)
uv run .claude/skills/perplexity-tools/scripts/perplexity.py research "React 19 new features"
# Deep research, strip thinking tags
uv run .claude/skills/perplexity-tools/scripts/perplexity.py research "Vite 7 migration" strip
# Reasoning task
uv run .claude/skills/perplexity-tools/scripts/perplexity.py reason "Compare Effect vs RxJS"
# Web search with max results
uv run .claude/skills/perplexity-tools/scripts/perplexity.py search "Nx 22 features" 5
```
---
## [3][ARGUMENTS]
**ask**: `<query>`
- `query` — Question to ask (required)
- Model: `sonar` (fast, lightweight search)
**pro**: `<query>`
- `query` — Question requiring deeper retrieval (required)
- Model: `sonar-pro` (enhanced search, 2x results)
**research**: `<query> [strip]`
- `query` — Research topic (required)
- `strip` — Pass `strip` to remove `<think>` tags from response
- Model: `sonar-deep-research` (long-form, source-dense reports)
**reason**: `<query> [strip]`
- `query` — Reasoning problem (required)
- `strip` — Pass `strip` to remove `<think>` tags from response
- Model: `sonar-reasoning-pro` (DeepSeek-R1, visible chain-of-thought)
**search**: `<query> [max] [country]`
- `query` — Search query (required)
- `max` — Max results (default: `10`)
- `country` — Country code to focus results (e.g., `US`, `GB`)
---
## [4][OUTPUT]
Commands return: `{"status": "success|error", ...}`.
| [INDEX] | [CMD] | [RESPONSE] |
| :-----: | ---------- | -------------------------------- |
| [1] | `ask` | `{query, response, citations[]}` |
| [2] | `pro` | `{query, response, citations[]}` |
| [3] | `research` | `{query, response, citations[]}` |
| [4] | `reason` | `{query, response}` |
| [5] | `search` | `{query, results[]}` |
---
## [5][ENVIRONMENT]
| [VAR] | [REQUIRED] | [DESCRIPTION] |
| -------------------- | ---------- | --------------------------------------- |
| `PERPLEXITY_API_KEY` | Yes | Perplexity API key (1Password injected) |
---
## [6][ERROR_HANDLING]
- HTTP errors print `[ERROR] <status>: <body>` and exit 1
- Rate limit (429): print retry guidance and exit 1
- `research` command uses 10-minute timeout; long-running queries may time out
- `reason` output includes `<think>` tags by default; pass `strip` to remove
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
