← Back to Skills Marketplace
m4vf14

Perplexity Search Skill

by M4vF14 · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
2695
Downloads
2
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install perplexity-search-skill
Description
Search the web using Perplexity's Search API for ranked, real-time web results with advanced filtering. Use when you need to search for current information, market research, trending topics, or when Brave Search is unavailable. Supports recency filtering (day/week/month/year) and returns structured results with titles, URLs, and snippets.
Usage Guidance
This skill appears to be a straightforward Perplexity Search API wrapper and requests only a single API key. Before installing, verify the skill's source (the metadata had inconsistent homepage info — skill.json points to a GitHub repo), review the included scripts yourself, and confirm the API endpoint (https://api.perplexity.ai/search) matches Perplexity's official docs. Store your PERPLEXITY_API_KEY in your OpenClaw config (or otherwise secure it), monitor API usage/billing after first use, and rotate the key if anything looks suspicious. If you need stronger guarantees, run the script locally first and inspect network calls or host it in a sandboxed environment before enabling agent-autonomous invocation.
Capability Analysis
Type: OpenClaw Skill Name: perplexity-search-skill Version: 1.0.0 The skill is designed for web searching via the Perplexity API, demonstrating strong security practices. It securely handles the API key by loading it from environment variables, performs input validation on parameters, and sanitizes all output to prevent terminal injection. The Python script uses only standard libraries, eliminating supply chain risks, and includes robust error handling with network timeouts. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the OpenClaw agent in any of the analyzed files (SKILL.md, scripts/search.py, README.md, SECURITY_AUDIT.md).
Capability Assessment
Purpose & Capability
Name/description, required env var (PERPLEXITY_API_KEY), and included Python script all align with a Perplexity Search API wrapper. Minor provenance inconsistency: registry metadata at the top states 'Source: unknown / Homepage: none' while skill.json and README reference a GitHub homepage; this is a documentation/packaging mismatch but not a functional threat.
Instruction Scope
SKILL.md instructs running the bundled Python script and setting PERPLEXITY_API_KEY via OpenClaw config or environment. The runtime instructions and script only access the declared env var and make HTTPS requests to api.perplexity.ai; they do not read other system files or exfiltrate unrelated data.
Install Mechanism
No install spec (instruction-only distribution) and no external downloads; code is bundled in the skill. The script uses only the Python standard library—no external packages or remote installers are invoked.
Credentials
Only PERPLEXITY_API_KEY is required and declared as the primary credential; that is proportional and expected for an API wrapper. The SKILL.md and script only reference that environment variable.
Persistence & Privilege
Skill is not marked always:true and does not request elevated or persistent system privileges. It does not modify other skills' configs; typical agent-invocation settings apply (autonomous invocation is allowed by default).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install perplexity-search-skill
  3. After installation, invoke the skill by name or use /perplexity-search-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Clean OpenClaw search skill using Perplexity Search API. Features web search with recency filtering, zero dependencies, and security hardening.
Metadata
Slug perplexity-search-skill
Version 1.0.0
License
All-time Installs 6
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is Perplexity Search Skill?

Search the web using Perplexity's Search API for ranked, real-time web results with advanced filtering. Use when you need to search for current information, market research, trending topics, or when Brave Search is unavailable. Supports recency filtering (day/week/month/year) and returns structured results with titles, URLs, and snippets. It is an AI Agent Skill for Claude Code / OpenClaw, with 2695 downloads so far.

How do I install Perplexity Search Skill?

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

Is Perplexity Search Skill free?

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

Which platforms does Perplexity Search Skill support?

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

Who created Perplexity Search Skill?

It is built and maintained by M4vF14 (@m4vf14); the current version is v1.0.0.

💬 Comments