Perplexity

Auto-generated skill for perplexity tools via OneKey Gateway.

Security Scan

This skill is internally consistent with its stated purpose (a OneKey Gateway wrapper for Perplexity tools), but there are small metadata inconsistencies and privacy considerations (a fallback demo API key and third‑party packages) you should review before installing.

Purpose & Capability

The name/description (Perplexity via OneKey Gateway) match the code and runtime instructions: the scripts call a OneKeyAgentRouter and invoke perplexity_* APIs. However, registry metadata at the top of the report claimed 'Required env vars: none' while the SKILL.md and the scripts require DEEPNLP_ONEKEY_ROUTER_ACCESS — an inconsistency you should be aware of.

Instruction Scope

SKILL.md instructs the agent to use the DEEPNLP_ONEKEY_ROUTER_ACCESS key and the included CLI/python scripts accept JSON payloads and forward them to OneKey Gateway. The runtime instructions and scripts do not attempt to read unrelated system files or extra environment variables. Important privacy note: payloads (messages, queries) are sent to a remote service; the scripts default to a shared demo key (BETA_TEST_KEY_MARCH_2026) if you don't set your own key, which may expose your inputs to a shared/demo account.

Install Mechanism

Installation is via public package managers (npm -g install @aiagenta2z/onekey-gateway and pip install ai-agent-marketplace) as declared in SKILL.md. There is no custom download-from-URL or archive extraction. Installing packages from npm/PyPI runs third-party code — normal but requires trusting those packages. Also note: the registry metadata earlier said 'No install spec' while SKILL.md contains install commands—another small inconsistency.

Credentials

The single required credential (DEEPNLP_ONEKEY_ROUTER_ACCESS) is proportional to the skill's purpose (a gateway API key). The concern is the fallback demo key hardcoded in scripts: if users do not set their own key, their inputs will be routed through a shared/demo account. That is a privacy/exfiltration risk for sensitive data, not an indicator of unrelated credential access.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system-wide settings, and is user-invocable with normal autonomous invocation allowed. No elevated persistence privileges are requested.

Assessment

This skill appears to do what it claims (wrap Perplexity tools via OneKey Gateway), but take these precautions before installing: - Provide your own DEEPNLP_ONEKEY_ROUTER_ACCESS key (do not rely on the demo fallback key), because any data you send will be forwarded to the remote gateway and could be exposed if the demo key is used. - Review and vet the two third-party packages (ai-agent-marketplace on PyPI and @aiagenta2z/onekey-gateway on npm). Installing packages executes their code on your system. - Note the small inconsistencies in metadata (the registry listed no required env/install but SKILL.md does). Confirm the expected environment variables and install steps with the skill author or documentation. - Avoid sending highly sensitive secrets or personal data through the skill unless you trust the OneKey Gateway provider and have an account/key configured. If you want higher assurance, request the publisher/source identity and independently inspect the referenced packages (and the OneKey Gateway docs) before enabling this skill.

OneKey Gateway

Use One Access Key to connect to various commercial APIs. Please visit the OneKey Gateway Keys and read the docs OneKey MCP Router Doc and OneKey Gateway Doc.

perplexity Skill

Use the OneKey Gateway to access tools for this server via a unified access key.

Quick Start

Set your OneKey access key:

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_API_KEY

If no key is provided, the scripts fall back to the demo key BETA_TEST_KEY_MARCH_2026. Common settings:

• unique_id: perplexity/perplexity
• api_id: one of the tools listed below

Tools

perplexity_ask

Answer a question using web-grounded AI (Sonar Pro model). Best for: quick factual questions, summaries, explanations, and general Q&A. Returns a text response with numbered citations. Fastest and cheapest option. Supports filtering by recency (hour/day/week/month/year), domain restrictions, and search context size. For in-depth multi-source research, use perplexity_research instead. For step-by-step reasoning and analysis, use perplexity_reason instead.

Parameters:

• messages (array of object, required): Array of conversation messages
• messages[].role (string, required): Role of the message sender Values: system, user, assistant
• messages[].content (string, required): The content of the message
• search_recency_filter (string, optional): Filter search results by recency. Use 'hour' for very recent news, 'day' for today's updates, 'week' for this week, etc. Values: hour, day, week, month, year
• search_domain_filter (array of string, optional): Restrict search results to specific domains (e.g., ['wikipedia.org', 'arxiv.org']). Use '-' prefix for exclusion (e.g., ['-reddit.com']).
• search_context_size (string, optional): Controls how much web context is retrieved. 'low' (default) is fastest, 'high' provides more comprehensive results. Values: low, medium, high

