perplexity-search

Q: How do I install perplexity-search?

Run npx skills add https://github.com/dotneet/claude-code-marketplace --skill perplexity-search in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/perplexity-search/ (personal) or .claude/skills/perplexity-search/ (project).

by dotneetProductivity & Automation

A skill for performing web searches, research, and reasoning using the Perplexity API. Handles real-time web information retrieval, deep research analysis, and advanced reasoning tasks. Use when the user asks for web searches, research, or says things like "look up", "search for", "latest information", "research", or "analyze".

Installs: 455
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/dotneet/claude-code-marketplace --skill perplexity-search

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads perplexity-search automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Perplexity Search Skill

A skill for executing real-time web searches and research using the Perplexity API.

Purpose

This skill provides the following capabilities:

perplexity_ask - Answer general questions (using sonar-pro model)
perplexity_research - Deep research and comprehensive reports (using sonar-deep-research model)
perplexity_reason - Advanced reasoning and analysis (using sonar-reasoning-pro model)
perplexity_search - Retrieve web search results

When to Use

Use this skill in the following situations:

User needs up-to-date information
Received a question requiring web search
Asked to perform deep research or investigation
Complex analysis or reasoning is required
Keywords like "look up", "search for", "latest..." are included

Prerequisites

PERPLEXITY_API_KEY environment variable must be set
Internet connection must be available

Usage

Basic Usage

Use the scripts/perplexity_api.py script to call the API.

# General questions (ask)
python3 scripts/perplexity_api.py ask "your question"

# Deep research (research)
python3 scripts/perplexity_api.py research "research topic"

# Advanced reasoning (reason)
python3 scripts/perplexity_api.py reason "reasoning task"

# Web search (search)
python3 scripts/perplexity_api.py search "search query" [--max-results 10] [--country JP]

Command Options

ask / research / reason

First argument: question, research topic, or reasoning task
--strip-thinking: Remove <think>...</think> tags to save context tokens (research/reason only)

search

First argument: search query
--max-results: Maximum number of results to return (1-20, default: 10)
--max-tokens-per-page: Maximum tokens per page (256-2048, default: 1024)
--country: ISO code for regional results (e.g., JP, US, GB)

Workflow

Standard Search Flow

Analyze the user's question and select the appropriate tool
- Simple questions → ask
- Deep research → research
- Complex analysis → reason
- Information gathering → search
Execute the script to call the API
Present results to the user, citing sources when available

Tool Selection Guidelines

Use Case	Tool	Description
Current weather, news	ask	When quick answers are needed
Technical topic research	research	When comprehensive analysis is needed
Complex problem analysis	reason	When logical reasoning is needed
Collecting sources	search	When URLs or snippets are needed

API Details

For detailed API specifications, see references/api_reference.md.

Troubleshooting

API Key Error: Verify the PERPLEXITY_API_KEY environment variable
Timeout: Increase PERPLEXITY_TIMEOUT_MS (default: 300000ms)
Proxy Issues: Set PERPLEXITY_PROXY or HTTPS_PROXY

FAQ

What does the perplexity-search skill do?

How do I install perplexity-search?

Run npx skills add https://github.com/dotneet/claude-code-marketplace --skill perplexity-search in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/perplexity-search/ (personal) or .claude/skills/perplexity-search/ (project).

Which AI agents can use perplexity-search?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is perplexity-search safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains perplexity-search?

It is published by dotneet in dotneet/claude-code-marketplace. It has 455 recorded installs.