| name | perplexity |
| description | Search the web and do research using Perplexity AI. Use this skill whenever the user wants to search the web, look up current information, do research, or find facts online. Supports filtering by domain, country, and language, as well as multi-query batch search. For in-depth research reports use deep-search with a preset. Triggers on: "search the web", "look up", "find info on", "research", "what is X", "latest news on X", "search for X", or any request needing up-to-date information from the internet.
|
perplexity Skill
A CLI for searching the web and running deep research queries using Perplexity AI.
Requires: PERPLEXITY_API_KEY environment variable.
Quick Reference
| Goal | Command |
|---|
| Basic search | npx @jetienne/perplexity_cli search -q "query" |
| Multi-query batch search | npx @jetienne/perplexity_cli search -q "query1" -q "query2" |
| Search with country filter | npx @jetienne/perplexity_cli search -q "query" --country US |
| Search with domain allowlist | npx @jetienne/perplexity_cli search -q "query" --domain wikipedia.org |
| Search with domain blocklist | npx @jetienne/perplexity_cli search -q "query" --domain -example.com |
| Search with language filter | npx @jetienne/perplexity_cli search -q "query" --language en |
| Deep research (markdown output) | npx @jetienne/perplexity_cli deep-search -q "query" -m |
| Deep research with preset | npx @jetienne/perplexity_cli deep-search -q "query" -p advanced-deep-research |
| Install skill | npx @jetienne/perplexity_cli install --skill |
Setup
No install needed — run it on demand with npx @jetienne/perplexity_cli. Just set the API key:
export PERPLEXITY_API_KEY=pplx-your-key-here
To hack on it from source instead:
git clone https://github.com/jeromeetienne/perplexity_cli
cd perplexity_cli
npm install
npm run build
Commands
search
Searches the web and returns a list of results (title, URL, snippet).
npx @jetienne/perplexity_cli search -q "TypeScript generics"
npx @jetienne/perplexity_cli search -q "TypeScript generics" -q "TypeScript decorators"
npx @jetienne/perplexity_cli search -q "weather forecast" --country FR
npx @jetienne/perplexity_cli search -q "machine learning" --domain arxiv.org
npx @jetienne/perplexity_cli search -q "machine learning" --domain -example.com
npx @jetienne/perplexity_cli search -q "intelligence artificielle" --language fr
npx @jetienne/perplexity_cli search -q "rust programming" --max-results 5
Options:
| Flag | Description | Default |
|---|
-q, --query <query> | Search query — repeatable up to 5 times | required |
--domain <domain> | Domain filter — repeatable, prefix - to block | — |
--country <code> | ISO 3166-1 alpha-2 country code (e.g. US, FR, JP) | — |
--language <code> | ISO 639-1 language code — repeatable up to 10 | — |
--max-results <n> | Number of results (1–20) | 10 |
deep-search
Runs a comprehensive research query using Perplexity AI presets. Returns a full text answer.
npx @jetienne/perplexity_cli deep-search -q "explain transformer neural networks"
npx @jetienne/perplexity_cli deep-search -q "explain transformer neural networks" -m
npx @jetienne/perplexity_cli deep-search -q "capital of France" -p fast-search
npx @jetienne/perplexity_cli deep-search -q "impact of quantum computing on cryptography" -p advanced-deep-research -m
Options:
| Flag | Description | Default |
|---|
-q, --query <query> | Search query | required |
-m, --markdown | Output as raw markdown (default: plain text) | false |
-p, --preset <preset> | Research preset (see below) | deep-research |
Presets:
| Preset | Model | Use case |
|---|
fast-search | sonar | Quick factual lookups |
pro-search | sonar-pro | Reliably researched standard queries |
deep-research | sonar-deep-research | In-depth analysis requiring extensive research |
advanced-deep-research | sonar-reasoning-pro | Maximum depth research with extensive sources |
install
Copies the perplexity skill folder into the current working directory.
npx @jetienne/perplexity_cli install --skill
Output
search: Writes results to stdout (title, URL, snippet per result).deep-search: Writes the full answer to stdout.- Errors are written to stderr and the process exits with code 1.
