← Back to Skills Marketplace
Perplexity Deep Search
by
Eric Santos
· GitHub ↗
· v1.1.0
3933
Downloads
12
Stars
18
Active Installs
2
Versions
Install in OpenClaw
/install 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 c...
Usage Guidance
This skill appears to be a straightforward Perplexity API client. Before installing: (1) only provide a Perplexity API key (PERPLEXITY_API_KEY) if you trust the operator — the key is used to authenticate requests to api.perplexity.ai; (2) be aware queries you submit will be sent to Perplexity (avoid sending sensitive secrets or PII); (3) the script looks for a key in ~/.config/perplexity/api_key if the env var is not set — ensure that file has appropriate permissions (chmod 600) if you store a key there; (4) the tool uses curl and jq, so confirm those binaries are trusted on your system; (5) note Perplexity API usage may incur cost per the SKILL.md pricing guidance. If you do not want the agent to call the skill autonomously, restrict autonomous invocation via your platform settings or avoid supplying the API key.
Capability Analysis
Type: OpenClaw Skill
Name: perplexity-deep-search
Version: 1.1.0
The OpenClaw skill bundle for Perplexity Deep Search is benign. It provides a legitimate wrapper for the Perplexity API, correctly handling API keys by prioritizing environment variables and falling back to a securely stored local file (`~/.config/perplexity/api_key`). The `scripts/search.sh` uses `jq` to safely construct JSON payloads for `curl` requests to the official `api.perplexity.ai` endpoint, mitigating injection risks. The `SKILL.md` documentation is clear and does not contain any prompt injection attempts or instructions for the OpenClaw agent to perform actions beyond the stated purpose. No evidence of data exfiltration, unauthorized execution, persistence, or obfuscation was found.
Capability Assessment
Purpose & Capability
Name/description (Perplexity Deep Search) match the actual behavior: the script builds a JSON payload and calls https://api.perplexity.ai/chat/completions. Declared binaries (curl, jq) and primary credential (PERPLEXITY_API_KEY) are appropriate and expected.
Instruction Scope
SKILL.md and scripts/search.sh are consistent: they document modes, options, and how to provide the API key. The script only reads the query, optional flags, the PERPLEXITY_API_KEY env var (or fallback file ~/.config/perplexity/api_key), and calls the Perplexity API; it does not read other system files or transmit data to unexpected endpoints.
Install Mechanism
There is no install spec and only a simple bash script is included. No external downloads, archives, or nonstandard install behavior are present.
Credentials
The skill requests a single service credential (PERPLEXITY_API_KEY) which is appropriate for an API client. The fallback file path under ~/.config/perplexity is reasonable; no unrelated secrets or config paths are requested.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system configs, and is instruction-only plus a script. It can be invoked autonomously per platform defaults, which is normal; nothing here grants elevated or persistent system privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install perplexity-deep-search - After installation, invoke the skill by name or use
/perplexity-deep-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
API key: add file-based fallback (~/.config/perplexity/api_key), align with SerpAPI pattern. Docs in English.
v1.0.0
Initial release: 3 modes (search, reason, research), recency/domain/lang filters, bash+curl+jq
Metadata
Frequently Asked Questions
What is Perplexity Deep Search?
Deep search via Perplexity API. Three modes: search (quick facts), reason (complex analysis), research (in-depth reports). Returns AI-grounded answers with c... It is an AI Agent Skill for Claude Code / OpenClaw, with 3933 downloads so far.
How do I install Perplexity Deep Search?
Run "/install perplexity-deep-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Perplexity Deep Search free?
Yes, Perplexity Deep Search is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Perplexity Deep Search support?
Perplexity Deep Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Perplexity Deep Search?
It is built and maintained by Eric Santos (@ericsantos); the current version is v1.1.0.
More Skills