← Back to Skills Marketplace
Perplexica Search
by
Edward Tsang
· GitHub ↗
· v1.0.3
· MIT-0
334
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install perplexica-search-local
Description
AI-powered search using your local Perplexica instance. Runs deep research (quality mode) with web search and LLM reasoning; returns answers with cited sourc...
Usage Guidance
This skill appears coherent and local-only: it only needs python3 and a local Perplexica server. Before installing: (1) verify you are comfortable allowing the skill to contact host.docker.internal if you run it in Docker (that resolves to your host machine and can access host services), (2) review the remainder of the script (main entry/flow) to confirm URL validation is performed before any network call in your environment, and (3) run it in a restricted environment or sandbox if you want to be extra cautious. If you do not run Perplexica locally, the skill will fail rather than exfiltrate data.
Capability Analysis
Type: OpenClaw Skill
Name: perplexica-search-local
Version: 1.0.3
The Perplexica Search skill is a well-implemented tool for local AI-powered research. The code in scripts/perplexica_search.py includes proactive security measures to prevent data exfiltration and SSRF, such as custom urllib handlers that explicitly reject HTTP redirects and a validation function that ensures resolved hostnames point only to loopback or private IP addresses (RFC 1918). No malicious intent, obfuscation, or unauthorized data access was found.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, README, and the included Python script all match: the skill queries a local Perplexica instance, returns results with citations, and requires only python3. No unrelated binaries, env vars, or credentials are requested.
Instruction Scope
SKILL.md restricts the skill to local hosts and instructs running the bundled Python script by full path. The script enforces a hostname whitelist (localhost, 127.0.0.1, ::1, host.docker.internal), rejects redirects, reads an optional config.json from the skill directory, and performs model/provider and search API calls. This scope is appropriate; as a small note, the script’s host-resolution helper is designed to validate allowed hostnames (and checks that host.docker.internal resolves to a loopback/private IP), so confirm the skill's main path validates the base URL before any network calls (truncated code not shown here appears to do so from the rest of the file).
Install Mechanism
No install spec; the skill is instruction-only with one Python script. This is the lowest-risk install approach and is proportional to the stated functionality.
Credentials
The skill requests no environment variables, no credentials, and no config paths outside its own directory. That is proportional for a local-only search helper. The only configuration file is an optional config.json in the skill directory (used to set a local perplexica_url).
Persistence & Privilege
The skill is not forced always-on and is user-invocable. It does not request system-level persistence or modify other skills. Autonomous invocation is allowed by platform default and is not a concern here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install perplexica-search-local - After installation, invoke the skill by name or use
/perplexica-search-local - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Removed the file CHANGELOG.md.
- No changes to functionality or usage.
v1.0.2
- Added support for host.docker.internal as a valid local URL, improving compatibility with Docker environments.
- Improved security: URLs are strictly limited to localhost, 127.0.0.1, ::1, or host.docker.internal, and HTTP redirects are no longer followed to prevent exfiltration.
- Updated documentation to reflect new valid URL options and clarify local-only policy.
- Changed repository homepage URL.
v1.0.1
perplexica-search-local 1.0.1
- Added missing project files: `CHANGELOG.md`, `LICENSE`, and `config.json.example`.
- Provides a sample config and license for easier setup and compliance.
- No changes to code or behavior.
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Perplexica Search?
AI-powered search using your local Perplexica instance. Runs deep research (quality mode) with web search and LLM reasoning; returns answers with cited sourc... It is an AI Agent Skill for Claude Code / OpenClaw, with 334 downloads so far.
How do I install Perplexica Search?
Run "/install perplexica-search-local" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Perplexica Search free?
Yes, Perplexica Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Perplexica Search support?
Perplexica Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Perplexica Search?
It is built and maintained by Edward Tsang (@eplt); the current version is v1.0.3.
More Skills