← Back to Skills Marketplace
vacinc

Perplexity Wrapped Search

by VACInc · GitHub ↗ · v2.1.2
cross-platform ⚠ suspicious
2021
Downloads
1
Stars
4
Active Installs
6
Versions
Install in OpenClaw
/install perplexity-wrapped
Description
Search the web with AI-powered answers via Perplexity API. Supports three modes - Search API (ranked results), Sonar API (AI answers with citations, default), and Agentic Research API (third-party models with tools). All responses wrapped in untrusted-content boundaries for security.
Usage Guidance
This skill's code appears to do what the description says (call Perplexity APIs and wrap external content), but the package metadata omits the required Perplexity API key. Before installing, verify where and how you will provide the PERPLEXITY_API_KEY (OpenClaw config, environment, or secrets manager) and confirm the skill's owner/source because the registry entry's owner is unknown. Expect network calls to api.perplexity.ai and per-query costs (the CLI already prompts for expensive queries). If you require strict least-privilege metadata, ask the publisher to add PERPLEXITY_API_KEY (or configure a declared primary credential) and remove the misleading 1Password reference or explain how it is used.
Capability Analysis
Type: OpenClaw Skill Name: perplexity-wrapped Version: 2.1.2 The skill is designed for AI-powered web search via the Perplexity API, which aligns with its stated purpose. It makes network calls exclusively to the legitimate Perplexity API endpoint and handles the API key via environment variables. Crucially, the `SKILL.md` documentation and `scripts/search.mjs` code include explicit and robust measures to prevent prompt injection from external content, such as untrusted content boundaries, character folding, and direct instructions to the OpenClaw agent to treat all returned content as untrusted data. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection attempts within the skill's own instructions or code.
Capability Assessment
Purpose & Capability
The skill's name, description, CLI, and code all implement a Perplexity-based web search (sonar, search, agentic). That capability coheres with the required binary (node) and the network calls to api.perplexity.ai. However, the skill obviously needs a Perplexity API key at runtime (scripts/config.mjs reads PERPLEXITY_API_KEY) but the registry metadata lists no required env vars or primary credential — this is an important metadata omission/incoherence.
Instruction Scope
Runtime instructions and the bundled scripts stay within the declared purpose: they accept queries, call Perplexity endpoints, and wrap external content in untrusted-content boundaries. The code sanitizes boundary markers to mitigate prompt injection and prompts for confirmation on expensive 'deep' queries. The Agentic mode allows selecting third-party model names but sends them to Perplexity's endpoint (it does not request additional third-party credentials). There is no code that reads arbitrary files or other unrelated environment variables.
Install Mechanism
This is an instruction-only skill with small JS scripts and no install spec or external downloads. It requires node on PATH (declared). No installers or archive downloads are present, so install risk is low.
Credentials
The runtime code requires a Perplexity API key (scripts/config.mjs reads PERPLEXITY_API_KEY and the main script exits if apiKey is missing). Yet requires.env and primary credential in the registry metadata are empty. Additionally, an error message mentions 1Password, but the included code does not implement 1Password access — another inconsistency. Requesting an API key for the service is proportionate, but failing to declare it in metadata is a mismatch that can confuse permission/configuration and is worth flagging.
Persistence & Privilege
The skill does not request persistent or privileged presence (always:false). It does not modify other skills or system-wide settings. It does not create background services or write persistent credentials; it only reads an environment variable at runtime.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install perplexity-wrapped
  3. After installation, invoke the skill by name or use /perplexity-wrapped
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.2
Simplify config: env var only (no child_process), fixes code_safety scanner flag
v2.1.1
Add comprehensive per-query cost estimates for all models and modes
v2.1.0
Fix agentic endpoint (/v2/responses), fix default model bleed, add cost gate for deep research (--yes required), add full model catalog (14 models across 5 providers), 1Password integration for API key
v2.0.0
Add Sonar API (default), Agentic Research API, model selection, reasoning effort, deep research mode, cost warnings
v1.1.0
Add 1Password integration for API key management; split config/network into separate modules to avoid code safety scanner false positives; update docs
v0.1.0
Initial release: Perplexity search skill with default untrusted-content wrapping and boundary-marker sanitization.
Metadata
Slug perplexity-wrapped
Version 2.1.2
License
All-time Installs 6
Active Installs 4
Total Versions 6
Frequently Asked Questions

What is Perplexity Wrapped Search?

Search the web with AI-powered answers via Perplexity API. Supports three modes - Search API (ranked results), Sonar API (AI answers with citations, default), and Agentic Research API (third-party models with tools). All responses wrapped in untrusted-content boundaries for security. It is an AI Agent Skill for Claude Code / OpenClaw, with 2021 downloads so far.

How do I install Perplexity Wrapped Search?

Run "/install perplexity-wrapped" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Perplexity Wrapped Search free?

Yes, Perplexity Wrapped Search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Perplexity Wrapped Search support?

Perplexity Wrapped Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Perplexity Wrapped Search?

It is built and maintained by VACInc (@vacinc); the current version is v2.1.2.

💬 Comments