perplexity_research

Conduct deep, multi-source research on a topic (Sonar Deep Research model). Best for: literature reviews, comprehensive overviews, investigative queries needing many sources. Returns a detailed response with numbered citations. Significantly slower than other tools (30+ seconds). For quick factual questions, use perplexity_ask instead. For logical analysis and reasoning, use perplexity_reason instead.

Parameters:

• messages (array of object, required): Array of conversation messages
• messages[].role (string, required): Role of the message sender Values: system, user, assistant
• messages[].content (string, required): The content of the message
• strip_thinking (boolean, optional): If true, removes <think>...</think> tags and their content from the response to save context tokens. Default is false.
• reasoning_effort (string, optional): Controls depth of deep research reasoning. Higher values produce more thorough analysis. Values: minimal, low, medium, high

perplexity_reason

Analyze a question using step-by-step reasoning with web grounding (Sonar Reasoning Pro model). Best for: math, logic, comparisons, complex arguments, and tasks requiring chain-of-thought. Returns a reasoned response with numbered citations. Supports filtering by recency (hour/day/week/month/year), domain restrictions, and search context size. For quick factual questions, use perplexity_ask instead. For comprehensive multi-source research, use perplexity_research instead.

Parameters:

• messages (array of object, required): Array of conversation messages
• messages[].role (string, required): Role of the message sender Values: system, user, assistant
• messages[].content (string, required): The content of the message
• strip_thinking (boolean, optional): If true, removes <think>...</think> tags and their content from the response to save context tokens. Default is false.
• search_recency_filter (string, optional): Filter search results by recency. Use 'hour' for very recent news, 'day' for today's updates, 'week' for this week, etc. Values: hour, day, week, month, year
• search_domain_filter (array of string, optional): Restrict search results to specific domains (e.g., ['wikipedia.org', 'arxiv.org']). Use '-' prefix for exclusion (e.g., ['-reddit.com']).
• search_context_size (string, optional): Controls how much web context is retrieved. 'low' (default) is fastest, 'high' provides more comprehensive results. Values: low, medium, high

perplexity_search

Search the web and return a ranked list of results with titles, URLs, snippets, and dates. Best for: finding specific URLs, checking recent news, verifying facts, discovering sources. Returns formatted results (title, URL, snippet, date) — no AI synthesis. For AI-generated answers with citations, use perplexity_ask instead.

Parameters:

• query (string, required): Search query string
• max_results (number, optional): Maximum number of results to return (1-20, default: 10)
• max_tokens_per_page (number, optional): Maximum tokens to extract per webpage (default: 1024)
• country (string, optional): ISO 3166-1 alpha-2 country code for regional results (e.g., 'US', 'GB')

Usage

CLI

perplexity_ask

npx onekey agent perplexity/perplexity perplexity_ask '{"question": "Who won the 2024 World Series?"}'

perplexity_research

npx onekey agent perplexity/perplexity perplexity_research '{"query": "renewable energy policies US"}'

perplexity_reason

npx onekey agent perplexity/perplexity perplexity_reason '{"topic": "impact of quantum computing"}'

perplexity_search

npx onekey agent perplexity/perplexity perplexity_search '{"query": "best VR headsets 2026"}'

Scripts

Each tool has a dedicated script in this folder:

• skills/perplexity/scripts/perplexity_ask.py
• skills/perplexity/scripts/perplexity_research.py
• skills/perplexity/scripts/perplexity_reason.py
• skills/perplexity/scripts/perplexity_search.py

Example

python3 scripts/<tool_name>.py --data '{"key": "value"}'

Related DeepNLP OneKey Gateway Documents

AI Agent Marketplace
Skills Marketplace AI Agent A2Z Deployment
PH AI Agent A2Z Infra
GitHub AI Agent Marketplace

Dependencies

CLI Dependency

Install onekey-gateway from npm

npm install @aiagenta2z/onekey-gateway

Script Dependency

Install the required Python package before running any scripts.

pip install ai-agent-marketplace

Alternatively, install dependencies from the requirements file:

pip install -r requirements.txt

If the package is already installed, skip installation.

Agent rule

Before executing command lines or running any script in the scripts/ directory, ensure the dependencies are installed. Use the onekey CLI as the preferred method to run the skills.